次の方法で共有


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

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

応答のサンプル

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

ドメインまたはサブドメインを作成するための要求ペイロード。

名前 説明
description

string

ドメインの説明。 説明には、256 文字を超える文字を含めることはできません。

displayName

string

ドメインの表示名。 表示名には 40 文字を超えることはできません。

parentDomainId

string

uuid

ドメイン親オブジェクト ID。

Domain

ドメインまたはサブドメインを表します。

名前 説明
contributorsScope

ContributorsScopeType

ドメイン共同作成者のスコープ。

description

string

ドメインの説明。

displayName

string

ドメインの名前。

id

string

uuid

ドメイン オブジェクト ID。

parentDomainId

string

uuid

ドメイン親オブジェクト ID。

ErrorRelatedResource

エラー関連のリソース詳細オブジェクト。

名前 説明
resourceId

string

エラーに関係するリソース ID。

resourceType

string

エラーに関係するリソースの種類。

ErrorResponse

エラー応答。

名前 説明
errorCode

string

エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。

message

string

エラーの人間が判読できる表現。

moreDetails

ErrorResponseDetails[]

その他のエラーの詳細の一覧。

relatedResource

ErrorRelatedResource

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

requestId

string

エラーに関連付けられている要求の ID。

ErrorResponseDetails

エラー応答の詳細。

名前 説明
errorCode

string

エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。

message

string

エラーの人間が判読できる表現。

relatedResource

ErrorRelatedResource

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