Domains - Assign Domain Workspaces By Principals

Tjeneste:

Admin

API-version:

v1

Seddel

Denne API er en prøveversion.

Tildel arbejdsområder til det angivne domæne, når en af de angivne hoveder har administratorrettigheder i arbejdsområdet.
Eksisterende domænetildelinger tilsidesættes, medmindre massetildeling er blokeret af lejerindstillinger for domæneadministration.

Denne API understøtter LRO-handlinger (Long Running Operations).

Tilladelser

Den, der ringer op, skal være Fabric-administrator.

Påkrævede delegerede områder

Tenant.ReadWrite.All.

Begrænsninger

Maksimalt 10 anmodninger pr. minut pr. hovedkonto.

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/admin/domains/{domainId}/assignWorkspacesByPrincipals

URI-parametre

Name	I	Påkrævet	Type	Beskrivelse
domainId	path	True	string uuid	Domæne-id'et.

Brødtekst for anmodning

Name	Type	Beskrivelse
principals	Principal[]	Repræsenterer en identitet eller en Microsoft Entra-gruppe.

Svar

Name	Type	Beskrivelse
202 Accepted		Handlingen er i gang Headere Location: string Retry-After: integer x-ms-operation-id: string
Other Status Codes	ErrorResponse	Almindelige fejlkoder: UnknownError – Der opstod en fejl.

Eksempler

Assign domain workspaces example

Eksempelanmodning

HTTP

POST https://api.fabric.microsoft.com/v1/admin/domains/97dd1d38-a4c6-41ed-bc4f-1e383f8ddd0f/assignWorkspacesByPrincipals

{
  "principals": [
    {
      "id": "796ce6ad-9163-4c16-9559-c68192a251de",
      "type": "User"
    }
  ]
}

Eksempelsvar

Statuskode:

202

Location: https://api.fabric.microsoft.com/operations/cfafbeb1-8037-4d0c-896e-a46fb27ff227
x-ms-operation-id: cfafbeb1-8037-4d0c-896e-a46fb27ff227
Retry-After: 30

Definitioner

Name	Beskrivelse
AssignDomainWorkspacesByPrincipalsRequest	Nyttedata for anmodning om tildeling af arbejdsområder til et domæne efter principal.
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.

AssignDomainWorkspacesByPrincipalsRequest

Object

Nyttedata for anmodning om tildeling af arbejdsområder til et domæne efter principal.

Name	Type	Beskrivelse
principals	Principal[]	Repræsenterer en identitet eller en Microsoft Entra-gruppe.

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
DistributionList	Principal er en distributionsliste.
SecurityGroup	Principal er en sikkerhedsgruppe.
Unknown	Hovedgruppetypen er ukendt.

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
Group	Principal er en sikkerhedsgruppe.
ServicePrincipal	Principal er en Microsoft Entra-tjenesteprincipal.
ServicePrincipalProfile	Principal er en tjenesteprincipalprofil.
User	Principal er en Microsoft Entra-brugerprincipal.

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.