versions

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

Overview

Name	versions
Type	Resource
Id	google.parametermanager.versions

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
name	string	Identifier. The resource name of the TemplateVersion in the format projects/*/locations/*/templates/*/versions/*.
createTime	string (google-datetime)	Output only. Create time stamp
disabled	boolean	Optional. Disabled boolean to determine if a TemplateVersion acts as a metadata only resource (payload is never returned if disabled is true).
payload	object	Required. Immutable. Payload content of a TemplateVersion resource. (id: TemplateVersionPayload)
updateTime	string (google-datetime)	Output only. Update time stamp

list

Name	Datatype	Description
name	string	Identifier. The resource name of the TemplateVersion in the format projects/*/locations/*/templates/*/versions/*.
createTime	string (google-datetime)	Output only. Create time stamp
disabled	boolean	Optional. Disabled boolean to determine if a TemplateVersion acts as a metadata only resource (payload is never returned if disabled is true).
payload	object	Required. Immutable. Payload content of a TemplateVersion resource. (id: TemplateVersionPayload)
updateTime	string (google-datetime)	Output only. Update time stamp

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	projectsId, locationsId, templatesId, versionsId	view	Gets details of a single TemplateVersion.
list	select	projectsId, locationsId, templatesId	filter, orderBy, pageSize, pageToken	Lists TemplateVersions in a given project, location, and template.
create	insert	projectsId, locationsId, templatesId	requestId, templateVersionId	Creates a new TemplateVersion in a given project, location, and template.
patch	update	projectsId, locationsId, templatesId, versionsId	requestId, updateMask	Updates a single TemplateVersion.
delete	delete	projectsId, locationsId, templatesId, versionsId	requestId	Deletes a single TemplateVersion.
render	exec	projectsId, locationsId, templatesId, versionsId	parameterVersion	Gets rendered version of a TemplateVersion.

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.

Name	Datatype	Description
locationsId	string
projectsId	string
templatesId	string
versionsId	string
filter	string
orderBy	string
pageSize	integer (int32)
pageToken	string
parameterVersion	string
requestId	string
templateVersionId	string
updateMask	string (google-fieldmask)
view	string

SELECT examples

get

Gets details of a single TemplateVersion.

SELECT
name,
createTime,
disabled,
payload,
updateTime
FROM google.parametermanager.versions
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND templatesId = '{{ templatesId }}' -- required
AND versionsId = '{{ versionsId }}' -- required
AND view = '{{ view }}'
;

list

Lists TemplateVersions in a given project, location, and template.

SELECT
name,
createTime,
disabled,
payload,
updateTime
FROM google.parametermanager.versions
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND templatesId = '{{ templatesId }}' -- required
AND filter = '{{ filter }}'
AND orderBy = '{{ orderBy }}'
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
;

INSERT examples

create

Creates a new TemplateVersion in a given project, location, and template.

INSERT INTO google.parametermanager.versions (
data__disabled,
data__name,
data__payload,
projectsId,
locationsId,
templatesId,
requestId,
templateVersionId
)
SELECT 
{{ disabled }},
'{{ name }}',
'{{ payload }}',
'{{ projectsId }}',
'{{ locationsId }}',
'{{ templatesId }}',
'{{ requestId }}',
'{{ templateVersionId }}'
RETURNING
name,
createTime,
disabled,
payload,
updateTime
;

Manifest

# Description fields are for documentation purposes
- name: versions
props:
  - name: projectsId
    value: "{{ projectsId }}"
    description: Required parameter for the versions resource.
  - name: locationsId
    value: "{{ locationsId }}"
    description: Required parameter for the versions resource.
  - name: templatesId
    value: "{{ templatesId }}"
    description: Required parameter for the versions resource.
  - name: disabled
    value: {{ disabled }}
    description: |
      Optional. Disabled boolean to determine if a TemplateVersion acts as a metadata only resource (payload is never returned if disabled is true).
  - name: name
    value: "{{ name }}"
    description: |
      Identifier. The resource name of the TemplateVersion in the format `projects/*/locations/*/templates/*/versions/*`.
  - name: payload
    description: |
      Required. Immutable. Payload content of a TemplateVersion resource.
    value:
      data: "{{ data }}"
  - name: requestId
    value: "{{ requestId }}"
  - name: templateVersionId
    value: "{{ templateVersionId }}"

UPDATE examples

patch

Updates a single TemplateVersion.

UPDATE google.parametermanager.versions
SET 
data__disabled = {{ disabled }},
data__name = '{{ name }}',
data__payload = '{{ payload }}'
WHERE 
projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND templatesId = '{{ templatesId }}' --required
AND versionsId = '{{ versionsId }}' --required
AND requestId = '{{ requestId}}'
AND updateMask = '{{ updateMask}}'
RETURNING
name,
createTime,
disabled,
payload,
updateTime;

DELETE examples

delete

Deletes a single TemplateVersion.

DELETE FROM google.parametermanager.versions
WHERE projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND templatesId = '{{ templatesId }}' --required
AND versionsId = '{{ versionsId }}' --required
AND requestId = '{{ requestId }}'
;

Lifecycle Methods

render

Gets rendered version of a TemplateVersion.

EXEC google.parametermanager.versions.render 
@projectsId='{{ projectsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@templatesId='{{ templatesId }}' --required, 
@versionsId='{{ versionsId }}' --required, 
@parameterVersion='{{ parameterVersion }}'
;