次の方法で共有

Domains - Create Domain

  • リファレンス
サービス:
Admin
API バージョン:
v1

手記

この 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

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

列挙

共同作成者スコープ。 追加の共同作成者スコープは、時間の経過と同時に追加される場合があります。

値 説明
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

エラー関連のリソースの詳細。