目次
このページのトピック

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

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

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

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

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

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

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

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

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