Domains - Assign Domain Workspaces By Capacities

服务:

Admin

API 版本:

v1

注意

此 API 以预览版提供。

将驻留在指定容量上的所有工作区分配给指定域。
除非域管理租户设置阻止批量重新分配，否则将重写预先存在的域分配。

此 API 支持 长时间运行的作（LRO）。

权限

调用方必须是 Fabric 管理员。

所需的委派范围

Tenant.ReadWrite.All。

局限性

每个主体每分钟最多 10 个请求。

Microsoft Entra 支持的标识

此 API 支持本节中列出的Microsoft 标识。

身份	支持
用户	是的
服务主体 和 托管标识	是的

接口

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

URI 参数

名称	在	必需	类型	说明
domainId	path	True	string uuid	域 ID。

请求正文

名称	类型	说明
capacitiesIds	string[] uuid	容量 ID。

响应

名称	类型	说明
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

定义

名称	说明
AssignDomainWorkspacesByCapacitiesRequest	按容量将工作区分配到域的请求有效负载。
ErrorRelatedResource	与错误相关的资源详细信息对象。
ErrorResponse	错误响应。
ErrorResponseDetails	错误响应详细信息。

AssignDomainWorkspacesByCapacitiesRequest

Object

按容量将工作区分配到域的请求有效负载。

名称	类型	说明
capacitiesIds	string[] uuid	容量 ID。

ErrorRelatedResource

Object

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

名称	类型	说明
resourceId	string	错误中涉及的资源 ID。
resourceType	string	错误中涉及的资源的类型。

ErrorResponse

Object

错误响应。

名称	类型	说明
errorCode	string	提供有关错误条件的信息的特定标识符，允许服务与其用户之间的标准化通信。
message	string	错误的人工可读表示形式。
moreDetails	ErrorResponseDetails[]	其他错误详细信息的列表。
relatedResource	ErrorRelatedResource	与错误相关的资源详细信息。
requestId	string	与错误关联的请求的 ID。

ErrorResponseDetails

Object

错误响应详细信息。

名称	类型	说明
errorCode	string	提供有关错误条件的信息的特定标识符，允许服务与其用户之间的标准化通信。
message	string	错误的人工可读表示形式。
relatedResource	ErrorRelatedResource	与错误相关的资源详细信息。