このページのトピック

オーバーライドパラメータについて

多くのAPI操作では、応答に対象リソース(オーバーライド= true), )に設定されているオーバーライドのみが含まれるか、またはリソースが継承するすべての実効プロパティ -- オーバーライドとプロパティ値が含まれるかどうか(オーバーライド= false)を制御する overrides パラメータが定義されます。

たとえば、 ポリシーの記述ポリシー のポリシーエンドポイントの操作によって、特定のポリシーのポリシーオブジェクトが次の場所に返されます。Workload Security。このエンドポイントは、対象ポリシーに対して返されるプロパティ値を決定する overrides パラメータを定義します。

  • overrides = false: 戻されたポリシーオブジェクトには、親ポリシーから継承されたプロパティ値と、ポリシーがオーバーライドするプロパティ値が含まれます。
  • overrides = true: 返されるポリシーオブジェクトには、ポリシーでオーバーライドされるプロパティのみが含まれます。

リソースを作成または変更する操作の場合、 overrides パラメータは、応答に含まれる作成済みオブジェクトまたは変更されたオブジェクトに適用されます。たとえば、 ポリシーの作成 操作を使用して、基本ポリシーを親として持つポリシーを作成し、 アプリケーションコントロール モジュールをオンにします。

  • overrides = false: 応答には、基本ポリシーポリシーのすべてのプロパティ値と、 アプリケーションコントロール ステータス値onが設定されたポリシーオブジェクトが含まれます。
  • overrides = true: 応答には、 アプリケーションコントロール ステータス値onのみを含むポリシーオブジェクトが含まれています。

overrides パラメータは、リソースを検索またはリストする操作の場合、返されるリソースと、含まれるプロパティ値を決定します。たとえば、ポリシーエンドポイントの List 侵入防御 ルールID 操作では、 overrides パラメータが定義されます。

  • overrides = false: 返されるリストには、対象ポリシーおよび上位ポリシーに割り当てられているすべての 侵入防御 ルールが含まれます。すべてのルールプロパティが含まれます。
  • overrides = true: 返されるリストには、対象ポリシーでオーバーライドされるプロパティを持つルールのみが含まれます。さらに、ルールにはオーバーライドされるプロパティのみが含まれます。

オーバーライドを確認する例については、 を参照してください。例:コンピュータのオーバーライドを取得します。