Skip to main content

settings

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

Overview

Namesettings
TypeResource
Idgoogle.observability.settings

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
namestringIdentifier. The resource name of the settings.
defaultStorageLocationstringOptional. The location which should be used when any regional resources are provisioned by Google Cloud.
kmsKeyNamestringOptional. The resource name for the configured Cloud KMS key. KMS key name format: "projects/[PROJECT_ID]/locations/[LOCATION]/keyRings/[KEYRING]/cryptoKeys/[KEY]" For example: "projects/my-project/locations/us-central1/keyRings/my-ring/cryptoKeys/my-key"
serviceAccountIdstringOutput only. The service account for the given resource container, such as project or folder. This will be used by Cloud Observability to perform actions in the container's project like access KMS keys or create Links. Always the same service account per resource container regardless of region.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_settingsselectorganizationsId, locationsIdGet Settings
update_settingsupdateorganizationsId, locationsIdupdateMaskUpdate Settings

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
locationsIdstring
organizationsIdstring
updateMaskstring (google-fieldmask)

SELECT examples

Get Settings

SELECT
name,
defaultStorageLocation,
kmsKeyName,
serviceAccountId
FROM google.observability.settings
WHERE organizationsId = '{{ organizationsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
;

UPDATE examples

Update Settings

UPDATE google.observability.settings
SET
data__name = '{{ name }}',
data__kmsKeyName = '{{ kmsKeyName }}',
data__defaultStorageLocation = '{{ defaultStorageLocation }}'
WHERE
organizationsId = '{{ organizationsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND updateMask = '{{ updateMask}}'
RETURNING
name,
done,
error,
metadata,
response;