Condividi tramite

Domains - Role Assignments Bulk Assign

  • Riferimento
Servizio:
Admin
Versione API:
v1

Nota

Questa API è in anteprima.

Assegnare gli amministratori o i collaboratori specificati al dominio.

Autorizzazioni

Il chiamante deve essere un amministratore di Fabric.

Ambiti delegati obbligatori

Tenant.ReadWrite.All.

Limitazioni

Massimo 25 richieste per minuto per ogni entità.

Identità supportate da Microsoft Entra

Questa API supporta le identità di Microsoft elencate in questa sezione.

Identità Appoggiare
Utente Sì
'entità servizio e identità gestite Sì

Interfaccia

POST https://api.fabric.microsoft.com/v1/admin/domains/{domainId}/roleAssignments/bulkAssign

Parametri dell'URI

Nome In Necessario Tipo Descrizione
domainId
 path True

string

uuid

ID di dominio.

Corpo della richiesta

Nome Necessario Tipo Descrizione
type True

DomainRole

Tipo di richiesta di aggiornamento.
principals

Principal[]

Rappresenta un'identità o un gruppo Microsoft Entra.

Risposte

Nome Tipo Descrizione
200 OK

Richiesta completata correttamente.
Other Status Codes

ErrorResponse

Codici di errore comuni:

  • AssignGuestUserAsDomainAdminError- Assegnazione di amministratori di dominio non riuscita perché gli utenti guest non possono essere assegnati come amministratori di dominio.

Esempio

Assign domain admins example
Assign domain contributors example

Assign domain admins example

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
200

Assign domain contributors example

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
200

Definizioni

Nome Descrizione
DomainRole

Rappresenta i membri del dominio in base al tipo di richiesta dell'entità. È possibile aggiungere altri tipi di richiesta nel corso del tempo.
DomainRoleAssignmentRequest

Payload della richiesta per l'assegnazione di membri di dominio per un dominio per entità.
ErrorRelatedResource

Oggetto dettagli risorsa correlato all'errore.
ErrorResponse

Risposta di errore.
ErrorResponseDetails

Dettagli della risposta di errore.
GroupDetails

Dettagli specifici del gruppo. Applicabile quando il tipo principale è Group.
GroupType

Tipo del gruppo. È possibile aggiungere altri tipi di gruppo nel tempo.
Principal

Rappresenta un'identità o un gruppo Microsoft Entra.
PrincipalType

Tipo dell'entità. È possibile aggiungere altri tipi di entità nel tempo.
ServicePrincipalDetails

Dettagli specifici dell'entità servizio. Applicabile quando il tipo principale è ServicePrincipal.
ServicePrincipalProfileDetails

Dettagli del profilo dell'entità servizio. Applicabile quando il tipo principale è ServicePrincipalProfile.
UserDetails

Dettagli specifici dell'entità utente. Applicabile quando il tipo principale è User.

DomainRole

Enumeration

Rappresenta i membri del dominio in base al tipo di richiesta dell'entità. È possibile aggiungere altri tipi di richiesta nel corso del tempo.

Valore Descrizione
Admins

Tipo di richiesta domain admins.
Contributors

Tipo di richiesta collaboratori al dominio.

DomainRoleAssignmentRequest

Object

Payload della richiesta per l'assegnazione di membri di dominio per un dominio per entità.

Nome Tipo Descrizione
principals

Principal[]

Rappresenta un'identità o un gruppo Microsoft Entra.
type

DomainRole

Tipo di richiesta di aggiornamento.

ErrorRelatedResource

Object

Oggetto dettagli risorsa correlato all'errore.

Nome Tipo Descrizione
resourceId

string

ID risorsa coinvolto nell'errore.
resourceType

string

Tipo della risorsa coinvolta nell'errore.

ErrorResponse

Object

Risposta di errore.

Nome Tipo Descrizione
errorCode

string

Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message

string

Rappresentazione leggibile dell'errore.
moreDetails

ErrorResponseDetails[]

Elenco di dettagli aggiuntivi sull'errore.
relatedResource

ErrorRelatedResource

Dettagli della risorsa correlati all'errore.
requestId

string

ID della richiesta associata all'errore.

ErrorResponseDetails

Object

Dettagli della risposta di errore.

Nome Tipo Descrizione
errorCode

string

Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message

string

Rappresentazione leggibile dell'errore.
relatedResource

ErrorRelatedResource

Dettagli della risorsa correlati all'errore.

GroupDetails

Object

Dettagli specifici del gruppo. Applicabile quando il tipo principale è Group.

Nome Tipo Descrizione
groupType

GroupType

Tipo del gruppo. È possibile aggiungere altri tipi di gruppo nel tempo.

GroupType

Enumeration

Tipo del gruppo. È possibile aggiungere altri tipi di gruppo nel tempo.

Valore Descrizione
DistributionList

Principal è una lista di distribuzione.
SecurityGroup

Principal è un gruppo di sicurezza.
Unknown

Il tipo di gruppo principale è sconosciuto.

Principal

Object

Rappresenta un'identità o un gruppo Microsoft Entra.

Nome Tipo Descrizione
displayName

string

Nome visualizzato dell'entità.
groupDetails

GroupDetails

Dettagli specifici del gruppo. Applicabile quando il tipo principale è Group.
id

string

uuid

ID dell'entità.
servicePrincipalDetails

ServicePrincipalDetails

Dettagli specifici dell'entità servizio. Applicabile quando il tipo principale è ServicePrincipal.
servicePrincipalProfileDetails

ServicePrincipalProfileDetails

Dettagli del profilo dell'entità servizio. Applicabile quando il tipo principale è ServicePrincipalProfile.
type

PrincipalType

Tipo dell'entità. È possibile aggiungere altri tipi di entità nel tempo.
userDetails

UserDetails

Dettagli specifici dell'entità utente. Applicabile quando il tipo principale è User.

PrincipalType

Enumeration

Tipo dell'entità. È possibile aggiungere altri tipi di entità nel tempo.

Valore Descrizione
Group

Principal è un gruppo di sicurezza.
ServicePrincipal

Principal è un'entità servizio Microsoft Entra.
ServicePrincipalProfile

Principal è un profilo dell'entità servizio.
User

Principal è un'entità utente di Microsoft Entra.

ServicePrincipalDetails

Object

Dettagli specifici dell'entità servizio. Applicabile quando il tipo principale è ServicePrincipal.

Nome Tipo Descrizione
aadAppId

string

uuid

Microsoft Entra AppId dell'entità servizio.

ServicePrincipalProfileDetails

Object

Dettagli del profilo dell'entità servizio. Applicabile quando il tipo principale è ServicePrincipalProfile.

Nome Tipo Descrizione
parentPrincipal

Principal

Entità padre del profilo dell'entità servizio.

UserDetails

Object

Dettagli specifici dell'entità utente. Applicabile quando il tipo principale è User.

Nome Tipo Descrizione
userPrincipalName

string

Nome dell'entità utente.