Domains - Assign Domain Workspaces By Capacities

服務:

Admin

API 版本:

v1

注意

此 API 處於預覽狀態。

將位於指定容量上的所有工作區指派給指定的網域。
除非網域管理租使用者設定封鎖大量重新指派，否則將會覆寫預先存在的網域指派。

此 API 支援 長時間執行的作業 （LRO）。

權限

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

必要的委派範圍

Tenant.ReadWrite.All。

局限性

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

Microsoft Entra 支援的身分識別

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

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

介面

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

URI 參數

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

要求本文

名稱	類型	Description
capacitiesIds	string[] uuid	容量標識碼。

回應

名稱	類型	Description
202 Accepted		作業正在進行中。 標題 Location: string Retry-After: integer x-ms-operation-id: string
Other Status Codes	ErrorResponse	常見的錯誤碼： UnknownError - 發生錯誤。

範例

Assign domain workspaces by capacities example

範例要求

HTTP

POST https://api.fabric.microsoft.com/v1/admin/domains/97dd1d38-a4c6-41ed-bc4f-1e383f8ddd0f/assignWorkspacesByCapacities

{
  "capacitiesIds": [
    "796ce6ad-9163-4c16-9559-c68192a251de"
  ]
}

範例回覆

狀態碼:

202

Location: https://api.fabric.microsoft.com/operations/cfafbeb1-8037-4d0c-896e-a46fb27ff227
x-ms-operation-id: cfafbeb1-8037-4d0c-896e-a46fb27ff227
Retry-After: 30

定義

名稱	Description
AssignDomainWorkspacesByCapacitiesRequest	依容量將工作區指派給網域的要求承載。
ErrorRelatedResource	錯誤相關的資源詳細資料物件。
ErrorResponse	錯誤回應。
ErrorResponseDetails	錯誤回應詳細數據。

AssignDomainWorkspacesByCapacitiesRequest

Object

依容量將工作區指派給網域的要求承載。

名稱	類型	Description
capacitiesIds	string[] uuid	容量標識碼。

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	錯誤相關的資源詳細數據。