重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
各 RBAC プロバイダーからカスタマイズされた RBAC スコープ オブジェクトを表します。 このリソースは appScope のサブタイプであり、特定のアプリケーションによって定義および理解されるスコープです。 カスタム アプリ スコープには、さまざまな RBAC プロバイダーにわたるロール割り当てオブジェクトの独自のライフサイクルがあります。 カスタム アプリ スコープには、さまざまな RBAC プロバイダーから提供されたカスタム属性を格納することもできます。
たとえば、Exchange Online プロバイダーでは、customAppScope は、Exchange 管理者が個別に管理できる管理ロール スコープにマップされます。 customAppScope エンティティの CRUD 操作がサポートされています。 customAppScope の ID を unifiedRoleAssignment の appScopeId として使用できます。
次のプロバイダーがサポートされています。
- Exchange Online RBAC プロバイダー
- Microsoft Defender XDR 統合 RBAC プロバイダー
appScope から継承します。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| Exchange Online および Defender の一覧 | customAppScope コレクション | Exchange Online または Defender RBAC プロバイダーの customAppScope オブジェクトの一覧を取得します。 |
| Defender の一覧 | customAppScope コレクション | Defender RBAC プロバイダーの customAppScope オブジェクトの一覧を取得します。 |
| Exchange Online 用の作成 | customAppScope | RBAC プロバイダーの新しい customAppScope オブジェクトを作成します。 |
| Exchange Online の取得 | customAppScope | RBAC プロバイダーの customAppScope オブジェクトのプロパティを取得します。 |
| Exchange Online の更新プログラム | なし | RBAC プロバイダーの既存の customAppScope オブジェクトを更新します。 |
| Exchange Online の削除 | なし | RBAC プロバイダーの customAppScope オブジェクトを削除します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| customAttributes | customAppScopeAttributesDictionary | スコープ オブジェクトのワークロード固有のプロパティを保持するオープン ディクショナリ型。 |
| displayName | 文字列 | アプリ スコープによって表されるアプリ固有のリソースの表示名。 appScopeId は不変で人間が判読できない ID であることが多いため、表示目的で提供されています。 読み取り専用です。 appScope から継承されます。 |
| id | 文字列 | 割り当ての範囲を表すアプリ固有のコンテナーまたはリソースの一意識別子。 通常は、リソースの不変 ID。 割り当てのスコープによって、プリンシパルにアクセス権が付与されているリソースのセットが決まります。 必須です。 appScope から継承されます。 |
| type | String | アプリ スコープによって表されるアプリ固有のリソースの種類。 表示目的で提供されているため、ユーザー インターフェイスは、アプリ スコープによって表されるアプリ固有のリソースの種類をユーザーに伝えることができます。 読み取り専用です。 appScope から継承されます。 |
リレーションシップ
なし。
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"customAttributes": {
"@odata.type": "microsoft.graph.customAppScopeAttributesDictionary"
},
"displayName": "String",
"id": "String (identifier)",
"type": "String"
}