Domains - Role Assignments Bulk Assign
Observação
Esta API está em pré-visualização.
Atribua os administradores ou colaboradores especificados ao domínio.
Permissões
O chamador deve ser um administrador de malha.
Escopos delegados necessários
Tenant.ReadWrite.All.
Limitações
Máximo de 25 pedidos por minuto e por entidade principal.
Identidades suportadas pelo Microsoft Entra
Esta API suporta as identidades do Microsoft listadas nesta secção.
Identidade | Suporte |
---|---|
Utilizador | Sim |
da entidade de serviço e identidades gerenciadas | Sim |
Interface
POST https://api.fabric.microsoft.com/v1/admin/domains/{domainId}/roleAssignments/bulkAssign
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
domain
|
path | True |
string uuid |
O ID do domínio. |
Corpo do Pedido
Name | Necessário | Tipo | Description |
---|---|---|---|
type | True |
O tipo de solicitação de atualização. |
|
principals |
Representa uma identidade ou um grupo do Microsoft Entra. |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
Pedido concluído com sucesso. |
|
Other Status Codes |
Códigos de erro comuns:
|
Exemplos
Assign domain admins example |
Assign domain contributors example |
Assign domain admins example
Pedido de amostra
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"
}
]
}
Resposta da amostra
Assign domain contributors example
Pedido de amostra
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"
}
]
}
Resposta da amostra
Definições
Name | Description |
---|---|
Domain |
Representa os membros do domínio pelo tipo de solicitação da entidade de segurança. Tipos de solicitação adicionais podem ser adicionados ao longo do tempo. |
Domain |
A carga útil de solicitação para atribuir membros de domínio para um domínio por entidade de segurança. |
Error |
O objeto de detalhes do recurso relacionado ao erro. |
Error |
A resposta de erro. |
Error |
Os detalhes da resposta de erro. |
Group |
Detalhes específicos do grupo. Aplicável quando o tipo principal é |
Group |
O tipo do grupo. Tipos de grupo adicionais podem ser adicionados ao longo do tempo. |
Principal |
Representa uma identidade ou um grupo do Microsoft Entra. |
Principal |
O tipo do principal. Ao longo do tempo, podem ser acrescentados tipos principais adicionais. |
Service |
Detalhes específicos da entidade de serviço. Aplicável quando o tipo principal é |
Service |
Detalhes do perfil da entidade de serviço. Aplicável quando o tipo principal é |
User |
Detalhes específicos principais do usuário. Aplicável quando o tipo principal é |
DomainRole
Representa os membros do domínio pelo tipo de solicitação da entidade de segurança. Tipos de solicitação adicionais podem ser adicionados ao longo do tempo.
Valor | Description |
---|---|
Admins |
Tipo de solicitação de administradores de domínio. |
Contributors |
Tipo de solicitação de contribuidores de domínio. |
DomainRoleAssignmentRequest
A carga útil de solicitação para atribuir membros de domínio para um domínio por entidade de segurança.
Name | Tipo | Description |
---|---|---|
principals |
Representa uma identidade ou um grupo do Microsoft Entra. |
|
type |
O tipo de solicitação de atualização. |
ErrorRelatedResource
O objeto de detalhes do recurso relacionado ao erro.
Name | Tipo | Description |
---|---|---|
resourceId |
string |
A ID do recurso envolvida no erro. |
resourceType |
string |
O tipo de recurso envolvido no erro. |
ErrorResponse
A resposta de erro.
Name | Tipo | Description |
---|---|---|
errorCode |
string |
Um identificador específico que fornece informações sobre uma condição de erro, permitindo uma comunicação padronizada entre nosso serviço e seus usuários. |
message |
string |
Uma representação legível por humanos do erro. |
moreDetails |
Lista de detalhes de erro adicionais. |
|
relatedResource |
Os detalhes do recurso relacionados ao erro. |
|
requestId |
string |
ID da solicitação associada ao erro. |
ErrorResponseDetails
Os detalhes da resposta de erro.
Name | Tipo | Description |
---|---|---|
errorCode |
string |
Um identificador específico que fornece informações sobre uma condição de erro, permitindo uma comunicação padronizada entre nosso serviço e seus usuários. |
message |
string |
Uma representação legível por humanos do erro. |
relatedResource |
Os detalhes do recurso relacionados ao erro. |
GroupDetails
Detalhes específicos do grupo. Aplicável quando o tipo principal é Group
.
Name | Tipo | Description |
---|---|---|
groupType |
O tipo do grupo. Tipos de grupo adicionais podem ser adicionados ao longo do tempo. |
GroupType
O tipo do grupo. Tipos de grupo adicionais podem ser adicionados ao longo do tempo.
Valor | Description |
---|---|
DistributionList |
Principal é uma lista de distribuição. |
SecurityGroup |
Principal é um grupo de segurança. |
Unknown |
O tipo de grupo principal é desconhecido. |
Principal
Representa uma identidade ou um grupo do Microsoft Entra.
Name | Tipo | Description |
---|---|---|
displayName |
string |
O nome de exibição da entidade de segurança. |
groupDetails |
Detalhes específicos do grupo. Aplicável quando o tipo principal é |
|
id |
string uuid |
O ID da entidade de segurança. |
servicePrincipalDetails |
Detalhes específicos da entidade de serviço. Aplicável quando o tipo principal é |
|
servicePrincipalProfileDetails |
Detalhes do perfil da entidade de serviço. Aplicável quando o tipo principal é |
|
type |
O tipo do principal. Ao longo do tempo, podem ser acrescentados tipos principais adicionais. |
|
userDetails |
Detalhes específicos principais do usuário. Aplicável quando o tipo principal é |
PrincipalType
O tipo do principal. Ao longo do tempo, podem ser acrescentados tipos principais adicionais.
Valor | Description |
---|---|
Group |
Principal é um grupo de segurança. |
ServicePrincipal |
Principal é uma entidade de serviço do Microsoft Entra. |
ServicePrincipalProfile |
Principal é um perfil de entidade de serviço. |
User |
Principal é uma entidade de usuário do Microsoft Entra. |
ServicePrincipalDetails
Detalhes específicos da entidade de serviço. Aplicável quando o tipo principal é ServicePrincipal
.
Name | Tipo | Description |
---|---|---|
aadAppId |
string uuid |
O Microsoft Entra AppId da entidade de serviço. |
ServicePrincipalProfileDetails
Detalhes do perfil da entidade de serviço. Aplicável quando o tipo principal é ServicePrincipalProfile
.
Name | Tipo | Description |
---|---|---|
parentPrincipal |
A entidade principal do perfil da entidade de serviço. |
UserDetails
Detalhes específicos principais do usuário. Aplicável quando o tipo principal é User
.
Name | Tipo | Description |
---|---|---|
userPrincipalName |
string |
O nome principal do usuário. |