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

标识符。如果在创建配置时提供此字段，系统会忽略此字段。以下列表显示了此格式的示例：

  • 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

 更新忽略配置。