Skip to main content

config

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

Overview

Nameconfig
TypeResource
Idgoogle.dataform.config

Fields

The following fields are returned by SELECT queries:

Successful response

NameDatatypeDescription
namestringIdentifier. The config name.
defaultKmsKeyNamestringOptional. The default KMS key that is used if no encryption key is provided when a repository is created.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_configselectprojectsId, locationsIdGet default config for a given project and location.
update_configupdateprojectsId, locationsIdupdateMaskUpdate default config for a given project and location. Note: This method does not fully implement AIP/134. The wildcard entry (*) is treated as a bad request, and when the field_mask is omitted, the request is treated as a full update on all modifiable fields.

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

SELECT examples

Get default config for a given project and location.

SELECT
name,
defaultKmsKeyName
FROM google.dataform.config
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required;

UPDATE examples

Update default config for a given project and location. Note: This method does not fully implement AIP/134. The wildcard entry (*) is treated as a bad request, and when the field_mask is omitted, the request is treated as a full update on all modifiable fields.

UPDATE google.dataform.config
SET
data__name = '{{ name }}',
data__defaultKmsKeyName = '{{ defaultKmsKeyName }}'
WHERE
projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND updateMask = '{{ updateMask}}'
RETURNING
name,
defaultKmsKeyName;