Skip to main content

mute_configs

Creates, updates, deletes, gets or lists a mute_configs resource.

Overview

Namemute_configs
TypeResource
Idgoogle.securitycenter.mute_configs

Fields

The following fields are returned by SELECT queries:

Successful response

NameDatatypeDescription
namestringThis field will be ignored if provided on config creation. Format organizations/{organization}/muteConfigs/{mute_config} folders/{folder}/muteConfigs/{mute_config} projects/{project}/muteConfigs/{mute_config} organizations/{organization}/locations/global/muteConfigs/{mute_config} folders/{folder}/locations/global/muteConfigs/{mute_config} projects/{project}/locations/global/muteConfigs/{mute_config}
createTimestring (google-datetime)Output only. The time at which the mute config was created. This field is set by the server and will be ignored if provided on config creation.
descriptionstringA description of the mute config.
displayNamestringThe human readable name to be displayed for the mute config.
expiryTimestring (google-datetime)Optional. The expiry of the mute config. Only applicable for dynamic configs. If the expiry is set, when the config expires, it is removed from all findings.
filterstringRequired. An expression that defines the filter to apply across create/update events of findings. While creating a filter string, be mindful of the scope in which the mute configuration is being created. E.g., If a filter contains project = X but is created under the project = Y scope, it might not match any findings. The following field and operator combinations are supported: * severity: =, : * category: =, : * resource.name: =, : * resource.project_name: =, : * resource.project_display_name: =, : * resource.folders.resource_folder: =, : * resource.parent_name: =, : * resource.parent_display_name: =, : * resource.type: =, : * finding_class: =, : * indicator.ip_addresses: =, : * indicator.domains: =, :
mostRecentEditorstringOutput only. Email address of the user who last edited the mute config. This field is set by the server and will be ignored if provided on config creation or update.
typestringOptional. The type of the mute config, which determines what type of mute state the config affects. The static mute state takes precedence over the dynamic mute state. Immutable after creation. STATIC by default if not set during creation.
updateTimestring (google-datetime)Output only. The most recent time at which the mute config was updated. This field is set by the server and will be ignored if provided on config creation or update.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
folders_locations_mute_configs_getselectfoldersId, locationsId, muteConfigsIdGets a mute config.
projects_locations_mute_configs_getselectprojectsId, locationsId, muteConfigsIdGets a mute config.
organizations_locations_mute_configs_getselectorganizationsId, locationsId, muteConfigsIdGets a mute config.
folders_mute_configs_getselectfoldersId, muteConfigsIdGets a mute config.
projects_mute_configs_getselectprojectsId, muteConfigsIdGets a mute config.
organizations_mute_configs_getselectorganizationsId, muteConfigsIdGets a mute config.
folders_mute_configs_listselectfoldersIdpageSize, pageTokenLists mute configs.
projects_mute_configs_listselectprojectsIdpageSize, pageTokenLists mute configs.
organizations_mute_configs_listselectorganizationsIdpageSize, pageTokenLists mute configs.
folders_mute_configs_createinsertfoldersIdmuteConfigIdCreates a mute config.
projects_mute_configs_createinsertprojectsIdmuteConfigIdCreates a mute config.
organizations_mute_configs_createinsertorganizationsIdmuteConfigIdCreates a mute config.
folders_locations_mute_configs_patchupdatefoldersId, locationsId, muteConfigsIdupdateMaskUpdates a mute config.
projects_locations_mute_configs_patchupdateprojectsId, locationsId, muteConfigsIdupdateMaskUpdates a mute config.
organizations_locations_mute_configs_patchupdateorganizationsId, locationsId, muteConfigsIdupdateMaskUpdates a mute config.
folders_mute_configs_patchupdatefoldersId, muteConfigsIdupdateMaskUpdates a mute config.
projects_mute_configs_patchupdateprojectsId, muteConfigsIdupdateMaskUpdates a mute config.
organizations_mute_configs_patchupdateorganizationsId, muteConfigsIdupdateMaskUpdates a mute config.
folders_locations_mute_configs_deletedeletefoldersId, locationsId, muteConfigsIdDeletes an existing mute config.
projects_locations_mute_configs_deletedeleteprojectsId, locationsId, muteConfigsIdDeletes an existing mute config.
organizations_locations_mute_configs_deletedeleteorganizationsId, locationsId, muteConfigsIdDeletes an existing mute config.
folders_mute_configs_deletedeletefoldersId, muteConfigsIdDeletes an existing mute config.
projects_mute_configs_deletedeleteprojectsId, muteConfigsIdDeletes an existing mute config.
organizations_mute_configs_deletedeleteorganizationsId, muteConfigsIdDeletes an existing mute config.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
foldersIdstring
locationsIdstring
muteConfigsIdstring
organizationsIdstring
projectsIdstring
muteConfigIdstring
pageSizeinteger (int32)
pageTokenstring
updateMaskstring (google-fieldmask)

SELECT examples

Gets a mute config.

SELECT
name,
createTime,
description,
displayName,
expiryTime,
filter,
mostRecentEditor,
type,
updateTime
FROM google.securitycenter.mute_configs
WHERE foldersId = '{{ foldersId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND muteConfigsId = '{{ muteConfigsId }}' -- required;

INSERT examples

Creates a mute config.

INSERT INTO google.securitycenter.mute_configs (
data__name,
data__displayName,
data__description,
data__filter,
data__type,
data__expiryTime,
foldersId,
muteConfigId
)
SELECT
'{{ name }}',
'{{ displayName }}',
'{{ description }}',
'{{ filter }}',
'{{ type }}',
'{{ expiryTime }}',
'{{ foldersId }}',
'{{ muteConfigId }}'
RETURNING
name,
createTime,
description,
displayName,
expiryTime,
filter,
mostRecentEditor,
type,
updateTime
;

UPDATE examples

Updates a mute config.

UPDATE google.securitycenter.mute_configs
SET
data__name = '{{ name }}',
data__displayName = '{{ displayName }}',
data__description = '{{ description }}',
data__filter = '{{ filter }}',
data__type = '{{ type }}',
data__expiryTime = '{{ expiryTime }}'
WHERE
foldersId = '{{ foldersId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND muteConfigsId = '{{ muteConfigsId }}' --required
AND updateMask = '{{ updateMask}}'
RETURNING
name,
createTime,
description,
displayName,
expiryTime,
filter,
mostRecentEditor,
type,
updateTime;

DELETE examples

Deletes an existing mute config.

DELETE FROM google.securitycenter.mute_configs
WHERE foldersId = '{{ foldersId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND muteConfigsId = '{{ muteConfigsId }}' --required;