Partilhar via

Workspaces - Update Workspace Role Assignment

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

Atualiza uma atribuição de função de espaço de trabalho.
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 espaço de trabalho.

Escopos delegados necessários

Workspace.ReadWrite.All

Identidades suportadas pelo Entra da Microsoft

Esta API suporta as identidades do Microsoft listadas nesta secção.

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

Interfaz

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

Parâmetros do URI

Name Em Necessário Tipo Description
workspaceId
 path True

string (uuid)

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

string (uuid)

A ID de atribuição da função do espaço de trabalho.

Corpo do Pedido

Name Necessário Tipo Description
role True

WorkspaceRole

A função de espaço de trabalho da entidade de segurança.

Respostas

Name Tipo Description
200 OK

WorkspaceRoleAssignment

Pedido concluído com sucesso.
Other Status Codes

ErrorResponse

Códigos de erro comuns:

  • UnknownError - Ocorreu um erro.

Exemplos

Update workspace role assignment example

Pedido de amostra

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

{
  "role": "Contributor"
}

Resposta da amostra

Código de estado:
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

Name 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 do principal. Ao longo do tempo, podem ser acrescentados tipos principais adicionais.
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

Atualize a carga útil da solicitação de atribuição de função do espaço de trabalho.
UserDetails

Detalhes específicos principais do usuário. Aplicável quando o tipo principal é User.
WorkspaceRole

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

Um objeto de atribuição de função de espaço de trabalho.

ErrorRelatedResource

Object

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

Object

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

ErrorResponseDetails[]

Lista de detalhes de erro adicionais.
relatedResource

ErrorRelatedResource

Os detalhes do recurso relacionados ao erro.
requestId

string

ID da solicitação associada ao erro.

ErrorResponseDetails

Object

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

ErrorRelatedResource

Os detalhes do recurso relacionados ao erro.

GroupDetails

Object

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

Name 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

Principal é um grupo de segurança.
DistributionList

Principal é uma lista de distribuição.

Principal

Object

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

GroupDetails

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

string (uuid)

O 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 do principal. Ao longo do tempo, podem ser acrescentados tipos principais adicionais.
userDetails

UserDetails

Detalhes específicos principais do usuário. Aplicável quando o tipo principal é User.

PrincipalType

Enumeração

O tipo do principal. Ao longo do tempo, podem ser acrescentados tipos principais adicionais.

Valor Description
User

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

Principal é uma entidade de serviço do Microsoft Entra.
Group

Principal é um grupo de segurança.
ServicePrincipalProfile

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

Principal representa todos os usuários locatários.

ServicePrincipalDetails

Object

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

Object

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

Name Tipo Description
parentPrincipal

Principal

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

UpdateWorkspaceRoleAssignmentRequest

Object

Atualize a carga útil da solicitação de atribuição de função do espaço de trabalho.

Name Tipo Description
role

WorkspaceRole

A função de espaço de trabalho da entidade de segurança.

UserDetails

Object

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.

WorkspaceRole

Enumeração

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

Valor Description
Admin

Permite o acesso administrativo ao espaço de trabalho.
Member

Permite o acesso da associação ao espaço de trabalho.
Contributor

Permite a contribuição para o espaço de trabalho.
Viewer

Permite a visualização do espaço de trabalho.

WorkspaceRoleAssignment

Object

Um objeto de atribuição de função de espaço de trabalho.

Name Tipo Description
id

string (uuid)

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

Principal

O principal.
role

WorkspaceRole

A função de espaço de trabalho da entidade de segurança.