Condividi tramite

Domains - Assign Domain Workspaces By Principals

  • Riferimento
Servizio:
Admin
Versione API:
v1

Nota

Questa API è in anteprima.

Assegnare le aree di lavoro al dominio specificato, quando una delle entità specificate dispone dell'autorizzazione di amministratore nell'area di lavoro.
Le assegnazioni di dominio preesistenti verranno sostituite a meno che la riassegnazione bulk non venga bloccata dalle impostazioni del tenant di gestione del dominio.

Questa API supporta operazioni con esecuzione prolungata (LRO).

Autorizzazioni

Il chiamante deve essere un amministratore di Fabric.

Ambiti delegati obbligatori

Tenant.ReadWrite.All.

Limitazioni

Massimo 10 richieste al 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}/assignWorkspacesByPrincipals

Parametri dell'URI

Nome In Necessario Tipo Descrizione
domainId
 path True

string

uuid

ID di dominio.

Corpo della richiesta

Nome Tipo Descrizione
principals

Principal[]

Rappresenta un'identità o un gruppo Microsoft Entra.

Risposte

Nome Tipo Descrizione
202 Accepted

L'operazione è in corso

Intestazioni

  • Location: string
  • Retry-After: integer
  • x-ms-operation-id: string
Other Status Codes

ErrorResponse

Codici di errore comuni:

  • UnknownError: si è verificato un errore.

Esempio

Assign domain workspaces example

Esempio di richiesta

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

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

Risposta di esempio

Codice di stato:
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

Definizioni

Nome Descrizione
AssignDomainWorkspacesByPrincipalsRequest

Payload della richiesta per l'assegnazione di aree di lavoro a 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.

AssignDomainWorkspacesByPrincipalsRequest

Object

Payload della richiesta per l'assegnazione di aree di lavoro a un dominio per entità.

Nome Tipo Descrizione
principals

Principal[]

Rappresenta un'identità o un gruppo Microsoft Entra.

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.