Domains - Assign Domain Workspaces By Ids

服务:

Admin

API 版本:

v1

注意

此 API 以预览版提供。

按工作区 ID 将工作区分配到指定的域。
除非域管理租户设置阻止批量重新分配，否则将重写预先存在的域分配。

权限

调用方必须是 Fabric 管理员。

所需的委派范围

Tenant.ReadWrite.All。

局限性

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

Microsoft Entra 支持的标识

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

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

接口

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

URI 参数

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

请求正文

名称	类型	说明
workspacesIds	string[] (uuid)	将分配给该域的工作区 ID。

响应

名称	类型	说明
200 OK		请求成功完成。
Other Status Codes	ErrorResponse	常见错误代码： UnknownError - 发生错误。

示例

Assign domain workspaces example

示例请求

HTTP

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

{
  "workspacesIds": [
    "e8de1852-7382-480a-8404-d5b1f5e1ab65",
    "5348d3a9-c096-4074-9083-09e3ca69c8e5",
    "ac561643-c5c5-4cf1-868e-8755a90e6fa3"
  ]
}

示例响应

状态代码:

200

定义

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

AssignDomainWorkspacesByIdsRequest

Object

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

名称	类型	说明
workspacesIds	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	与错误相关的资源详细信息。