Domains - Role Assignments Bulk Assign
Anmerkung
Diese API befindet sich in der Vorschau.
Weisen Sie die angegebenen Administratoren oder Mitwirkenden der Domäne zu.
Erlaubnisse
Der Aufrufer muss ein Fabric-Administrator sein.
Erforderliche delegierte Bereiche
Tenant.ReadWrite.All.
Begrenzungen
Maximal 25 Anforderungen pro Minute pro Prinzipal.
Von Microsoft Entra unterstützte Identitäten
Diese API unterstützt die in diesem Abschnitt aufgeführten Microsoft Identitäten.
Identität | Unterstützen |
---|---|
Benutzer | Ja |
Dienstprinzipal und verwaltete Identitäten | Ja |
Schnittstelle
POST https://api.fabric.microsoft.com/v1/admin/domains/{domainId}/roleAssignments/bulkAssign
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
domain
|
path | True |
string uuid |
Die Domänen-ID. |
Anforderungstext
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
type | True |
Der Aktualisierungsanforderungstyp. |
|
principals |
Stellt eine Identität oder eine Microsoft Entra-Gruppe dar. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Die Anforderung wurde erfolgreich abgeschlossen. |
|
Other Status Codes |
Häufige Fehlercodes:
|
Beispiele
Assign domain admins example |
Assign domain contributors example |
Assign domain admins example
Beispielanforderung
POST https://api.fabric.microsoft.com/v1/admin/domains/97dd1d38-a4c6-41ed-bc4f-1e383f8ddd0f/roleAssignments/bulkAssign
{
"type": "Admins",
"principals": [
{
"id": "796ce6ad-9163-4c16-9559-c68192a251de",
"type": "User"
}
]
}
Beispiel für eine Antwort
Assign domain contributors example
Beispielanforderung
POST https://api.fabric.microsoft.com/v1/admin/domains/97dd1d38-a4c6-41ed-bc4f-1e383f8ddd0f/roleAssignments/bulkAssign
{
"type": "Contributors",
"principals": [
{
"id": "796ce6ad-9163-4c16-9559-c68192a251de",
"type": "User"
}
]
}
Beispiel für eine Antwort
Definitionen
Name | Beschreibung |
---|---|
Domain |
Stellt die Domänenmitglieder nach dem Anforderungstyp des Prinzipals dar. Zusätzliche Anforderungstypen können im Laufe der Zeit hinzugefügt werden. |
Domain |
Die Anforderungsnutzlast zum Zuweisen von Domänenmitgliedern für eine Domäne nach Prinzipal. |
Error |
Das Fehlerbezogene Ressourcendetails-Objekt. |
Error |
Die Fehlerantwort. |
Error |
Die Fehlerantwortdetails. |
Group |
Gruppieren Sie bestimmte Details. Gilt, wenn der Prinzipaltyp |
Group |
Der Typ der Gruppe. Weitere Gruppentypen können im Laufe der Zeit hinzugefügt werden. |
Principal |
Stellt eine Identität oder eine Microsoft Entra-Gruppe dar. |
Principal |
Der Typ des Prinzipals. Im Laufe der Zeit können zusätzliche Prinzipaltypen hinzugefügt werden. |
Service |
Spezifische Details des Dienstprinzipals. Gilt, wenn der Prinzipaltyp |
Service |
Dienstprinzipalprofildetails. Gilt, wenn der Prinzipaltyp |
User |
Spezifische Details des Benutzerprinzipals. Gilt, wenn der Prinzipaltyp |
DomainRole
Stellt die Domänenmitglieder nach dem Anforderungstyp des Prinzipals dar. Zusätzliche Anforderungstypen können im Laufe der Zeit hinzugefügt werden.
Wert | Beschreibung |
---|---|
Admins |
Anforderungstyp für Domänenadministratoren. |
Contributors |
Anforderungstyp für Domänenmitwirkende. |
DomainRoleAssignmentRequest
Die Anforderungsnutzlast zum Zuweisen von Domänenmitgliedern für eine Domäne nach Prinzipal.
Name | Typ | Beschreibung |
---|---|---|
principals |
Stellt eine Identität oder eine Microsoft Entra-Gruppe dar. |
|
type |
Der Aktualisierungsanforderungstyp. |
ErrorRelatedResource
Das Fehlerbezogene Ressourcendetails-Objekt.
Name | Typ | Beschreibung |
---|---|---|
resourceId |
string |
Die Ressourcen-ID, die an dem Fehler beteiligt ist. |
resourceType |
string |
Der Typ der Ressource, die an dem Fehler beteiligt ist. |
ErrorResponse
Die Fehlerantwort.
Name | Typ | Beschreibung |
---|---|---|
errorCode |
string |
Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht. |
message |
string |
Eine lesbare Darstellung des Fehlers. |
moreDetails |
Liste der zusätzlichen Fehlerdetails. |
|
relatedResource |
Die fehlerbezogenen Ressourcendetails. |
|
requestId |
string |
ID der Anforderung, die dem Fehler zugeordnet ist. |
ErrorResponseDetails
Die Fehlerantwortdetails.
Name | Typ | Beschreibung |
---|---|---|
errorCode |
string |
Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht. |
message |
string |
Eine lesbare Darstellung des Fehlers. |
relatedResource |
Die fehlerbezogenen Ressourcendetails. |
GroupDetails
Gruppieren Sie bestimmte Details. Gilt, wenn der Prinzipaltyp Group
ist.
Name | Typ | Beschreibung |
---|---|---|
groupType |
Der Typ der Gruppe. Weitere Gruppentypen können im Laufe der Zeit hinzugefügt werden. |
GroupType
Der Typ der Gruppe. Weitere Gruppentypen können im Laufe der Zeit hinzugefügt werden.
Wert | Beschreibung |
---|---|
DistributionList |
Prinzipal ist eine Verteilerliste. |
SecurityGroup |
Prinzipal ist eine Sicherheitsgruppe. |
Unknown |
Der Prinzipalgruppentyp ist unbekannt. |
Principal
Stellt eine Identität oder eine Microsoft Entra-Gruppe dar.
Name | Typ | Beschreibung |
---|---|---|
displayName |
string |
Der Anzeigename des Prinzipals. |
groupDetails |
Gruppieren Sie bestimmte Details. Gilt, wenn der Prinzipaltyp |
|
id |
string uuid |
Die ID des Prinzipals. |
servicePrincipalDetails |
Spezifische Details des Dienstprinzipals. Gilt, wenn der Prinzipaltyp |
|
servicePrincipalProfileDetails |
Dienstprinzipalprofildetails. Gilt, wenn der Prinzipaltyp |
|
type |
Der Typ des Prinzipals. Im Laufe der Zeit können zusätzliche Prinzipaltypen hinzugefügt werden. |
|
userDetails |
Spezifische Details des Benutzerprinzipals. Gilt, wenn der Prinzipaltyp |
PrincipalType
Der Typ des Prinzipals. Im Laufe der Zeit können zusätzliche Prinzipaltypen hinzugefügt werden.
Wert | Beschreibung |
---|---|
Group |
Prinzipal ist eine Sicherheitsgruppe. |
ServicePrincipal |
Prinzipal ist ein Microsoft Entra-Dienstprinzipal. |
ServicePrincipalProfile |
Prinzipal ist ein Dienstprinzipalprofil. |
User |
Prinzipal ist ein Microsoft Entra-Benutzerprinzipal. |
ServicePrincipalDetails
Spezifische Details des Dienstprinzipals. Gilt, wenn der Prinzipaltyp ServicePrincipal
ist.
Name | Typ | Beschreibung |
---|---|---|
aadAppId |
string uuid |
Die Microsoft Entra AppId des Dienstprinzipals. |
ServicePrincipalProfileDetails
Dienstprinzipalprofildetails. Gilt, wenn der Prinzipaltyp ServicePrincipalProfile
ist.
Name | Typ | Beschreibung |
---|---|---|
parentPrincipal |
Der übergeordnete Prinzipal des Dienstprinzipals. |
UserDetails
Spezifische Details des Benutzerprinzipals. Gilt, wenn der Prinzipaltyp User
ist.
Name | Typ | Beschreibung |
---|---|---|
userPrincipalName |
string |
Der Benutzerprinzipalname. |