Udostępnij przez

Workspaces - Update Workspace Role Assignment

Usługa:
Core
Wersja interfejsu API:
v1

Aktualizuje przypisanie roli obszaru roboczego.
Nie można zmienić przypisania roli ostatniego administratora.

Uprawnienia

Obiekt wywołujący musi mieć rolę administratora w obszarze roboczym.

Wymagane zakresy delegowane

Przestrzeń robocza.OdczytZapis.Wszystko

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

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
workspaceId
 path True

string (uuid)

Identyfikator przestrzeni roboczej.
workspaceRoleAssignmentId
 path True

string (uuid)

Identyfikator przypisania roli obszaru roboczego.

Treść żądania

Nazwa Wymagane Typ Opis
role True

WorkspaceRole

Rola obszaru roboczego podmiotu zabezpieczeń.

Odpowiedzi

Nazwa Typ Opis
200 OK

WorkspaceRoleAssignment

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

ErrorResponse

Typowe kody błędów:

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

Przykłady

Update workspace role assignment example

Przykładowe żądanie

PATCH https://api.fabric.microsoft.com/v1/workspaces/0ac682f5-aee3-4968-9d21-692eb3fd4056/roleAssignments/0218b8c4-f5a2-4a1e-bbbd-a986dd8aeb81

{
  "role": "Contributor"
}

Przykładowa odpowiedź

Kod stanu:
200 
{
  "id": "0218b8c4-f5a2-4a1e-bbbd-a986dd8aeb81",
  "principal": {
    "displayName": "user1",
    "id": "0218b8c4-f5a2-4a1e-bbbd-a986dd8aeb81",
    "type": "User",
    "userDetails": {
      "userPrincipalName": "user1@microsoft.com"
    }
  },
  "role": "Contributor"
}

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

Zaktualizuj ładunek żądania przypisania roli obszaru roboczego.
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.

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.

UpdateWorkspaceRoleAssignmentRequest

Objekt

Zaktualizuj ładunek żądania przypisania roli obszaru roboczego.

Nazwa Typ Opis
role

WorkspaceRole

Rola obszaru roboczego podmiotu zabezpieczeń.

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