名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
パラメーター値や適用設定など、リソース ポリシー定義バージョンのスコープへの割り当てを表します。
割り当ては、 assignedPolicy を通じて特定の定義バージョンを対象とします。 割り当てを別のバージョンに移動するには、policyDefinitionReference 値の assignedPolicy.version を更新します。 サービスは、参照されている定義の paramsSchema に対してパラメーターを検証します。
割り当ての既定値は doNotEnforce です。 ポリシーでは、強制が無効になっている場合、要求をブロックせずに deny を報告できます。
課題の応答には、 @odata.etag 注釈が含まれます。 更新の場合は、現在の割り当てを取得し、その値を If-Match 要求ヘッダーに指定します。 古い ETag により 412 Precondition Failed が発生します。再試行する前に最新の割り当てを取得してください。
UPSERT では、Prefer: create-if-missing を使用して課題を作成または更新します。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| List | resourcePolicyAssignment コレクション | ポリシーの割り当てを一覧表示します。 |
| Create | resourcePolicyAssignment | ポリシー定義バージョンを割り当てます。 |
| Get | resourcePolicyAssignment | アクティブまたは削除済みの課題を読み取ります。 |
| Update | なし | 課題を更新します。 |
| Upsert | resourcePolicyAssignment | 課題を作成するか、応答本文が存在する場合は応答本文なしで更新します。 |
| Delete | なし | アクティブな課題を削除します。 |
| 完全に削除 | なし | 課題を完全に削除します。 |
| 復元 | resourcePolicyAssignment | 削除された割り当てを復元します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| assignedPolicy | assignedPolicyReference | 割り当てるポリシー定義とバージョンへの参照。
policyDefinitionReference とその@odata.type識別子を指定します。 |
| createdDateTime | DateTimeOffset | オブジェクトが作成された日時 (ISO 8601 形式と UTC)。 読み取り専用です。
$filter (le、gt) をサポートします。 |
| deletedDateTime | DateTimeOffset | オブジェクトが削除された日時 (ISO 8601 形式および UTC)。 アクティブなオブジェクトの場合は Null。 読み取り専用です。 |
| enforcementMode | enforcementMode | 割り当ての効果を適用するかどうかを制御します。
doNotEnforce既定では、効果を適用せずに結果が評価され、記録されます。
enforce 効果を適用します。 使用可能な値: doNotEnforce、enforce、unknownFutureValue。 |
| isEnabled | ブール値 | 割り当てが評価されるかどうかを示します。 既定値は true です。
$filter (eq)をサポートしています。 |
| lastModifiedDateTime | DateTimeOffset | オブジェクトが最後に変更された日時 (ISO 8601 形式と UTC)。 読み取り専用。
$filter (le、gt) をサポートします。 |
| params | Json | 割り当ての JSON パラメーター値。 値は、参照先定義の paramsSchema に対して検証されます。宣言された既定値が適用されます。 |
| scope | 文字列 | 割り当てのスコープ。 現在、サポートされているのはテナント全体のスコープ (/) のみです。 既定値は / です。 |
| uniqueName | String | ユーザーが指定した不変の一意の名前と主キー。 作成時に必須です。 ASCII 文字で始まり、ASCII 文字、数字、または下線のみで構成され、最大 128 文字である必要があります。 プレフィックス microsoft と ms ( msft を含む) は、大文字と小文字に関係なく予約されます。 これは割り当ての名前であり、参照先の定義の名前ではありません。 |
リレーションシップ
なし。
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.resourcePolicyAssignment",
"uniqueName": "String (identifier)",
"isEnabled": "Boolean",
"scope": "String",
"enforcementMode": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"deletedDateTime": "String (timestamp)",
"assignedPolicy": {
"@odata.type": "microsoft.graph.assignedPolicyReference"
},
"params": {
"@odata.type": "microsoft.graph.Json"
}
}