Domains - Unassign Domain Workspaces By Ids

服務:

Admin

API 版本:

v1

注意

此 API 處於預覽狀態。

依工作區標識碼從指定的網域取消指派工作區。

權限

呼叫端必須是網狀架構系統管理員。

必要的委派範圍

Tenant.ReadWrite.All。

局限性

每個主體每分鐘最多 25 個要求。

Microsoft Entra 支援的身分識別

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

身份	支援
使用者	是的
服務主體 和 受控識別	是的

介面

POST https://api.fabric.microsoft.com/v1/admin/domains/{domainId}/unassignWorkspaces

URI 參數

名稱	位於	必要	類型	Description
domainId	path	True	string uuid	網域標識碼。

要求本文

名稱	類型	Description
workspacesIds	string[] uuid

回應

名稱	類型	Description
200 OK		要求成功完成。
Other Status Codes	ErrorResponse	常見的錯誤碼： UnknownError - 發生錯誤。

範例

Unassign domain workspaces example

範例要求

HTTP

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"
  ]
}

範例回覆

狀態碼:

200

定義

名稱	Description
ErrorRelatedResource	錯誤相關的資源詳細資料物件。
ErrorResponse	錯誤回應。
ErrorResponseDetails	錯誤回應詳細數據。
UnassignDomainWorkspacesByIdsRequest	依工作區標識碼從網域取消指派工作區的要求承載。

ErrorRelatedResource

Object

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

名稱	類型	Description
resourceId	string	發生錯誤的資源識別碼。
resourceType	string	發生錯誤的資源類型。

ErrorResponse

Object

錯誤回應。

名稱	類型	Description
errorCode	string	提供錯誤狀況相關信息的特定標識碼，允許服務與其使用者之間的標準化通訊。
message	string	錯誤的人類可讀取表示法。
moreDetails	ErrorResponseDetails[]	其他錯誤詳細數據的清單。
relatedResource	ErrorRelatedResource	錯誤相關的資源詳細數據。
requestId	string	與錯誤相關聯的要求標識碼。

ErrorResponseDetails

Object

錯誤回應詳細數據。

名稱	類型	Description
errorCode	string	提供錯誤狀況相關信息的特定標識碼，允許服務與其使用者之間的標準化通訊。
message	string	錯誤的人類可讀取表示法。
relatedResource	ErrorRelatedResource	錯誤相關的資源詳細數據。

UnassignDomainWorkspacesByIdsRequest

Object

依工作區標識碼從網域取消指派工作區的要求承載。

名稱	類型	Description
workspacesIds	string[] uuid