Domains - Unassign Domain Workspaces By Ids
注意
此 API 處於預覽狀態。
依工作區標識碼從指定的網域取消指派工作區。
權限
呼叫端必須是網狀架構系統管理員。
必要的委派範圍
Tenant.ReadWrite.All。
局限性
每個主體每分鐘最多 25 個要求。
Microsoft Entra 支援的身分識別
此 API 支援本節中列出的Microsoft 身分識別。
身份 | 支援 |
---|---|
使用者 | 是的 |
服務主體 和 受控識別 | 是的 |
介面
POST https://api.fabric.microsoft.com/v1/admin/domains/{domainId}/unassignWorkspaces
URI 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
domain
|
path | True |
string uuid |
網域標識碼。 |
要求本文
名稱 | 類型 | Description |
---|---|---|
workspacesIds |
string[] uuid |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
要求成功完成。 |
|
Other Status Codes |
常見的錯誤碼:
|
範例
Unassign domain workspaces example
範例要求
POST https://api.fabric.microsoft.com/v1/admin/domains/97dd1d38-a4c6-41ed-bc4f-1e383f8ddd0f/unassignWorkspaces
{
"workspacesIds": [
"e8de1852-7382-480a-8404-d5b1f5e1ab65",
"5348d3a9-c096-4074-9083-09e3ca69c8e5",
"ac561643-c5c5-4cf1-868e-8755a90e6fa3"
]
}
範例回覆
定義
名稱 | Description |
---|---|
Error |
錯誤相關的資源詳細資料物件。 |
Error |
錯誤回應。 |
Error |
錯誤回應詳細數據。 |
Unassign |
依工作區標識碼從網域取消指派工作區的要求承載。 |
ErrorRelatedResource
錯誤相關的資源詳細資料物件。
名稱 | 類型 | Description |
---|---|---|
resourceId |
string |
發生錯誤的資源識別碼。 |
resourceType |
string |
發生錯誤的資源類型。 |
ErrorResponse
錯誤回應。
名稱 | 類型 | Description |
---|---|---|
errorCode |
string |
提供錯誤狀況相關信息的特定標識碼,允許服務與其使用者之間的標準化通訊。 |
message |
string |
錯誤的人類可讀取表示法。 |
moreDetails |
其他錯誤詳細數據的清單。 |
|
relatedResource |
錯誤相關的資源詳細數據。 |
|
requestId |
string |
與錯誤相關聯的要求標識碼。 |
ErrorResponseDetails
錯誤回應詳細數據。
名稱 | 類型 | Description |
---|---|---|
errorCode |
string |
提供錯誤狀況相關信息的特定標識碼,允許服務與其使用者之間的標準化通訊。 |
message |
string |
錯誤的人類可讀取表示法。 |
relatedResource |
錯誤相關的資源詳細數據。 |
UnassignDomainWorkspacesByIdsRequest
依工作區標識碼從網域取消指派工作區的要求承載。
名稱 | 類型 | Description |
---|---|---|
workspacesIds |
string[] uuid |