Workspaces - Get Workspace Role Assignment

Usługa:
Core
Wersja interfejsu API:
v1

Zwraca informacje o przypisaniu roli obszaru roboczego.

Uprawnienia

Obiekt wywołujący musi mieć rolę członka lub wyższą w obszarze roboczym.

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/{workspaceRoleAssignmentId}

Parametry identyfikatora URI

Nazwisko W Wymagane Typ Opis
workspaceId
 path True

string (uuid)

Identyfikator przestrzeni roboczej.
workspaceRoleAssignmentId
 path True

string (uuid)

Identyfikator przypisania roli obszaru roboczego.

Odpowiedzi

Nazwisko Typ Opis
200 OK

WorkspaceRoleAssignment

Żądanie zostało ukończone pomyślnie.
429 Too Many Requests

ErrorResponse

Przekroczono limit szybkości usługi. Serwer zwraca nagłówek wskazujący Retry-After w sekundach, jak długo klient musi czekać przed wysłaniem dodatkowych żądań.

Nagłówki

Retry-After: integer
Other Status Codes

ErrorResponse

Typowe kody błędów:

  • UnknownError — wystąpił błąd.

Przykłady

Get workspace role assignment example

Przykładowe żądanie

GET https://api.fabric.microsoft.com/v1/workspaces/0ac682f5-aee3-4968-9d21-692eb3fd4056/roleAssignments/259b6674-74cf-4197-ac05-1bf391800ec2

Przykładowa odpowiedź

Kod stanu:
200 
{
  "id": "259b6674-74cf-4197-ac05-1bf391800ec2",
  "principal": {
    "id": "259b6674-74cf-4197-ac05-1bf391800ec2",
    "type": "User"
  },
  "role": "Member"
}

Definicje

Nazwisko Opis
EntireTenantPrincipal

Reprezentuje podmiot zabezpieczeń dzierżawy
ErrorParameter

Parametr ustrukturyzowany zapewniający dodatkowy kontekst czytelny dla maszyny o błędzie.
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.
GroupPrincipal

Reprezentuje grupę zabezpieczeń.
GroupType

Typ grupy. Dodatkowe typy grup mogą być dodawane w czasie.
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.
ServicePrincipalPrincipal

Reprezentuje jednostkę usługi Firmy Microsoft Entra.
ServicePrincipalProfileDetails

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

Reprezentuje profil jednostki usługi.
UserDetails

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

Reprezentuje podmiot zabezpieczeń użytkownika firmy Microsoft Entra.
WorkspaceRole

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

Obiekt przypisania roli obszaru roboczego.

EntireTenantPrincipal

Objekt

Reprezentuje podmiot zabezpieczeń dzierżawy

Nazwisko Typ Opis
displayName

string

Nazwa wyświetlana podmiotu zabezpieczeń.
id

string (uuid)

Identyfikator podmiotu zabezpieczeń.
type string:

EntireTenant

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

ErrorParameter

Objekt

Parametr ustrukturyzowany zapewniający dodatkowy kontekst czytelny dla maszyny o błędzie.

Nazwisko Typ Opis
message

string

Czytelny dla człowieka opis znaczenia parametru.
name

string

Identyfikator parametru.
value

string

Wartość parametru.

ErrorRelatedResource

Objekt

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

Nazwisko 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.

Nazwisko 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.
isRetriable

boolean

Jeśli to prawda, żądanie można ponowić. Użyj nagłówka Retry-After odpowiedzi, aby określić opóźnienie, jeśli jest dostępne.
message

string

Czytelna reprezentacja błędu przez człowieka.
moreDetails

ErrorResponseDetails[]

Lista dodatkowych szczegółów błędu.
parameters

ErrorParameter[]

Parametry ustrukturyzowane zapewniające dodatkowy kontekst czytelny dla maszyny o błędzie.
relatedResource

ErrorRelatedResource

Szczegóły zasobu powiązanego z błędem.
requestId

string (uuid)

Identyfikator żądania skojarzonego z błędem.

ErrorResponseDetails

Objekt

Szczegóły odpowiedzi na błąd.

Nazwisko 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.
parameters

ErrorParameter[]

Parametry ustrukturyzowane zapewniające dodatkowy kontekst czytelny dla maszyny o błędzie.
relatedResource

ErrorRelatedResource

Szczegóły zasobu powiązanego z błędem.

GroupDetails

Objekt

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

Nazwisko Typ Opis
groupType

GroupType

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

GroupPrincipal

Objekt

Reprezentuje grupę zabezpieczeń.

Nazwisko 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ń.
type string:

Group

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

GroupType

Wyliczenie

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ą.

PrincipalType

Wyliczenie

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.

Nazwisko Typ Opis
aadAppId

string (uuid)

Jednostka usługi Firmy Microsoft Entra AppId.

ServicePrincipalPrincipal

Objekt

Reprezentuje jednostkę usługi Firmy Microsoft Entra.

Nazwisko Typ Opis
displayName

string

Nazwa wyświetlana podmiotu zabezpieczeń.
id

string (uuid)

Identyfikator podmiotu zabezpieczeń.
servicePrincipalDetails

ServicePrincipalDetails

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

ServicePrincipal

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

ServicePrincipalProfileDetails

Objekt

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

Nazwisko Typ Opis
parentPrincipal Principal:

Jednostka nadrzędna profilu jednostki usługi.

ServicePrincipalProfilePrincipal

Objekt

Reprezentuje profil jednostki usługi.

Nazwisko Typ Opis
displayName

string

Nazwa wyświetlana podmiotu zabezpieczeń.
id

string (uuid)

Identyfikator podmiotu zabezpieczeń.
servicePrincipalProfileDetails

ServicePrincipalProfileDetails

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

ServicePrincipalProfile

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

UserDetails

Objekt

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

Nazwisko Typ Opis
userPrincipalName

string

Główna nazwa użytkownika.

UserPrincipal

Objekt

Reprezentuje podmiot zabezpieczeń użytkownika firmy Microsoft Entra.

Nazwisko Typ Opis
displayName

string

Nazwa wyświetlana podmiotu zabezpieczeń.
id

string (uuid)

Identyfikator podmiotu zabezpieczeń.
type string:

User

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.

WorkspaceRole

Wyliczenie

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.

Nazwisko Typ Opis
id

string (uuid)

Identyfikator przypisania roli obszaru roboczego.
principal Principal:

Podmiot zabezpieczeń.
role

WorkspaceRole

Rola obszaru roboczego podmiotu zabezpieczeń.