Domains - Assign Domain Workspaces By Principals

リファレンス

サービス:: Admin

API バージョン:: v1

手記

この API はプレビュー段階です。

指定したドメインにワークスペースを割り当てます。指定したプリンシパルの 1 つがワークスペースの管理者権限を持っている場合です。
ドメイン管理テナントの設定によって一括再割り当てがブロックされない限り、既存のドメイン割り当てはオーバーライドされます。

この API は、実行時間の長い操作 (LRO)をサポートします。

権限

呼び出し元は Fabric 管理者である必要があります。

必要な委任されたスコープ

Tenant.ReadWrite.All。

制限

プリンシパルごとに 1 分あたり最大 10 個の要求。

Microsoft Entra でサポートされている ID

この API では、このセクションに記載されている Microsoft ID がサポートされています。

同一性	支える
利用者	はい
サービスプリンシパルのとマネージド ID の	はい

インターフェイス

POST https://api.fabric.microsoft.com/v1/admin/domains/{domainId}/assignWorkspacesByPrincipals

URI パラメーター

名前	/	必須	型	説明
domainId	path	True	string uuid	ドメイン ID。

要求本文

名前	型	説明
principals	Principal[]	ID または Microsoft Entra グループを表します。

応答

名前	型	説明
202 Accepted		操作が進行中ですヘッダー Location: string Retry-After: integer x-ms-operation-id: string
Other Status Codes	ErrorResponse	一般的なエラーコード: UnknownError - エラーが発生しました。

名前

型

説明

202 Accepted

操作が進行中です

ヘッダー

Location: string
Retry-After: integer
x-ms-operation-id: string

Other Status Codes

ErrorResponse

一般的なエラーコード:

UnknownError - エラーが発生しました。

例

Assign domain workspaces example

要求のサンプル

HTTP

POST https://api.fabric.microsoft.com/v1/admin/domains/97dd1d38-a4c6-41ed-bc4f-1e383f8ddd0f/assignWorkspacesByPrincipals

{
  "principals": [
    {
      "id": "796ce6ad-9163-4c16-9559-c68192a251de",
      "type": "User"
    }
  ]
}

応答のサンプル

状態コード:: 202

Location: https://api.fabric.microsoft.com/operations/cfafbeb1-8037-4d0c-896e-a46fb27ff227
x-ms-operation-id: cfafbeb1-8037-4d0c-896e-a46fb27ff227
Retry-After: 30

定義

名前	説明
AssignDomainWorkspacesByPrincipalsRequest	プリンシパルによってドメインにワークスペースを割り当てるための要求ペイロード。
ErrorRelatedResource	エラー関連のリソース詳細オブジェクト。
ErrorResponse	エラー応答。
ErrorResponseDetails	エラー応答の詳細。
GroupDetails	グループ固有の詳細。プリンシパルの種類が `Group`場合に適用されます。
GroupType	グループの種類。グループの種類は、時間の経過と同時に追加される場合があります。
Principal	ID または Microsoft Entra グループを表します。
PrincipalType	プリンシパルの型。プリンシパルの種類は、時間の経過と同時に追加される場合があります。
ServicePrincipalDetails	サービスプリンシパル固有の詳細。プリンシパルの種類が `ServicePrincipal`場合に適用されます。
ServicePrincipalProfileDetails	サービスプリンシパルプロファイルの詳細。プリンシパルの種類が `ServicePrincipalProfile`場合に適用されます。
UserDetails	ユーザープリンシパル固有の詳細。プリンシパルの種類が `User`場合に適用されます。

AssignDomainWorkspacesByPrincipalsRequest

Object

プリンシパルによってドメインにワークスペースを割り当てるための要求ペイロード。

名前	型	説明
principals	Principal[]	ID または Microsoft Entra グループを表します。

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	エラー関連のリソースの詳細。

GroupDetails

Object

グループ固有の詳細。プリンシパルの種類が Group場合に適用されます。

名前	型	説明
groupType	GroupType	グループの種類。グループの種類は、時間の経過と同時に追加される場合があります。

GroupType

列挙

グループの種類。グループの種類は、時間の経過と同時に追加される場合があります。

値	説明
DistributionList	プリンシパルは配布リストです。
SecurityGroup	プリンシパルはセキュリティグループです。
Unknown	プリンシパルグループの種類が不明です。

Principal

Object

ID または Microsoft Entra グループを表します。

名前	型	説明
displayName	string	プリンシパルの表示名。
groupDetails	GroupDetails	グループ固有の詳細。プリンシパルの種類が `Group`場合に適用されます。
id	string uuid	プリンシパルの ID。
servicePrincipalDetails	ServicePrincipalDetails	サービスプリンシパル固有の詳細。プリンシパルの種類が `ServicePrincipal`場合に適用されます。
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	サービスプリンシパルプロファイルの詳細。プリンシパルの種類が `ServicePrincipalProfile`場合に適用されます。
type	PrincipalType	プリンシパルの型。プリンシパルの種類は、時間の経過と同時に追加される場合があります。
userDetails	UserDetails	ユーザープリンシパル固有の詳細。プリンシパルの種類が `User`場合に適用されます。

PrincipalType

列挙

プリンシパルの型。プリンシパルの種類は、時間の経過と同時に追加される場合があります。

値	説明
Group	プリンシパルはセキュリティグループです。
ServicePrincipal	プリンシパルは Microsoft Entra サービスプリンシパルです。
ServicePrincipalProfile	プリンシパルはサービスプリンシパルプロファイルです。
User	プリンシパルは Microsoft Entra ユーザープリンシパルです。

ServicePrincipalDetails

Object

サービスプリンシパル固有の詳細。プリンシパルの種類が ServicePrincipal場合に適用されます。

名前	型	説明
aadAppId	string uuid	サービスプリンシパルの Microsoft Entra AppId。

ServicePrincipalProfileDetails

Object

サービスプリンシパルプロファイルの詳細。プリンシパルの種類が ServicePrincipalProfile場合に適用されます。

名前	型	説明
parentPrincipal	Principal	サービスプリンシパルプロファイルの親プリンシパル。

UserDetails

Object

ユーザープリンシパル固有の詳細。プリンシパルの種類が User場合に適用されます。

名前	型	説明
userPrincipalName	string	ユーザープリンシパル名。

次の方法で共有

Domains - Assign Domain Workspaces By Principals

権限

必要な委任されたスコープ

制限

Microsoft Entra でサポートされている ID

インターフェイス

URI パラメーター

要求本文

応答

例

Assign domain workspaces example

要求のサンプル

応答のサンプル

定義

AssignDomainWorkspacesByPrincipalsRequest

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

GroupDetails

GroupType

Principal

PrincipalType

ServicePrincipalDetails

ServicePrincipalProfileDetails

UserDetails

その他のリソース