Freigeben über

Domains - Role Assignments Bulk Assign

  • Referenz
Dienst:
Admin
API-Version:
v1

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
domainId
 path True

string

uuid

Die Domänen-ID.

Anforderungstext

Name Erforderlich Typ Beschreibung
type True

DomainRole

Der Aktualisierungsanforderungstyp.
principals

Principal[]

Stellt eine Identität oder eine Microsoft Entra-Gruppe dar.

Antworten

Name Typ Beschreibung
200 OK

Die Anforderung wurde erfolgreich abgeschlossen.
Other Status Codes

ErrorResponse

Häufige Fehlercodes:

  • AssignGuestUserAsDomainAdminError – Fehler beim Zuweisen von Domänenadministratoren, da Gastbenutzer nicht als Domänenadministratoren zugewiesen werden können.

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

Statuscode:
200

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

Statuscode:
200

Definitionen

Name Beschreibung
DomainRole

Stellt die Domänenmitglieder nach dem Anforderungstyp des Prinzipals dar. Zusätzliche Anforderungstypen können im Laufe der Zeit hinzugefügt werden.
DomainRoleAssignmentRequest

Die Anforderungsnutzlast zum Zuweisen von Domänenmitgliedern für eine Domäne nach Prinzipal.
ErrorRelatedResource

Das Fehlerbezogene Ressourcendetails-Objekt.
ErrorResponse

Die Fehlerantwort.
ErrorResponseDetails

Die Fehlerantwortdetails.
GroupDetails

Gruppieren Sie bestimmte Details. Gilt, wenn der Prinzipaltyp Groupist.
GroupType

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

Der Typ des Prinzipals. Im Laufe der Zeit können zusätzliche Prinzipaltypen hinzugefügt werden.
ServicePrincipalDetails

Spezifische Details des Dienstprinzipals. Gilt, wenn der Prinzipaltyp ServicePrincipalist.
ServicePrincipalProfileDetails

Dienstprinzipalprofildetails. Gilt, wenn der Prinzipaltyp ServicePrincipalProfileist.
UserDetails

Spezifische Details des Benutzerprinzipals. Gilt, wenn der Prinzipaltyp Userist.

DomainRole

Enumeration

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

Objekt

Die Anforderungsnutzlast zum Zuweisen von Domänenmitgliedern für eine Domäne nach Prinzipal.

Name Typ Beschreibung
principals

Principal[]

Stellt eine Identität oder eine Microsoft Entra-Gruppe dar.
type

DomainRole

Der Aktualisierungsanforderungstyp.

ErrorRelatedResource

Objekt

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

Objekt

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

ErrorResponseDetails[]

Liste der zusätzlichen Fehlerdetails.
relatedResource

ErrorRelatedResource

Die fehlerbezogenen Ressourcendetails.
requestId

string

ID der Anforderung, die dem Fehler zugeordnet ist.

ErrorResponseDetails

Objekt

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

ErrorRelatedResource

Die fehlerbezogenen Ressourcendetails.

GroupDetails

Objekt

Gruppieren Sie bestimmte Details. Gilt, wenn der Prinzipaltyp Groupist.

Name Typ Beschreibung
groupType

GroupType

Der Typ der Gruppe. Weitere Gruppentypen können im Laufe der Zeit hinzugefügt werden.

GroupType

Enumeration

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

Objekt

Stellt eine Identität oder eine Microsoft Entra-Gruppe dar.

Name Typ Beschreibung
displayName

string

Der Anzeigename des Prinzipals.
groupDetails

GroupDetails

Gruppieren Sie bestimmte Details. Gilt, wenn der Prinzipaltyp Groupist.
id

string

uuid

Die ID des Prinzipals.
servicePrincipalDetails

ServicePrincipalDetails

Spezifische Details des Dienstprinzipals. Gilt, wenn der Prinzipaltyp ServicePrincipalist.
servicePrincipalProfileDetails

ServicePrincipalProfileDetails

Dienstprinzipalprofildetails. Gilt, wenn der Prinzipaltyp ServicePrincipalProfileist.
type

PrincipalType

Der Typ des Prinzipals. Im Laufe der Zeit können zusätzliche Prinzipaltypen hinzugefügt werden.
userDetails

UserDetails

Spezifische Details des Benutzerprinzipals. Gilt, wenn der Prinzipaltyp Userist.

PrincipalType

Enumeration

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

Objekt

Spezifische Details des Dienstprinzipals. Gilt, wenn der Prinzipaltyp ServicePrincipalist.

Name Typ Beschreibung
aadAppId

string

uuid

Die Microsoft Entra AppId des Dienstprinzipals.

ServicePrincipalProfileDetails

Objekt

Dienstprinzipalprofildetails. Gilt, wenn der Prinzipaltyp ServicePrincipalProfileist.

Name Typ Beschreibung
parentPrincipal

Principal

Der übergeordnete Prinzipal des Dienstprinzipals.

UserDetails

Objekt

Spezifische Details des Benutzerprinzipals. Gilt, wenn der Prinzipaltyp Userist.

Name Typ Beschreibung
userPrincipalName

string

Der Benutzerprinzipalname.