Workspaces - Add Workspace Role Assignment

Tjeneste:

Core

API-version:

v1

Tilføjer en rolletildeling for arbejdsområdet.
Hvis du vil hente det primære brugerobjekt-id, der kræves til anmodningens brødtekst, skal du se Find brugerobjekt-id'et.

Tilladelser

• Den, der ringer op, skal have rollen medlem eller et højere arbejdsområde.
• Medlemmer kan tilføje medlemmer eller andre med lavere tilladelser. Du kan få flere oplysninger under: arbejdsområderoller.

Påkrævede delegerede områder

Workspace.ReadWrite.All

Begrænsninger

• Hvert arbejdsområde er begrænset til maksimalt 1.000 brugere eller grupper i arbejdsområderoller (administrator, medlem, bidragyder, fremviser). Antallet af brugere i en gruppe er ikke begrænset. Begrænsningen dækker også eksterne gæster.

Microsoft Entra-understøttede identiteter

Denne API understøtter de Microsoft -identiteter, der angivet i dette afsnit.

Identitet	Støtte
Bruger	Ja
tjenesteprincipal og administrerede identiteter	Ja

Grænseflade

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

URI-parametre

Name	I	Påkrævet	Type	Beskrivelse
workspaceId	path	True	string (uuid)	Arbejdsområde-id'et.

Brødtekst for anmodning

Name	Påkrævet	Type	Beskrivelse
principal	True	Principal	Hovedstolen.
role	True	WorkspaceRole	Rollen for arbejdsområdet for hovedstolen.

Svar

Name	Type	Beskrivelse
201 Created	WorkspaceRoleAssignment	Oprettet. Headere Location: string
Other Status Codes	ErrorResponse	Almindelige fejlkoder: UnknownError – Der opstod en fejl.

Eksempler

Add workspace role assignment example

Eksempelanmodning

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff512/roleAssignments

{
  "principal": {
    "id": "8eedb1b0-3af8-4b17-8e7e-663e61e12211",
    "type": "User"
  },
  "role": "Member"
}

Eksempelsvar

Statuskode:

201

Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff512/roleAssignments/8eedb1b0-3af8-4b17-8e7e-663e61e12211

{
  "id": "8eedb1b0-3af8-4b17-8e7e-663e61e12211",
  "principal": {
    "id": "8eedb1b0-3af8-4b17-8e7e-663e61e12211",
    "type": "User"
  },
  "role": "Member"
}

Definitioner

Name	Beskrivelse
AddWorkspaceRoleAssignmentRequest	Tilføj nyttedata for anmodning om rolletildeling i arbejdsområdet.
ErrorRelatedResource	Objektet med fejlrelaterede ressourceoplysninger.
ErrorResponse	Fejlsvaret.
ErrorResponseDetails	Oplysninger om fejlsvar.
GroupDetails	Gruppér specifikke oplysninger. Gælder, når hovedtypen er Group.
GroupType	Gruppens type. Der kan tilføjes flere gruppetyper over tid.
Principal	Repræsenterer en identitet eller en Microsoft Entra-gruppe.
PrincipalType	Typen af hovedprincipal. Der kan tilføjes flere hovedtyper over tid.
ServicePrincipalDetails	Specifikke oplysninger om tjenesteprincipal. Gælder, når hovedtypen er ServicePrincipal.
ServicePrincipalProfileDetails	Profiloplysninger for tjenesteprincipal. Gælder, når hovedtypen er ServicePrincipalProfile.
UserDetails	Specifikke oplysninger om brugerens hovedprincipal. Gælder, når hovedtypen er User.
WorkspaceRole	En arbejdsområderolle. Der kan tilføjes flere arbejdsområderoller over tid.
WorkspaceRoleAssignment	Et objekt til tildeling af arbejdsområderoller.

AddWorkspaceRoleAssignmentRequest

Object

Tilføj nyttedata for anmodning om rolletildeling i arbejdsområdet.

Name	Type	Beskrivelse
principal	Principal	Hovedstolen.
role	WorkspaceRole	Rollen for arbejdsområdet for hovedstolen.

ErrorRelatedResource

Object

Objektet med fejlrelaterede ressourceoplysninger.

Name	Type	Beskrivelse
resourceId	string	Det ressource-id, der er involveret i fejlen.
resourceType	string	Typen af ressource, der er involveret i fejlen.

ErrorResponse

Object

Fejlsvaret.

Name	Type	Beskrivelse
errorCode	string	Et bestemt id, der indeholder oplysninger om en fejltilstand, der muliggør standardiseret kommunikation mellem vores tjeneste og dens brugere.
message	string	En menneskelig læsbar gengivelse af fejlen.
moreDetails	ErrorResponseDetails[]	Liste over yderligere oplysninger om fejl.
relatedResource	ErrorRelatedResource	De fejlrelaterede ressourceoplysninger.
requestId	string	Id'et for den anmodning, der er knyttet til fejlen.

ErrorResponseDetails

Object

Oplysninger om fejlsvar.

Name	Type	Beskrivelse
errorCode	string	Et bestemt id, der indeholder oplysninger om en fejltilstand, der muliggør standardiseret kommunikation mellem vores tjeneste og dens brugere.
message	string	En menneskelig læsbar gengivelse af fejlen.
relatedResource	ErrorRelatedResource	De fejlrelaterede ressourceoplysninger.

GroupDetails

Object

Gruppér specifikke oplysninger. Gælder, når hovedtypen er Group.

Name	Type	Beskrivelse
groupType	GroupType	Gruppens type. Der kan tilføjes flere gruppetyper over tid.

GroupType

Optælling

Gruppens type. Der kan tilføjes flere gruppetyper over tid.

Værdi	Beskrivelse
Unknown	Hovedgruppetypen er ukendt.
SecurityGroup	Principal er en sikkerhedsgruppe.
DistributionList	Principal er en distributionsliste.

Principal

Object

Repræsenterer en identitet eller en Microsoft Entra-gruppe.

Name	Type	Beskrivelse
displayName	string	Hovedprincipalens viste navn.
groupDetails	GroupDetails	Gruppér specifikke oplysninger. Gælder, når hovedtypen er Group.
id	string (uuid)	Hovedprincipalens id.
servicePrincipalDetails	ServicePrincipalDetails	Specifikke oplysninger om tjenesteprincipal. Gælder, når hovedtypen er ServicePrincipal.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	Profiloplysninger for tjenesteprincipal. Gælder, når hovedtypen er ServicePrincipalProfile.
type	PrincipalType	Typen af hovedprincipal. Der kan tilføjes flere hovedtyper over tid.
userDetails	UserDetails	Specifikke oplysninger om brugerens hovedprincipal. Gælder, når hovedtypen er User.

PrincipalType

Optælling

Typen af hovedprincipal. Der kan tilføjes flere hovedtyper over tid.

Værdi	Beskrivelse
User	Principal er en Microsoft Entra-brugerprincipal.
ServicePrincipal	Principal er en Microsoft Entra-tjenesteprincipal.
Group	Principal er en sikkerhedsgruppe.
ServicePrincipalProfile	Principal er en tjenesteprincipalprofil.
EntireTenant	Principal repræsenterer alle lejerbrugere.

ServicePrincipalDetails

Object

Specifikke oplysninger om tjenesteprincipal. Gælder, når hovedtypen er ServicePrincipal.

Name	Type	Beskrivelse
aadAppId	string (uuid)	Tjenesteprincipalens Microsoft Entra AppId.

ServicePrincipalProfileDetails

Object

Profiloplysninger for tjenesteprincipal. Gælder, når hovedtypen er ServicePrincipalProfile.

Name	Type	Beskrivelse
parentPrincipal	Principal	Profilen for tjenesteprincipalens overordnede hoved.

UserDetails

Object

Specifikke oplysninger om brugerens hovedprincipal. Gælder, når hovedtypen er User.

Name	Type	Beskrivelse
userPrincipalName	string	Brugerens hovednavn.

WorkspaceRole

Optælling

En arbejdsområderolle. Der kan tilføjes flere arbejdsområderoller over tid.

Værdi	Beskrivelse
Admin	Giver administrativ adgang til arbejdsområdet.
Member	Giver adgang til arbejdsområdet for medlemskab.
Contributor	Aktiverer bidrag til arbejdsområdet.
Viewer	Aktiverer visning af arbejdsområdet.

WorkspaceRoleAssignment

Object

Et objekt til tildeling af arbejdsområderoller.

Name	Type	Beskrivelse
id	string (uuid)	Tildelings-id'et for arbejdsområdets rolle.
principal	Principal	Hovedstolen.
role	WorkspaceRole	Rollen for arbejdsområdet for hovedstolen.