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

示例请求

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

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