Workspaces - Grant Admin Temporary Access

服務:
Admin
API 版本:
v1

授權管理員臨時（24小時）存取使用者的「我的工作區」。

許可

呼叫者必須是 Fabric 管理員，或透過服務主體進行認證。

必要的委派範圍

Tenant.ReadWrite.All

局限性

每分鐘最多 25 個要求。

Microsoft Entra 支援的身份識別

此 API 支援本節中列出的Microsoft 身分識別。

身分識別 Support
User Yes
服務主體 和 受控識別 Yes

Interface

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

URI 參數

名稱 位於 必要 類型 Description
workspaceId
 path True

string (uuid)

工作區識別碼。

回應

名稱 類型 Description
200 OK

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

定義

名稱 Description
ErrorRelatedResource

錯誤相關的資源詳細資料物件。
ErrorResponse

錯誤回應。
ErrorResponseDetails

錯誤回應的細節。

ErrorRelatedResource

Object

錯誤相關的資源詳細資料物件。

名稱 類型 Description
resourceId

string

發生錯誤的資源識別碼。
resourceType

string

發生錯誤的資源類型。

ErrorResponse

Object

錯誤回應。

名稱 類型 Description
errorCode

string

提供錯誤狀況相關信息的特定標識碼，允許服務與其使用者之間的標準化通訊。
isRetriable

boolean

若屬實，請求可重新嘗試。 如果有延遲，請使用 Retry-After 回應標頭來判斷延遲。
message

string

以人類可讀格式呈現的錯誤訊息。
moreDetails

ErrorResponseDetails[]

其他錯誤詳情的清單。
relatedResource

ErrorRelatedResource

與錯誤相關的資源詳情。
requestId

string (uuid)

與錯誤相關聯的要求識別碼。

ErrorResponseDetails

Object

錯誤回應的細節。

名稱 類型 Description
errorCode

string

提供錯誤狀況相關信息的特定標識碼，允許服務與其使用者之間的標準化通訊。
message

string

以人類可讀格式呈現的錯誤訊息。
relatedResource

ErrorRelatedResource

與錯誤相關的資源詳情。