Workspaces - Deprovision Identity
Desaprovisionar una identidad del área de trabajo.
Esta API admite operaciones de larga duración (LRO).
Permisos
El autor de la llamada debe tener un rol de administrador en el área de trabajo.
Ámbitos delegados necesarios
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
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/deprovisionIdentity
Parámetros de identificador URI
| Nombre | En | Requerido | Tipo | Description |
|---|---|---|---|---|
|
workspace
|
path | True |
string (uuid) |
El identificador del área de trabajo. |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 200 OK |
Desaprovisionado correctamente |
|
| 202 Accepted |
Solicitud aceptada, desaprovisionamiento de identidades en curso Encabezados
|
|
| Other Status Codes |
Códigos de error comunes:
|
Ejemplos
Deprovision workspace identity example
Solicitud de ejemplo
POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff227/deprovisionIdentity
Respuesta de muestra
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 5
Definiciones
| Nombre | Description |
|---|---|
|
Error |
Objeto de detalles del recurso relacionado con el error. |
|
Error |
Respuesta de error. |
|
Error |
Detalles de la respuesta de error. |
ErrorRelatedResource
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
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 |
Lista de detalles de error adicionales. |
|
| relatedResource |
Detalles del recurso relacionado con el error. |
|
| requestId |
string |
Identificador de la solicitud asociada al error. |
ErrorResponseDetails
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 |
Detalles del recurso relacionado con el error. |