Workspaces - Grant Admin Temporary Access

Servicio:

Admin

Versión de la API:

v1

Concede al administrador acceso temporal (24h) a "Mi área de trabajo" de un usuario.

Permissions

El autor de la llamada debe ser un administrador de Fabric o autenticarse mediante una entidad de servicio.

Ámbitos delegados necesarios

Tenant.ReadWrite.All

Limitaciones

Máximo de 25 solicitudes por minuto.

Identidades admitidas de Microsoft Entra

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

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

Interface

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
workspaceId	path	True	string (uuid)	El identificador del área de trabajo.

Respuestas

Nombre	Tipo	Description
200 OK		OK
429 Too Many Requests	ErrorResponse	Se superó el límite de frecuencia de servicio. El servidor devuelve un Retry-After encabezado que indica, en segundos, cuánto tiempo debe esperar el cliente antes de enviar solicitudes adicionales. Encabezados Retry-After: integer
Other Status Codes	ErrorResponse	Códigos de error comunes: EntityNotFound: el identificador del área de trabajo no existe o el área de trabajo no es "Mi área de trabajo". InsufficientScopes: el autor de la llamada no tiene permisos para llamar a la API. BadRequest: ya se ha concedido acceso al área de trabajo personal. No autorizado: solo los administradores de inquilinos y las entidades de servicio con el rol de administrador de inquilinos están autorizados para llamar a la API.

Ejemplos

Grant admin temporary access to workspace example

Solicitud de ejemplo

HTTP

POST https://api.fabric.microsoft.com/v1/admin/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/grantAdminTemporaryAccess

Respuesta de muestra

status code:

200

Definiciones

Nombre	Description
ErrorRelatedResource	Objeto de detalles del recurso relacionado con el error.
ErrorResponse	Respuesta de error.
ErrorResponseDetails	Detalles de la respuesta de error.

ErrorRelatedResource

Objeto

Objeto de detalles del recurso relacionado con el error.

Nombre	Tipo	Description
resourceId	string	ID de recurso que está involucrado en el error.
resourceType	string	Tipo del recurso implicado en el error.

ErrorResponse

Objeto

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.
isRetriable	boolean	Cuando es true, se puede reintentar la solicitud. Use el Retry-After encabezado de respuesta para determinar el retraso, si está disponible.
message	string	Representación comprensible para humanos del error.
moreDetails	ErrorResponseDetails[]	Lista de detalles de error adicionales.
relatedResource	ErrorRelatedResource	Detalles del recurso relacionado con el error.
requestId	string (uuid)	Identificador de la solicitud asociada al error.

ErrorResponseDetails

Objeto

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 comprensible para humanos del error.
relatedResource	ErrorRelatedResource	Detalles del recurso relacionado con el error.