posture_templates

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

Overview

Name	posture_templates
Type	Resource
Id	google.securityposture.posture_templates

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
name	string	Output only. Identifier. The name of the posture template, in the format organizations/{organization}/locations/global/postureTemplates/{posture_template}.
categories	array	Output only. The categories that the posture template belongs to, as determined by the Security Posture API.
description	string	Output only. A description of the posture template.
policySets	array	Output only. The PolicySet resources that the posture template includes.
revisionId	string	Output only. A string that identifies the revision of the posture template.
state	string	Output only. The state of the posture template at the specified revision_id.

list

Name	Datatype	Description
name	string	Output only. Identifier. The name of the posture template, in the format organizations/{organization}/locations/global/postureTemplates/{posture_template}.
categories	array	Output only. The categories that the posture template belongs to, as determined by the Security Posture API.
description	string	Output only. A description of the posture template.
policySets	array	Output only. The PolicySet resources that the posture template includes.
revisionId	string	Output only. A string that identifies the revision of the posture template.
state	string	Output only. The state of the posture template at the specified revision_id.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	organizationsId, locationsId, postureTemplatesId	revisionId	Gets a single revision of a PostureTemplate.
list	select	organizationsId, locationsId	pageSize, pageToken, filter	Lists every PostureTemplate in a given organization and location.

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
organizationsId	string
postureTemplatesId	string
filter	string
pageSize	integer (int32)
pageToken	string
revisionId	string

SELECT examples

get

Gets a single revision of a PostureTemplate.

SELECT
name,
categories,
description,
policySets,
revisionId,
state
FROM google.securityposture.posture_templates
WHERE organizationsId = '{{ organizationsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND postureTemplatesId = '{{ postureTemplatesId }}' -- required
AND revisionId = '{{ revisionId }}'
;

list

Lists every PostureTemplate in a given organization and location.

SELECT
name,
categories,
description,
policySets,
revisionId,
state
FROM google.securityposture.posture_templates
WHERE organizationsId = '{{ organizationsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
AND filter = '{{ filter }}'
;