Workspaces - List Workspace Role Assignments

Usługa:: Core

Wersja interfejsu API:: v1

Zwraca listę przypisań ról obszaru roboczego.
Ten interfejs API obsługuje stronicowanie.

Uprawnienia

Obiekt wywołujący musi mieć rolę członka lub wyższego obszaru roboczego.

Wymagane zakresy delegowane

Workspace.Read.All lub Workspace.ReadWrite.All

Tożsamości obsługiwane przez Microsoft Entra

To API obsługuje tożsamości Microsoft wymienione w tej sekcji.

Tożsamość	Wsparcie
Użytkownik	Tak
Główne usługi i Tożsamości zarządzane	Tak

Interfejs

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/roleAssignments

Z parametrami opcjonalnymi:

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/roleAssignments?continuationToken={continuationToken}

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
workspaceId	path	True	string (uuid)	Identyfikator przestrzeni roboczej.
continuationToken	query		string	Token do pobierania następnej strony wyników.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	WorkspaceRoleAssignments	Żądanie zostało ukończone pomyślnie.
Other Status Codes	ErrorResponse	Typowe kody błędów: UnknownError — wystąpił błąd.

Nazwa

Typ

Opis

200 OK

WorkspaceRoleAssignments

Żądanie zostało ukończone pomyślnie.

Other Status Codes

ErrorResponse

Typowe kody błędów:

UnknownError — wystąpił błąd.

Przykłady

Get workspace role assignments example

Get workspace role assignments with continuation example

Get workspace role assignments example

Przykładowe żądanie

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/e4ae4765-02a0-4cd8-bbef-65be17dd5a22/roleAssignments

Przykładowa odpowiedź

Kod stanu:: 200

{
  "value": [
    {
      "id": "81fac5e1-2a81-421b-a168-110b1c72fa11",
      "principal": {
        "displayName": "Eric Solomon",
        "id": "81fac5e1-2a81-421b-a168-110b1c72fa11",
        "type": "User",
        "userDetails": {
          "userPrincipalName": "eric@microsoft.com"
        }
      },
      "role": "Admin"
    },
    {
      "id": "dbc4f130-681f-46b9-b19a-ca19ea5daa31",
      "principal": {
        "displayName": "ServicePrincipal",
        "id": "dbc4f130-681f-46b9-b19a-ca19ea5daa31",
        "type": "ServicePrincipal",
        "servicePrincipalDetails": {
          "aadAppId": "7ac9c70b-69f1-48c5-bf5b-69ac50578a55"
        }
      },
      "role": "Member"
    }
  ]
}

Get workspace role assignments with continuation example

Przykładowe żądanie

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/e4ae4765-02a0-4cd8-bbef-65be17dd5a22/roleAssignments

Przykładowa odpowiedź

Kod stanu:: 200

{
  "value": [
    {
      "id": "81fac5e1-2a81-421b-a168-110b1c72fa11",
      "principal": {
        "displayName": "Eric Solomon",
        "id": "81fac5e1-2a81-421b-a168-110b1c72fa11",
        "type": "User",
        "userDetails": {
          "userPrincipalName": "eric@microsoft.com"
        }
      },
      "role": "Admin"
    },
    {
      "id": "dbc4f130-681f-46b9-b19a-ca19ea5daa31",
      "principal": {
        "displayName": "ServicePrincipal",
        "id": "dbc4f130-681f-46b9-b19a-ca19ea5daa31",
        "type": "ServicePrincipal",
        "servicePrincipalDetails": {
          "aadAppId": "7ac9c70b-69f1-48c5-bf5b-69ac50578a55"
        }
      },
      "role": "Member"
    }
  ],
  "continuationToken": "LDEsMTAwMDAwLDA%3D",
  "continuationUri": "https://api.fabric.microsoft.com/v1/workspaces/e4ae4765-02a0-4cd8-bbef-65be17dd5a22/roleAssignments?continuationToken=LDEsMTAwMDAwLDA%3D"
}

Definicje

Nazwa	Opis
ErrorRelatedResource	Obiekt szczegółów zasobu powiązanego z błędem.
ErrorResponse	Odpowiedź na błąd.
ErrorResponseDetails	Szczegóły odpowiedzi na błąd.
GroupDetails	Grupuj szczegółowe informacje. Dotyczy, gdy typ podmiotu zabezpieczeń ma wartość `Group`.
GroupType	Typ grupy. Dodatkowe typy grup mogą być dodawane w czasie.
Principal	Reprezentuje tożsamość lub grupę firmy Microsoft Entra.
PrincipalType	Typ podmiotu zabezpieczeń. Dodatkowe typy podmiotów zabezpieczeń mogą być dodawane w czasie.
ServicePrincipalDetails	Szczegóły dotyczące jednostki usługi. Dotyczy, gdy typ podmiotu zabezpieczeń ma wartość `ServicePrincipal`.
ServicePrincipalProfileDetails	Szczegóły profilu jednostki usługi. Dotyczy, gdy typ podmiotu zabezpieczeń ma wartość `ServicePrincipalProfile`.
UserDetails	Szczegóły dotyczące podmiotu zabezpieczeń użytkownika. Dotyczy, gdy typ podmiotu zabezpieczeń ma wartość `User`.
WorkspaceRole	Rola obszaru roboczego. Dodatkowe role obszaru roboczego można dodawać w czasie.
WorkspaceRoleAssignment	Obiekt przypisania roli obszaru roboczego.
WorkspaceRoleAssignments

ErrorRelatedResource

Objekt

Obiekt szczegółów zasobu powiązanego z błędem.

Nazwa	Typ	Opis
resourceId	string	Identyfikator zasobu, który jest zaangażowany w błąd.
resourceType	string	Typ zasobu, który jest zaangażowany w błąd.

ErrorResponse

Objekt

Odpowiedź na błąd.

Nazwa	Typ	Opis
errorCode	string	Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
message	string	Czytelna reprezentacja błędu przez człowieka.
moreDetails	ErrorResponseDetails[]	Lista dodatkowych szczegółów błędu.
relatedResource	ErrorRelatedResource	Szczegóły zasobu powiązanego z błędem.
requestId	string	Identyfikator żądania skojarzonego z błędem.

ErrorResponseDetails

Objekt

Szczegóły odpowiedzi na błąd.

Nazwa	Typ	Opis
errorCode	string	Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
message	string	Czytelna reprezentacja błędu przez człowieka.
relatedResource	ErrorRelatedResource	Szczegóły zasobu powiązanego z błędem.

GroupDetails

Objekt

Grupuj szczegółowe informacje. Dotyczy, gdy typ podmiotu zabezpieczeń ma wartość Group.

Nazwa	Typ	Opis
groupType	GroupType	Typ grupy. Dodatkowe typy grup mogą być dodawane w czasie.

GroupType

Wyliczanie

Typ grupy. Dodatkowe typy grup mogą być dodawane w czasie.

Wartość	Opis
Unknown	Typ grupy podmiotu zabezpieczeń jest nieznany.
SecurityGroup	Podmiot zabezpieczeń jest grupą zabezpieczeń.
DistributionList	Podmiot zabezpieczeń jest listą dystrybucyjną.

Principal

Objekt

Reprezentuje tożsamość lub grupę firmy Microsoft Entra.

Nazwa	Typ	Opis
displayName	string	Nazwa wyświetlana podmiotu zabezpieczeń.
groupDetails	GroupDetails	Grupuj szczegółowe informacje. Dotyczy, gdy typ podmiotu zabezpieczeń ma wartość `Group`.
id	string (uuid)	Identyfikator podmiotu zabezpieczeń.
servicePrincipalDetails	ServicePrincipalDetails	Szczegóły dotyczące jednostki usługi. Dotyczy, gdy typ podmiotu zabezpieczeń ma wartość `ServicePrincipal`.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	Szczegóły profilu jednostki usługi. Dotyczy, gdy typ podmiotu zabezpieczeń ma wartość `ServicePrincipalProfile`.
type	PrincipalType	Typ podmiotu zabezpieczeń. Dodatkowe typy podmiotów zabezpieczeń mogą być dodawane w czasie.
userDetails	UserDetails	Szczegóły dotyczące podmiotu zabezpieczeń użytkownika. Dotyczy, gdy typ podmiotu zabezpieczeń ma wartość `User`.

PrincipalType

Wyliczanie

Typ podmiotu zabezpieczeń. Dodatkowe typy podmiotów zabezpieczeń mogą być dodawane w czasie.

Wartość	Opis
User	Podmiot zabezpieczeń jest podmiotem zabezpieczeń użytkownika firmy Microsoft Entra.
ServicePrincipal	Jednostka jest jednostką usługi Microsoft Entra.
Group	Podmiot zabezpieczeń jest grupą zabezpieczeń.
ServicePrincipalProfile	Jednostka jest profilem jednostki usługi.
EntireTenant	Podmiot zabezpieczeń reprezentuje wszystkich użytkowników dzierżawy.

ServicePrincipalDetails

Objekt

Szczegóły dotyczące jednostki usługi. Dotyczy, gdy typ podmiotu zabezpieczeń ma wartość ServicePrincipal.

Nazwa	Typ	Opis
aadAppId	string (uuid)	Jednostka usługi Firmy Microsoft Entra AppId.

ServicePrincipalProfileDetails

Objekt

Szczegóły profilu jednostki usługi. Dotyczy, gdy typ podmiotu zabezpieczeń ma wartość ServicePrincipalProfile.

Nazwa	Typ	Opis
parentPrincipal	Principal	Jednostka nadrzędna profilu jednostki usługi.

UserDetails

Objekt

Szczegóły dotyczące podmiotu zabezpieczeń użytkownika. Dotyczy, gdy typ podmiotu zabezpieczeń ma wartość User.

Nazwa	Typ	Opis
userPrincipalName	string	Główna nazwa użytkownika.

WorkspaceRole

Wyliczanie

Rola obszaru roboczego. Dodatkowe role obszaru roboczego można dodawać w czasie.

Wartość	Opis
Admin	Umożliwia dostęp administracyjny do obszaru roboczego.
Member	Umożliwia dostęp do członkostwa w obszarze roboczym.
Contributor	Umożliwia współtworzenie obszaru roboczego.
Viewer	Umożliwia wyświetlanie obszaru roboczego.

WorkspaceRoleAssignment

Objekt

Obiekt przypisania roli obszaru roboczego.

Nazwa	Typ	Opis
id	string (uuid)	Identyfikator przypisania roli obszaru roboczego.
principal	Principal	Podmiot zabezpieczeń.
role	WorkspaceRole	Rola obszaru roboczego podmiotu zabezpieczeń.

WorkspaceRoleAssignments

Objekt

Nazwa	Typ	Opis
continuationToken	string	Token dla następnej partii zestawu wyników. Jeśli nie ma więcej rekordów, zostanie on usunięty z odpowiedzi.
continuationUri	string	Identyfikator URI następnego zestawu wyników wsadowy. Jeśli nie ma więcej rekordów, zostanie on usunięty z odpowiedzi.
value	WorkspaceRoleAssignment[]	Lista przypisań ról obszaru roboczego.

Udostępnij przez

Workspaces - List Workspace Role Assignments

Uprawnienia

Wymagane zakresy delegowane

Tożsamości obsługiwane przez Microsoft Entra

Interfejs

Parametry identyfikatora URI

Odpowiedzi

Przykłady

Get workspace role assignments example

Przykładowe żądanie

Przykładowa odpowiedź

Get workspace role assignments with continuation example

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

GroupDetails

GroupType

Principal

PrincipalType

ServicePrincipalDetails

ServicePrincipalProfileDetails

UserDetails

WorkspaceRole

WorkspaceRoleAssignment

WorkspaceRoleAssignments