REST Resource: folders.locations.muteConfigs

リソース: MuteConfig

ミュート構成は、検出結果の作成/更新イベントをミュートする構成を含む Cloud SCC リソースです。

JSON 表現 
{
  "name": string,
  "description": string,
  "filter": string,
  "createTime": string,
  "updateTime": string,
  "mostRecentEditor": string,
  "type": enum (MuteConfigType),
  "expiryTime": string
}
フィールド
name

string

ID。このフィールドは、構成の作成時に指定されている場合、無視されます。以下に、形式の例を示します。

  • organizations/{organization}/muteConfigs/{muteConfig} + organizations/{organization}locations/{location}//muteConfigs/{muteConfig}
  • folders/{folder}/muteConfigs/{muteConfig}
  • folders/{folder}/locations/{location}/muteConfigs/{muteConfig}
  • projects/{project}/muteConfigs/{muteConfig}
  • projects/{project}/locations/{location}/muteConfigs/{muteConfig}
description

string

ミュート構成の説明。
filter

string

必須。検出結果の作成/更新イベントに適用するフィルタを定義する式。フィルタ文字列を作成する際は、ミュート構成が作成されるスコープに注意してください。例: フィルタに project = X が含まれていても、project = Y スコープの下に作成されている場合、検出結果と一致しない可能性があります。

次のフィールドと演算子の組み合わせがサポートされています。

  • 重大度: =、:
  • カテゴリ: =、:
  • resource.name: =、:
  • resource.project_name: =、:
  • resource.project_display_name: =、:
  • resource.folders.resource_folder: =、:
  • resource.parent_name: =、:
  • resource.parent_display_name: =、:
  • resource.type: =、:
  • findingClass: =、:
  • indicator.ip_addresses: =、:
  • indicator.domains: =、:
createTime

string (Timestamp format)

出力専用。ミュート構成が作成された時刻。このフィールドはサーバーが設定します。構成の作成時に指定した場合は無視されます。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

出力専用。ミュート構成が最後に更新された時刻。このフィールドはサーバーが設定します。構成の作成時または更新時に指定された場合、無視されます。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
mostRecentEditor

string

出力専用。ミュート設定を最後に編集したユーザーのメールアドレス。このフィールドはサーバーが設定します。構成の作成時または更新時に指定された場合、無視されます。
type

enum (MuteConfigType)

必須。ミュート構成のタイプ。このタイプによって、構成が適用されるミュート状態のタイプが決まります。作成後は変更不可。
expiryTime

string (Timestamp format)

省略可。ミュート構成の有効期限。動的構成にのみ適用されます。有効期限が設定されている場合、構成が期限切れになると、すべての検出結果から削除されます。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

MuteConfigType

MuteConfig のタイプ。

列挙型
MUTE_CONFIG_TYPE_UNSPECIFIED 使用されていません。
STATIC 静的ミュート構成。今後一致する検出結果の静的ミュート状態をミュート状態に設定します。静的ミュート状態が設定されると、検出結果や構成の変更が状態に影響することはありません。
DYNAMIC 動的ミュート構成。既存と今後の一致する検出結果に適用され、動的ミュート状態を「ミュート済み」に設定します。構成が更新または削除された場合、または一致する検出結果が更新され、検出結果が構成と一致しなくなった場合、構成は検出結果から削除され、検出結果の動的ミュート状態は「ミュート解除」になることがあります（他の構成が引き続き一致する場合を除く）。

メソッド

create

 ミュート構成を作成します。

delete

 既存のミュート構成を削除します。

get

 ミュート構成を取得します。

list

 ミュート構成を一覧表示します。

patch

 ミュート構成を更新します。