resourcePolicyAssignment リソースの種類

名前空間: 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"
  }
}