Domains - Create Domain
注意
此 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 |
已成功建立網域。 |
|
Other Status Codes |
常見的錯誤碼:
|
範例
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"
}
範例回覆
{
"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 |
---|---|
Contributors |
參與者範圍。 可能會隨著時間新增其他參與者範圍。 |
Create |
建立網域或子域的要求承載。 |
Domain |
表示網域或子域。 |
Error |
錯誤相關的資源詳細資料物件。 |
Error |
錯誤回應。 |
Error |
錯誤回應詳細數據。 |
ContributorsScopeType
參與者範圍。 可能會隨著時間新增其他參與者範圍。
值 | Description |
---|---|
AdminsOnly |
僅限租用戶和網域系統管理員。 |
AllTenant |
所有租用戶的使用者。 |
SpecificUsersAndGroups |
特定使用者和群組。 |
CreateDomainRequest
建立網域或子域的要求承載。
名稱 | 類型 | Description |
---|---|---|
description |
string |
網域描述。 描述不能包含超過 256 個字元。 |
displayName |
string |
網域顯示名稱。 顯示名稱不能包含超過 40 個字元。 |
parentDomainId |
string uuid |
網域父物件標識碼。 |
Domain
表示網域或子域。
名稱 | 類型 | Description |
---|---|---|
contributorsScope |
網域參與者範圍。 |
|
description |
string |
網域的描述。 |
displayName |
string |
功能變數名稱。 |
id |
string uuid |
網域對象識別碼。 |
parentDomainId |
string uuid |
網域父物件標識碼。 |
ErrorRelatedResource
錯誤相關的資源詳細資料物件。
名稱 | 類型 | Description |
---|---|---|
resourceId |
string |
發生錯誤的資源識別碼。 |
resourceType |
string |
發生錯誤的資源類型。 |
ErrorResponse
錯誤回應。
名稱 | 類型 | Description |
---|---|---|
errorCode |
string |
提供錯誤狀況相關信息的特定標識碼,允許服務與其使用者之間的標準化通訊。 |
message |
string |
錯誤的人類可讀取表示法。 |
moreDetails |
其他錯誤詳細數據的清單。 |
|
relatedResource |
錯誤相關的資源詳細數據。 |
|
requestId |
string |
與錯誤相關聯的要求標識碼。 |
ErrorResponseDetails
錯誤回應詳細數據。
名稱 | 類型 | Description |
---|---|---|
errorCode |
string |
提供錯誤狀況相關信息的特定標識碼,允許服務與其使用者之間的標準化通訊。 |
message |
string |
錯誤的人類可讀取表示法。 |
relatedResource |
錯誤相關的資源詳細數據。 |