通过

Domains - Create Domain

  • 参考
服务:
Admin
API 版本:
v1

注意

此 API 以预览版提供。

创建新域。

权限

调用方必须是 Fabric 管理员。

所需的委派范围

Tenant.ReadWrite.All。

局限性

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

Microsoft Entra 支持的标识

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

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

接口

POST https://api.fabric.microsoft.com/v1/admin/domains

请求正文

名称 必需 类型 说明
displayName True

string

域显示名称。 显示名称不能包含超过 40 个字符。
description

string

域说明。 说明不能包含超过 256 个字符。
parentDomainId

string

uuid

域父对象 ID。

响应

名称 类型 说明
201 Created

Domain

已成功创建域。
Other Status Codes

ErrorResponse

常见错误代码：

  • EntityNotFound - 创建域失败，因为找不到父域 ID。

  • EntityConflict - 由于域显示名称已存在，因此创建域失败。

  • InvalidInput - 父域 ID 无效。

示例

Create a domain example

示例请求

POST https://api.fabric.microsoft.com/v1/admin/domains

{
  "displayName": "Finance",
  "description": "This domain is used for identifying financial data and reports.",
  "parentDomainId": "5f6552c3-816c-43e7-8289-842f8b35f9df"
}

示例响应

状态代码:
201 
{
  "id": "9eba6944-daff-4441-b9b5-630ce34238fd",
  "displayName": "Finance",
  "description": "This domain is used for identifying financial data and reports.",
  "parentDomainId": "5f6552c3-816c-43e7-8289-842f8b35f9df",
  "contributorsScope": "AllTenant"
}

定义

名称 说明
ContributorsScopeType

参与者范围。 可能会随着时间的推移添加其他参与者范围。
CreateDomainRequest

用于创建域或子域的请求有效负载。
Domain

表示域或子域。
ErrorRelatedResource

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

错误响应。
ErrorResponseDetails

错误响应详细信息。

ContributorsScopeType

Enumeration

参与者范围。 可能会随着时间的推移添加其他参与者范围。

值 说明
AdminsOnly

仅租户和域管理员。
AllTenant

租户的所有用户。
SpecificUsersAndGroups

特定用户和组。

CreateDomainRequest

Object

用于创建域或子域的请求有效负载。

名称 类型 说明
description

string

域说明。 说明不能包含超过 256 个字符。
displayName

string

域显示名称。 显示名称不能包含超过 40 个字符。
parentDomainId

string

uuid

域父对象 ID。

Domain

Object

表示域或子域。

名称 类型 说明
contributorsScope

ContributorsScopeType

域参与者范围。
description

string

域的说明。
displayName

string

域的名称。
id

string

uuid

域对象 ID。
parentDomainId

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

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