Compartilhar via

Workspaces - Update Workspace Role Assignment

Serviço:
Core
Versão da API:
v1

Atualiza uma atribuição de função de workspace.
A atribuição de função do último administrador não pode ser alterada.

Permissões

O chamador deve ter a função de administrador no workspace.

Escopos delegados necessários

Workspace.ReadWrite.All

Identidades com suporte do Microsoft Entra

Esta API dá suporte às identidades do Microsoft listadas nesta seção.

Identidade Apoio
Utilizador Yes
Entidade de serviço e identidades gerenciadas Yes

Interfase

PATCH https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/roleAssignments/{workspaceRoleAssignmentId}

Parâmetros de URI

Nome Em Obrigatório Tipo Description
workspaceId
 path True

string (uuid)

O identificador do espaço de trabalho.
workspaceRoleAssignmentId
 path True

string (uuid)

A ID da atribuição de função do workspace.

Corpo da solicitação

Nome Obrigatório Tipo Description
role True

WorkspaceRole

A função de workspace da entidade de segurança.

Respostas

Nome Tipo Description
200 OK

WorkspaceRoleAssignment

Solicitação concluída com êxito.
Other Status Codes

ErrorResponse

Códigos de erro comuns:

  • UnknownError – Ocorreu um erro.

Exemplos

Update workspace role assignment example

Solicitação de exemplo

PATCH https://api.fabric.microsoft.com/v1/workspaces/0ac682f5-aee3-4968-9d21-692eb3fd4056/roleAssignments/0218b8c4-f5a2-4a1e-bbbd-a986dd8aeb81

{
  "role": "Contributor"
}

Resposta de exemplo

Código de status:
200 
{
  "id": "0218b8c4-f5a2-4a1e-bbbd-a986dd8aeb81",
  "principal": {
    "displayName": "user1",
    "id": "0218b8c4-f5a2-4a1e-bbbd-a986dd8aeb81",
    "type": "User",
    "userDetails": {
      "userPrincipalName": "user1@microsoft.com"
    }
  },
  "role": "Contributor"
}

Definições

Nome Description
ErrorRelatedResource

O objeto de detalhes do recurso relacionado ao erro.
ErrorResponse

A resposta de erro.
ErrorResponseDetails

Os detalhes da resposta de erro.
GroupDetails

Detalhes específicos do grupo. Aplicável quando o tipo principal é Group.
GroupType

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

O tipo da entidade de segurança. Tipos de entidades de segurança adicionais podem ser adicionados ao longo do tempo.
ServicePrincipalDetails

Detalhes específicos da entidade de serviço. Aplicável quando o tipo principal é ServicePrincipal.
ServicePrincipalProfileDetails

Detalhes do perfil da entidade de serviço. Aplicável quando o tipo principal é ServicePrincipalProfile.
UpdateWorkspaceRoleAssignmentRequest

Atualizar o conteúdo da solicitação de atribuição de função do workspace.
UserDetails

Detalhes específicos da entidade de usuário. Aplicável quando o tipo principal é User.
WorkspaceRole

Uma função de workspace. Funções de workspace adicionais podem ser adicionadas ao longo do tempo.
WorkspaceRoleAssignment

Um objeto de atribuição de função de workspace.

ErrorRelatedResource

Objeto

O objeto de detalhes do recurso relacionado ao erro.

Nome Tipo Description
resourceId

string

A ID do recurso envolvida no erro.
resourceType

string

O tipo do recurso envolvido no erro.

ErrorResponse

Objeto

A resposta de erro.

Nome Tipo Description
errorCode

string

Um identificador específico que fornece informações sobre uma condição de erro, permitindo a comunicação padronizada entre nosso serviço e seus usuários.
message

string

Uma representação legível humana do erro.
moreDetails

ErrorResponseDetails[]

Lista de detalhes de erro adicionais.
relatedResource

ErrorRelatedResource

Os detalhes do recurso relacionado ao erro.
requestId

string

ID da solicitação associada ao erro.

ErrorResponseDetails

Objeto

Os detalhes da resposta de erro.

Nome Tipo Description
errorCode

string

Um identificador específico que fornece informações sobre uma condição de erro, permitindo a comunicação padronizada entre nosso serviço e seus usuários.
message

string

Uma representação legível humana do erro.
relatedResource

ErrorRelatedResource

Os detalhes do recurso relacionado ao erro.

GroupDetails

Objeto

Detalhes específicos do grupo. Aplicável quando o tipo principal é Group.

Nome Tipo Description
groupType

GroupType

O tipo do grupo. Tipos de grupo adicionais podem ser adicionados ao longo do tempo.

GroupType

Enumeração

O tipo do grupo. Tipos de grupo adicionais podem ser adicionados ao longo do tempo.

Valor Description
Unknown

O tipo de grupo principal é desconhecido.
SecurityGroup

A entidade de segurança é um grupo de segurança.
DistributionList

Principal é uma lista de distribuição.

Principal

Objeto

Representa uma identidade ou um grupo do Microsoft Entra.

Nome Tipo Description
displayName

string

O nome de exibição da entidade de segurança.
groupDetails

GroupDetails

Detalhes específicos do grupo. Aplicável quando o tipo principal é Group.
id

string (uuid)

A ID da entidade de segurança.
servicePrincipalDetails

ServicePrincipalDetails

Detalhes específicos da entidade de serviço. Aplicável quando o tipo principal é ServicePrincipal.
servicePrincipalProfileDetails

ServicePrincipalProfileDetails

Detalhes do perfil da entidade de serviço. Aplicável quando o tipo principal é ServicePrincipalProfile.
type

PrincipalType

O tipo da entidade de segurança. Tipos de entidades de segurança adicionais podem ser adicionados ao longo do tempo.
userDetails

UserDetails

Detalhes específicos da entidade de usuário. Aplicável quando o tipo principal é User.

PrincipalType

Enumeração

O tipo da entidade de segurança. Tipos de entidades de segurança adicionais podem ser adicionados ao longo do tempo.

Valor Description
User

Principal é uma entidade de usuário do Microsoft Entra.
ServicePrincipal

A entidade de segurança é uma entidade de serviço do Microsoft Entra.
Group

A entidade de segurança é um grupo de segurança.
ServicePrincipalProfile

Principal é um perfil de entidade de serviço.
EntireTenant

A entidade de segurança representa todos os usuários do locatário.

ServicePrincipalDetails

Objeto

Detalhes específicos da entidade de serviço. Aplicável quando o tipo principal é ServicePrincipal.

Nome Tipo Description
aadAppId

string (uuid)

O Microsoft Entra AppId da entidade de serviço.

ServicePrincipalProfileDetails

Objeto

Detalhes do perfil da entidade de serviço. Aplicável quando o tipo principal é ServicePrincipalProfile.

Nome Tipo Description
parentPrincipal

Principal

A entidade pai do perfil da entidade de serviço.

UpdateWorkspaceRoleAssignmentRequest

Objeto

Atualizar o conteúdo da solicitação de atribuição de função do workspace.

Nome Tipo Description
role

WorkspaceRole

A função de workspace da entidade de segurança.

UserDetails

Objeto

Detalhes específicos da entidade de usuário. Aplicável quando o tipo principal é User.

Nome Tipo Description
userPrincipalName

string

Nome principal do usuário.

WorkspaceRole

Enumeração

Uma função de workspace. Funções de workspace adicionais podem ser adicionadas ao longo do tempo.

Valor Description
Admin

Habilita o acesso administrativo ao workspace.
Member

Habilita o acesso de associação ao workspace.
Contributor

Habilita a contribuição para o workspace.
Viewer

Habilita a exibição do workspace.

WorkspaceRoleAssignment

Objeto

Um objeto de atribuição de função de workspace.

Nome Tipo Description
id

string (uuid)

A ID da atribuição de função do workspace.
principal

Principal

A entidade de segurança.
role

WorkspaceRole

A função de workspace da entidade de segurança.