共用方式為

Domains - Create Domain

  • 參考
服務:
Admin
API 版本:
v1

注意

此 API 處於預覽狀態。

建立新的網域。

權限

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

必要的委派範圍

Tenant.ReadWrite.All。

局限性

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

Microsoft Entra 支援的身分識別

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

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

介面

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

要求本文

名稱 必要 類型 Description
displayName True

string

網域顯示名稱。 顯示名稱不能包含超過 40 個字元。
description

string

網域描述。 描述不能包含超過 256 個字元。
parentDomainId

string

uuid

網域父物件標識碼。

回應

名稱 類型 Description
201 Created

Domain

已成功建立網域。
Other Status Codes

ErrorResponse

常見的錯誤碼：

  • EntityNotFound - 建立網域失敗，因為找不到父域標識符。

  • EntityConflict - 建立網域失敗，因為網域顯示名稱已經存在。

  • InvalidInput - 父域標識符無效。

範例

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

定義

名稱 Description
ContributorsScopeType

參與者範圍。 可能會隨著時間新增其他參與者範圍。
CreateDomainRequest

建立網域或子域的要求承載。
Domain

表示網域或子域。
ErrorRelatedResource

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

錯誤回應。
ErrorResponseDetails

錯誤回應詳細數據。

ContributorsScopeType

Enumeration

參與者範圍。 可能會隨著時間新增其他參與者範圍。

值 Description
AdminsOnly

僅限租用戶和網域系統管理員。
AllTenant

所有租用戶的使用者。
SpecificUsersAndGroups

特定使用者和群組。

CreateDomainRequest

Object

建立網域或子域的要求承載。

名稱 類型 Description
description

string

網域描述。 描述不能包含超過 256 個字元。
displayName

string

網域顯示名稱。 顯示名稱不能包含超過 40 個字元。
parentDomainId

string

uuid

網域父物件標識碼。

Domain

Object

表示網域或子域。

名稱 類型 Description
contributorsScope

ContributorsScopeType

網域參與者範圍。
description

string

網域的描述。
displayName

string

功能變數名稱。
id

string

uuid

網域對象識別碼。
parentDomainId

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

錯誤相關的資源詳細數據。