REST Resource: organizations.muteConfigs

资源:MuteConfig

忽略配置是 Cloud SCC 资源,其中包含用于忽略发现结果的创建/更新事件的配置。

JSON 表示法
{
  "name": string,
  "displayName": string,
  "description": string,
  "filter": string,
  "createTime": string,
  "updateTime": string,
  "mostRecentEditor": string,
  "type": enum (MuteConfigType),
  "expiryTime": string
}
字段
name

string

如果在创建配置时提供此字段,系统会忽略此字段。格式 organizations/{organization}/muteConfigs/{muteConfig} folders/{folder}/muteConfigs/{muteConfig} projects/{project}/muteConfigs/{muteConfig} organizations/{organization}/locations/global/muteConfigs/{muteConfig} folders/{folder}/locations/global/muteConfigs/{muteConfig} projects/{project}/locations/global/muteConfigs/{muteConfig}

displayName
(deprecated)

string

要为静音配置显示的人类可读名称。

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)

可选。静音配置的类型,用于确定该配置会影响哪种类型的静音状态。静态静音状态优先于动态静音状态。一经创建便无法更改。如果未在创建期间设置,则默认为 STATIC。

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"

方法

create

创建忽略配置。

delete

删除现有的静音配置。

get

获取静音配置。

list

列出静音配置。

patch

更新忽略配置。