Domains - Create Domain
手記
この API はプレビュー段階です。
新しいドメインを作成します。
権限
呼び出し元は Fabric 管理者である必要があります。
必要な委任されたスコープ
Tenant.ReadWrite.All。
制限
プリンシパルあたり 1 分あたり最大 25 個の要求。
Microsoft Entra でサポートされている ID
この API では、このセクションに記載されている Microsoft ID がサポートされています。
同一性 | 支える |
---|---|
利用者 | はい |
サービス プリンシパルの とマネージド ID の | はい |
インターフェイス
POST https://api.fabric.microsoft.com/v1/admin/domains
要求本文
名前 | 必須 | 型 | 説明 |
---|---|---|---|
displayName | True |
string |
ドメインの表示名。 表示名には 40 文字を超えることはできません。 |
description |
string |
ドメインの説明。 説明には、256 文字を超える文字を含めることはできません。 |
|
parentDomainId |
string uuid |
ドメイン親オブジェクト ID。 |
応答
名前 | 型 | 説明 |
---|---|---|
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"
}
定義
名前 | 説明 |
---|---|
Contributors |
共同作成者スコープ。 追加の共同作成者スコープは、時間の経過と同時に追加される場合があります。 |
Create |
ドメインまたはサブドメインを作成するための要求ペイロード。 |
Domain |
ドメインまたはサブドメインを表します。 |
Error |
エラー関連のリソース詳細オブジェクト。 |
Error |
エラー応答。 |
Error |
エラー応答の詳細。 |
ContributorsScopeType
共同作成者スコープ。 追加の共同作成者スコープは、時間の経過と同時に追加される場合があります。
値 | 説明 |
---|---|
AdminsOnly |
テナント管理者とドメイン管理者のみ。 |
AllTenant |
テナントのすべてのユーザー。 |
SpecificUsersAndGroups |
特定のユーザーとグループ。 |
CreateDomainRequest
ドメインまたはサブドメインを作成するための要求ペイロード。
名前 | 型 | 説明 |
---|---|---|
description |
string |
ドメインの説明。 説明には、256 文字を超える文字を含めることはできません。 |
displayName |
string |
ドメインの表示名。 表示名には 40 文字を超えることはできません。 |
parentDomainId |
string uuid |
ドメイン親オブジェクト ID。 |
Domain
ドメインまたはサブドメインを表します。
名前 | 型 | 説明 |
---|---|---|
contributorsScope |
ドメイン共同作成者のスコープ。 |
|
description |
string |
ドメインの説明。 |
displayName |
string |
ドメインの名前。 |
id |
string uuid |
ドメイン オブジェクト ID。 |
parentDomainId |
string uuid |
ドメイン親オブジェクト ID。 |
ErrorRelatedResource
エラー関連のリソース詳細オブジェクト。
名前 | 型 | 説明 |
---|---|---|
resourceId |
string |
エラーに関係するリソース ID。 |
resourceType |
string |
エラーに関係するリソースの種類。 |
ErrorResponse
エラー応答。
名前 | 型 | 説明 |
---|---|---|
errorCode |
string |
エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。 |
message |
string |
エラーの人間が判読できる表現。 |
moreDetails |
その他のエラーの詳細の一覧。 |
|
relatedResource |
エラー関連のリソースの詳細。 |
|
requestId |
string |
エラーに関連付けられている要求の ID。 |
ErrorResponseDetails
エラー応答の詳細。
名前 | 型 | 説明 |
---|---|---|
errorCode |
string |
エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。 |
message |
string |
エラーの人間が判読できる表現。 |
relatedResource |
エラー関連のリソースの詳細。 |