Workspaces - Grant Admin Temporary Access

服务:

Admin

API 版本:

v1

授予管理员对用户的“我的工作区”的临时（24 小时）访问权限。

Permissions

调用方必须是Fabric管理员或使用服务主体进行身份验证。

所需的委派范围

Tenant.ReadWrite.All

局限性

每分钟最多 25 个请求。

Microsoft Entra 支持的标识

此 API 支持本节中列出的Microsoft 标识。

身份	Support
用户	是的
服务主体和托管标识	是的

Interface

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

URI 参数

名称	在	必需	类型	说明
workspaceId	path	True	string (uuid)	工作区 ID。

响应

名称	类型	说明
200 OK		好的
429 Too Many Requests	ErrorResponse	超出服务速率限制。 服务器返回一个 Retry-After 标头，指示客户端在发送其他请求之前必须等待的时间（以秒为单位）。 标头 Retry-After: integer
Other Status Codes	ErrorResponse	常见错误代码： EntityNotFound - 工作区 ID 不存在或工作区不是“我的工作区”。 InsufficientScopes - 调用方无权调用 API。 BadRequest - 已授予对个人工作区的访问权限。 未授权 - 只有具有租户管理员角色的租户管理员和服务主体才有权调用 API。

示例

Grant admin temporary access to workspace example

示例请求

HTTP

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

示例响应

状态代码:

200

定义

名称	说明
ErrorRelatedResource	与错误相关的资源详细信息对象。
ErrorResponse	错误响应。
ErrorResponseDetails	错误响应详细信息。

ErrorRelatedResource

对象

与错误相关的资源详细信息对象。

名称	类型	说明
resourceId	string	错误中涉及的资源 ID。
resourceType	string	错误中涉及的资源的类型。

ErrorResponse

对象

错误响应。

名称	类型	说明
errorCode	string	提供有关错误条件的信息的特定标识符，允许服务与其用户之间的标准化通信。
isRetriable	boolean	如果为 true，可以重试请求。 Retry-After使用响应标头确定延迟（如果可用）。
message	string	错误的人工可读表示形式。
moreDetails	ErrorResponseDetails[]	其他错误详细信息的列表。
relatedResource	ErrorRelatedResource	与错误相关的资源详细信息。
requestId	string (uuid)	与错误关联的请求的 ID。

ErrorResponseDetails

对象

错误响应详细信息。

名称	类型	说明
errorCode	string	提供有关错误条件的信息的特定标识符，允许服务与其用户之间的标准化通信。
message	string	错误的人工可读表示形式。
relatedResource	ErrorRelatedResource	与错误相关的资源详细信息。