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

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}
descriptionstringA description of the mute config.
createTimestringOutput 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.
displayNamestringThe human readable name to be displayed for the mute config.
expiryTimestringOptional. 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.
updateTimestringOutput 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

NameAccessible byRequired ParamsDescription
folders_locations_mute_configs_getSELECTfoldersId, locationsId, muteConfigsIdGets a mute config.
folders_locations_mute_configs_listSELECTfoldersId, locationsIdLists mute configs.
folders_mute_configs_getSELECTfoldersId, muteConfigsIdGets a mute config.
folders_mute_configs_listSELECTfoldersIdLists mute configs.
organizations_locations_mute_configs_getSELECTlocationsId, muteConfigsId, organizationsIdGets a mute config.
organizations_locations_mute_configs_listSELECTlocationsId, organizationsIdLists mute configs.
organizations_mute_configs_getSELECTmuteConfigsId, organizationsIdGets a mute config.
organizations_mute_configs_listSELECTorganizationsIdLists mute configs.
projects_locations_mute_configs_getSELECTlocationsId, muteConfigsId, projectsIdGets a mute config.
projects_locations_mute_configs_listSELECTlocationsId, projectsIdLists mute configs.
projects_mute_configs_getSELECTmuteConfigsId, projectsIdGets a mute config.
projects_mute_configs_listSELECTprojectsIdLists mute configs.
folders_locations_mute_configs_createINSERTfoldersId, locationsIdCreates a mute config.
folders_mute_configs_createINSERTfoldersIdCreates a mute config.
organizations_locations_mute_configs_createINSERTlocationsId, organizationsIdCreates a mute config.
organizations_mute_configs_createINSERTorganizationsIdCreates a mute config.
projects_locations_mute_configs_createINSERTlocationsId, projectsIdCreates a mute config.
projects_mute_configs_createINSERTprojectsIdCreates a mute config.
folders_locations_mute_configs_deleteDELETEfoldersId, locationsId, muteConfigsIdDeletes an existing mute config.
folders_mute_configs_deleteDELETEfoldersId, muteConfigsIdDeletes an existing mute config.
organizations_locations_mute_configs_deleteDELETElocationsId, muteConfigsId, organizationsIdDeletes an existing mute config.
organizations_mute_configs_deleteDELETEmuteConfigsId, organizationsIdDeletes an existing mute config.
projects_locations_mute_configs_deleteDELETElocationsId, muteConfigsId, projectsIdDeletes an existing mute config.
projects_mute_configs_deleteDELETEmuteConfigsId, projectsIdDeletes an existing mute config.
folders_locations_mute_configs_patchUPDATEfoldersId, locationsId, muteConfigsIdUpdates a mute config.
folders_mute_configs_patchUPDATEfoldersId, muteConfigsIdUpdates a mute config.
organizations_locations_mute_configs_patchUPDATElocationsId, muteConfigsId, organizationsIdUpdates a mute config.
organizations_mute_configs_patchUPDATEmuteConfigsId, organizationsIdUpdates a mute config.
projects_locations_mute_configs_patchUPDATElocationsId, muteConfigsId, projectsIdUpdates a mute config.
projects_mute_configs_patchUPDATEmuteConfigsId, projectsIdUpdates a mute config.

SELECT examples

Lists mute configs.

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

INSERT example

Use the following StackQL query and manifest file to create a new mute_configs resource.

/*+ create */
INSERT INTO google.securitycenter.mute_configs (
foldersId,
name,
displayName,
description,
filter,
type,
expiryTime
)
SELECT
'{{ foldersId }}',
'{{ name }}',
'{{ displayName }}',
'{{ description }}',
'{{ filter }}',
'{{ type }}',
'{{ expiryTime }}'
;

UPDATE example

Updates a mute_configs resource.

/*+ update */
UPDATE google.securitycenter.mute_configs
SET
name = '{{ name }}',
displayName = '{{ displayName }}',
description = '{{ description }}',
filter = '{{ filter }}',
type = '{{ type }}',
expiryTime = '{{ expiryTime }}'
WHERE
foldersId = '{{ foldersId }}'
AND muteConfigsId = '{{ muteConfigsId }}';

DELETE example

Deletes the specified mute_configs resource.

/*+ delete */
DELETE FROM google.securitycenter.mute_configs
WHERE foldersId = '{{ foldersId }}'
AND muteConfigsId = '{{ muteConfigsId }}';