Delen via

Workspaces - Add Workspace Role Assignment

Service:
Core
API-versie:
v1

Hiermee voegt u een roltoewijzing voor de werkruimte toe.
Zie De object-id van de gebruiker zoeken om de principal-gebruikersobject-id op te halen die is vereist voor de aanvraagbody.

Machtigingen

  • De aanroeper moet een lid - of hogere werkruimterol hebben.
  • Leden kunnen leden of anderen met lagere machtigingen toevoegen. Zie voor meer informatie: werkruimterollen.

Vereiste gedelegeerde bereiken

Workspace.ReadWrite.All

Beperkingen

  • Elke werkruimte is beperkt tot maximaal 1000 gebruikers of groepen in werkruimterollen (Beheerder, Lid, Inzender, Viewer). Het aantal gebruikers binnen een groep is niet beperkt. De beperking geldt ook voor externe gasten.

Door Microsoft Entra ondersteunde identiteiten

Deze API ondersteunt de Microsoft-identiteiten die in deze sectie worden vermeld.

Identiteit Ondersteuning
Gebruiker Ja
serviceprincipal en beheerde identiteiten Ja

gebruikersinterface

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

URI-parameters

Name In Vereist Type Description
workspaceId
 path True

string (uuid)

De werkruimte-ID.

Aanvraagbody

Name Vereist Type Description
principal True

Principal

De principal.
role True

WorkspaceRole

De werkruimterol van de principal.

Antwoorden

Name Type Description
201 Created

WorkspaceRoleAssignment

Gemaakt.

Kopteksten

Location: string
Other Status Codes

ErrorResponse

Veelvoorkomende foutcodes:

  • UnknownError: er is een fout opgetreden.

Voorbeelden

Add workspace role assignment example

Voorbeeldaanvraag

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"
}

Voorbeeldrespons

Statuscode:
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"
}

Definities

Name Description
AddWorkspaceRoleAssignmentRequest

Voeg de nettolading van de aanvraag voor de roltoewijzing van de werkruimte toe.
ErrorRelatedResource

Het foutgerelateerde resourcedetailsobject.
ErrorResponse

Het foutbericht.
ErrorResponseDetails

De details van het foutbericht.
GroupDetails

Groepsspecifieke details. Van toepassing wanneer het principal-type is Group.
GroupType

Het type groep. Er kunnen in de loop van de tijd extra groepstypen worden toegevoegd.
Principal

Vertegenwoordigt een identiteit of een Microsoft Entra-groep.
PrincipalType

Het type principal. Er kunnen in de loop van de tijd extra principal-typen worden toegevoegd.
ServicePrincipalDetails

Specifieke details van de service-principal. Van toepassing wanneer het principal-type is ServicePrincipal.
ServicePrincipalProfileDetails

Details van service-principalprofiel. Van toepassing wanneer het principal-type is ServicePrincipalProfile.
UserDetails

Specifieke details van gebruikersprincipaal. Van toepassing wanneer het principal-type is User.
WorkspaceRole

Een werkruimterol. Er kunnen in de loop van de tijd extra werkruimterollen worden toegevoegd.
WorkspaceRoleAssignment

Een werkruimteroltoewijzingsobject.

AddWorkspaceRoleAssignmentRequest

Object

Voeg de nettolading van de aanvraag voor de roltoewijzing van de werkruimte toe.

Name Type Description
principal

Principal

De principal.
role

WorkspaceRole

De werkruimterol van de principal.

ErrorRelatedResource

Object

Het foutgerelateerde resourcedetailsobject.

Name Type Description
resourceId

string

De resource-id die betrokken is bij de fout.
resourceType

string

Het type resource dat betrokken is bij de fout.

ErrorResponse

Object

Het foutbericht.

Name Type Description
errorCode

string

Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message

string

Een leesbare weergave van de fout.
moreDetails

ErrorResponseDetails[]

Lijst met aanvullende foutdetails.
relatedResource

ErrorRelatedResource

De foutgerelateerde resourcedetails.
requestId

string

Id van de aanvraag die is gekoppeld aan de fout.

ErrorResponseDetails

Object

De details van het foutbericht.

Name Type Description
errorCode

string

Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message

string

Een leesbare weergave van de fout.
relatedResource

ErrorRelatedResource

De foutgerelateerde resourcedetails.

GroupDetails

Object

Groepsspecifieke details. Van toepassing wanneer het principal-type is Group.

Name Type Description
groupType

GroupType

Het type groep. Er kunnen in de loop van de tijd extra groepstypen worden toegevoegd.

GroupType

Inventarisatie

Het type groep. Er kunnen in de loop van de tijd extra groepstypen worden toegevoegd.

Waarde Description
Unknown

Het type Principal-groep is onbekend.
SecurityGroup

Principal is een beveiligingsgroep.
DistributionList

Principal is een distributielijst.

Principal

Object

Vertegenwoordigt een identiteit of een Microsoft Entra-groep.

Name Type Description
displayName

string

De weergavenaam van de principal.
groupDetails

GroupDetails

Groepsspecifieke details. Van toepassing wanneer het principal-type is Group.
id

string (uuid)

De id van de principal.
servicePrincipalDetails

ServicePrincipalDetails

Specifieke details van de service-principal. Van toepassing wanneer het principal-type is ServicePrincipal.
servicePrincipalProfileDetails

ServicePrincipalProfileDetails

Details van service-principalprofiel. Van toepassing wanneer het principal-type is ServicePrincipalProfile.
type

PrincipalType

Het type principal. Er kunnen in de loop van de tijd extra principal-typen worden toegevoegd.
userDetails

UserDetails

Specifieke details van gebruikersprincipaal. Van toepassing wanneer het principal-type is User.

PrincipalType

Inventarisatie

Het type principal. Er kunnen in de loop van de tijd extra principal-typen worden toegevoegd.

Waarde Description
User

Principal is een Microsoft Entra-gebruikersprincipaal.
ServicePrincipal

Principal is een Microsoft Entra-service-principal.
Group

Principal is een beveiligingsgroep.
ServicePrincipalProfile

Principal is een service-principalprofiel.
EntireTenant

Principal vertegenwoordigt alle tenantgebruikers.

ServicePrincipalDetails

Object

Specifieke details van de service-principal. Van toepassing wanneer het principal-type is ServicePrincipal.

Name Type Description
aadAppId

string (uuid)

De Microsoft Entra AppId van de service-principal.

ServicePrincipalProfileDetails

Object

Details van service-principalprofiel. Van toepassing wanneer het principal-type is ServicePrincipalProfile.

Name Type Description
parentPrincipal

Principal

De bovenliggende principal van het service-principalprofiel.

UserDetails

Object

Specifieke details van gebruikersprincipaal. Van toepassing wanneer het principal-type is User.

Name Type Description
userPrincipalName

string

De gebruikersprincipe-naam (UPN).

WorkspaceRole

Inventarisatie

Een werkruimterol. Er kunnen in de loop van de tijd extra werkruimterollen worden toegevoegd.

Waarde Description
Admin

Hiermee kunt u beheerderstoegang tot de werkruimte inschakelen.
Member

Hiermee schakelt u lidmaatschapstoegang tot de werkruimte in.
Contributor

Hiermee kunt u bijdragen aan de werkruimte.
Viewer

Hiermee kunt u de werkruimte weergeven.

WorkspaceRoleAssignment

Object

Een werkruimteroltoewijzingsobject.

Name Type Description
id

string (uuid)

De id van de roltoewijzing van de werkruimte.
principal

Principal

De principal.
role

WorkspaceRole

De werkruimterol van de principal.