Compartir a través de

Workspaces - Assign To Domain

Servicio:
Core
Versión de la API:
v1

Asigna el área de trabajo especificada al dominio especificado.

Permissions

  • El autor de la llamada debe tener permisos de colaborador o ser administrador de dominio.
  • El autor de la llamada debe tener el rol de administrador del área de trabajo.

Ámbito requerido

Workspace.ReadWrite.All

Identidades admitidas de Microsoft Entra

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

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

Interfaz

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/assignToDomain

Parámetros de identificador URI

Nombre En Requerido Tipo Description
workspaceId
 path True

string (uuid)

El identificador del área de trabajo.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
domainId True

string (uuid)

El identificador del dominio al que se debe asignar el área de trabajo.

Respuestas

Nombre Tipo Description
200 OK

Solicitud completada correctamente.
Other Status Codes

ErrorResponse

Códigos de error comunes:

  • DomainNotFound: no se encontró el dominio proporcionado.

  • WorkspaceNotFound: no se encontró el área de trabajo proporcionada.

  • InsufficientPermissionsToDomain: el autor de la llamada no tiene permisos suficientes para el dominio para realizar la operación.

  • InsuficienteWorkspaceRole: el autor de la llamada no tiene permisos suficientes para el área de trabajo para realizar la operación.

  • UnknownError: se produjo un error.

Ejemplos

Assign a workspace to a domain example

Solicitud de ejemplo

POST https://api.fabric.microsoft.com/v1/workspaces/f97451ca-d6a0-482f-a46a-cc4b2c48ba56/assignToDomain

{
  "domainId": "9d04ca81-bb30-4009-bd1a-a9213a4c8d75"
}

Respuesta de muestra

status code:
200

Definiciones

Nombre Description
AssignWorkspaceToDomainRequest

Una solicitud de asignación de dominio.
ErrorRelatedResource

Objeto de detalles del recurso relacionado con el error.
ErrorResponse

Respuesta de error.
ErrorResponseDetails

Detalles de la respuesta de error.

AssignWorkspaceToDomainRequest

Object

Una solicitud de asignación de dominio.

Nombre Tipo Description
domainId

string (uuid)

El identificador del dominio al que se debe asignar el á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.