postures_revisions

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

Overview

Name	postures_revisions
Type	Resource
Id	google.securityposture.postures_revisions

Fields

The following fields are returned by SELECT queries:

list_revisions

Successful response

Name	Datatype	Description
name	string	Required. Identifier. The name of the posture, in the format organizations/{organization}/locations/global/postures/{posture_id}.
annotations	object	Optional. The user-specified annotations for the posture. For details about the values you can use in an annotation, see AIP-148: Standard fields.
categories	array	Output only. The categories that the posture belongs to, as determined by the Security Posture API.
createTime	string (google-datetime)	Output only. The time at which the posture was created.
description	string	Optional. A description of the posture.
etag	string	Optional. An opaque identifier for the current version of the posture at the specified revision_id. To prevent concurrent updates from overwriting each other, always provide the etag when you update a posture. You can also provide the etag when you delete a posture, to help ensure that you're deleting the intended version of the posture.
policySets	array	Required. The PolicySet resources that the posture includes.
reconciling	boolean	Output only. Whether the posture is in the process of being updated.
revisionId	string	Output only. Immutable. An opaque eight-character string that identifies the revision of the posture. A posture can have multiple revisions; when you deploy a posture, you deploy a specific revision of the posture.
state	string	Required. The state of the posture at the specified revision_id.
updateTime	string (google-datetime)	Output only. The time at which the posture was last updated.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_revisions	select	organizationsId, locationsId, posturesId	pageSize, pageToken	Lists all revisions of a single Posture.

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
posturesId	string
pageSize	integer (int32)
pageToken	string

SELECT examples

list_revisions

Lists all revisions of a single Posture.

SELECT
name,
annotations,
categories,
createTime,
description,
etag,
policySets,
reconciling,
revisionId,
state,
updateTime
FROM google.securityposture.postures_revisions
WHERE organizationsId = '{{ organizationsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND posturesId = '{{ posturesId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}';