REST Resource: folders.locations.muteConfigs

Recurso: MuteConfig

Una configuración de silenciamiento es un recurso de Cloud SCC que contiene la configuración para silenciar los eventos de creación o actualización de hallazgos.

Representación JSON 
{
  "name": string,
  "description": string,
  "filter": string,
  "createTime": string,
  "updateTime": string,
  "mostRecentEditor": string,
  "type": enum (MuteConfigType),
  "expiryTime": string
}
Campos
name

string

Identificador. Este campo se ignorará si se proporciona durante la creación de la configuración. En la siguiente lista, se muestran algunos ejemplos del formato:

  • 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

Es una descripción de la configuración de silenciamiento.
filter

string

Obligatorio. Es una expresión que define el filtro que se aplicará a los eventos de creación o actualización de los resultados. Cuando crees una cadena de filtro, ten en cuenta el alcance en el que se crea la configuración de silenciamiento. P. ej., Si un filtro contiene project = X, pero se crea en el alcance project = Y, es posible que no coincida con ningún resultado.

Se admiten las siguientes combinaciones de campos y operadores:

  • gravedad: =, :
  • categoría: =, :
  • 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)

Solo salida. Es la hora en la que se creó la configuración de silenciamiento. El servidor establece este campo y se ignorará si se proporciona cuando se crea la configuración.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo salida. La hora más reciente en la que se actualizó la configuración de silencio. El servidor establece este campo y se ignorará si se proporciona en la creación o actualización de la configuración.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
mostRecentEditor

string

Solo salida. Es la dirección de correo electrónico del usuario que editó la configuración de silenciamiento por última vez. El servidor establece este campo y se ignorará si se proporciona en la creación o actualización de la configuración.
type

enum (MuteConfigType)

Obligatorio. Es el tipo de configuración de silenciamiento, que determina qué tipo de estado de silenciamiento afecta la configuración. Inmutable después de la creación.
expiryTime

string (Timestamp format)

Opcional. Es la fecha de vencimiento de la configuración de silenciamiento. Solo se aplica a las configuraciones dinámicas. Si se establece el vencimiento, cuando venza la configuración, se quitará de todos los resultados.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

MuteConfigType

Es el tipo de MuteConfig.

Enums
MUTE_CONFIG_TYPE_UNSPECIFIED No usuado.
STATIC Una configuración de silenciamiento estático, que establece el estado de silenciamiento estático de los resultados coincidentes futuros como silenciados. Una vez que se haya establecido el estado de silencio estático, las modificaciones de la configuración o los hallazgos no lo afectarán.
DYNAMIC Una configuración de silenciamiento dinámico, que se aplica a los resultados coincidentes existentes y futuros, establece su estado de silenciamiento dinámico en "silenciado". Si se actualiza o borra la configuración, o se actualiza un hallazgo coincidente, de modo que el hallazgo no coincida con la configuración, esta se quitará del hallazgo y el estado de silenciamiento dinámico del hallazgo podría dejar de estar silenciado (a menos que otras configuraciones sigan coincidiendo).

Métodos

create

 Crea una configuración de silenciamiento.

delete

 Borra una configuración de silenciamiento existente.

get

 Obtiene una configuración de silenciamiento.

list

 Muestra una lista de las configuraciones de silenciamiento.

patch

 Actualiza una configuración de silenciamiento.