Compartir a través de

Workspaces - Get Workspace Role Assignment

Servicio:
Core
Versión de la API:
v1

Devuelve información de una asignación de roles del área de trabajo.

Permisos

El autor de la llamada debe tener un rol miembro o superior en el área de trabajo.

Ámbitos delegados necesarios

Workspace.Read.All o Workspace.ReadWrite.All

Identidades admitidas de Microsoft Entra

Esta API admite las identidades de Microsoft enumeradas en esta sección.

identidad Apoyo
Usuario Sí
Entidad de servicio e Identidades administradas Sí

Interfaz

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
workspaceId
 path True

string (uuid)

El identificador del área de trabajo.
workspaceRoleAssignmentId
 path True

string (uuid)

Identificador de asignación de roles del área de trabajo.

Respuestas

Nombre Tipo Description
200 OK

WorkspaceRoleAssignment

Solicitud completada correctamente.
Other Status Codes

ErrorResponse

Códigos de error comunes:

  • UnknownError: se produjo un error.

Ejemplos

Get workspace role assignment example

Solicitud de ejemplo

GET https://api.fabric.microsoft.com/v1/workspaces/0ac682f5-aee3-4968-9d21-692eb3fd4056/roleAssignments/259b6674-74cf-4197-ac05-1bf391800ec2

Respuesta de muestra

status code:
200 
{
  "id": "259b6674-74cf-4197-ac05-1bf391800ec2",
  "principal": {
    "id": "259b6674-74cf-4197-ac05-1bf391800ec2",
    "type": "User"
  },
  "role": "Member"
}

Definiciones

Nombre Description
ErrorRelatedResource

Objeto de detalles del recurso relacionado con el error.
ErrorResponse

Respuesta de error.
ErrorResponseDetails

Detalles de la respuesta de error.
GroupDetails

Detalles específicos del grupo. Aplicable cuando el tipo de entidad de seguridad es Group.
GroupType

Tipo del grupo. Se pueden agregar tipos de grupo adicionales a lo largo del tiempo.
Principal

Representa una identidad o un grupo de Microsoft Entra.
PrincipalType

Tipo de la entidad de seguridad. Se pueden agregar tipos de entidad de seguridad adicionales a lo largo del tiempo.
ServicePrincipalDetails

Detalles específicos de la entidad de servicio. Aplicable cuando el tipo de entidad de seguridad es ServicePrincipal.
ServicePrincipalProfileDetails

Detalles del perfil de entidad de servicio. Aplicable cuando el tipo de entidad de seguridad es ServicePrincipalProfile.
UserDetails

Detalles específicos de la entidad de seguridad de usuario. Aplicable cuando el tipo de entidad de seguridad es User.
WorkspaceRole

Un rol área de trabajo. Se pueden agregar roles de área de trabajo adicionales a lo largo del tiempo.
WorkspaceRoleAssignment

Objeto de asignación de roles del área de trabajo.

ErrorRelatedResource

Object

Objeto de detalles del recurso relacionado con el error.

Nombre Tipo Description
resourceId

string

Identificador de recurso implicado en el error.
resourceType

string

Tipo del recurso implicado en el error.

ErrorResponse

Object

Respuesta de error.

Nombre Tipo Description
errorCode

string

Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios.
message

string

Representación legible del error.
moreDetails

ErrorResponseDetails[]

Lista de detalles de error adicionales.
relatedResource

ErrorRelatedResource

Detalles del recurso relacionado con el error.
requestId

string

Identificador de la solicitud asociada al error.

ErrorResponseDetails

Object

Detalles de la respuesta de error.

Nombre Tipo Description
errorCode

string

Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios.
message

string

Representación legible del error.
relatedResource

ErrorRelatedResource

Detalles del recurso relacionado con el error.

GroupDetails

Object

Detalles específicos del grupo. Aplicable cuando el tipo de entidad de seguridad es Group.

Nombre Tipo Description
groupType

GroupType

Tipo del grupo. Se pueden agregar tipos de grupo adicionales a lo largo del tiempo.

GroupType

Enumeración

Tipo del grupo. Se pueden agregar tipos de grupo adicionales a lo largo del tiempo.

Valor Description
Unknown

El tipo de grupo principal es desconocido.
SecurityGroup

La entidad de seguridad es un grupo de seguridad.
DistributionList

La entidad de seguridad es una lista de distribución.

Principal

Object

Representa una identidad o un grupo de Microsoft Entra.

Nombre Tipo Description
displayName

string

Nombre para mostrar de la entidad de seguridad.
groupDetails

GroupDetails

Detalles específicos del grupo. Aplicable cuando el tipo de entidad de seguridad es Group.
id

string (uuid)

Identificador de la entidad de seguridad.
servicePrincipalDetails

ServicePrincipalDetails

Detalles específicos de la entidad de servicio. Aplicable cuando el tipo de entidad de seguridad es ServicePrincipal.
servicePrincipalProfileDetails

ServicePrincipalProfileDetails

Detalles del perfil de entidad de servicio. Aplicable cuando el tipo de entidad de seguridad es ServicePrincipalProfile.
type

PrincipalType

Tipo de la entidad de seguridad. Se pueden agregar tipos de entidad de seguridad adicionales a lo largo del tiempo.
userDetails

UserDetails

Detalles específicos de la entidad de seguridad de usuario. Aplicable cuando el tipo de entidad de seguridad es User.

PrincipalType

Enumeración

Tipo de la entidad de seguridad. Se pueden agregar tipos de entidad de seguridad adicionales a lo largo del tiempo.

Valor Description
User

La entidad de seguridad es una entidad de seguridad de usuario de Microsoft Entra.
ServicePrincipal

La entidad de seguridad es una entidad de servicio de Microsoft Entra.
Group

La entidad de seguridad es un grupo de seguridad.
ServicePrincipalProfile

La entidad de servicio es un perfil de entidad de servicio.
EntireTenant

La entidad de seguridad representa todos los usuarios de inquilinos.

ServicePrincipalDetails

Object

Detalles específicos de la entidad de servicio. Aplicable cuando el tipo de entidad de seguridad es ServicePrincipal.

Nombre Tipo Description
aadAppId

string (uuid)

Microsoft Entra AppId de la entidad de servicio.

ServicePrincipalProfileDetails

Object

Detalles del perfil de entidad de servicio. Aplicable cuando el tipo de entidad de seguridad es ServicePrincipalProfile.

Nombre Tipo Description
parentPrincipal

Principal

La entidad de seguridad principal del perfil de la entidad de servicio.

UserDetails

Object

Detalles específicos de la entidad de seguridad de usuario. Aplicable cuando el tipo de entidad de seguridad es User.

Nombre Tipo Description
userPrincipalName

string

Nombre principal de usuario.

WorkspaceRole

Enumeración

Un rol área de trabajo. Se pueden agregar roles de área de trabajo adicionales a lo largo del tiempo.

Valor Description
Admin

Habilita el acceso administrativo al área de trabajo.
Member

Habilita el acceso de pertenencia al área de trabajo.
Contributor

Habilita la contribución al área de trabajo.
Viewer

Habilita la visualización del área de trabajo.

WorkspaceRoleAssignment

Object

Objeto de asignación de roles del área de trabajo.

Nombre Tipo Description
id

string (uuid)

Identificador de asignación de roles del área de trabajo.
principal

Principal

La entidad de seguridad.
role

WorkspaceRole

Rol de área de trabajo de la entidad de seguridad.