Posture

The details of a posture.

JSON representation
{
  "name": string,
  "state": enum (State),
  "revisionId": string,
  "createTime": string,
  "updateTime": string,
  "description": string,
  "policySets": [
    {
      object (PolicySet)
    }
  ],
  "etag": string,
  "annotations": {
    string: string,
    ...
  },
  "reconciling": boolean,
  "categories": [
    enum (Category)
  ]
}
Fields
name

string

Required. Identifier. The name of the posture, in the format organizations/{organization}/locations/global/postures/{postureId}.

state

enum (State)

Required. The state of the posture at the specified revisionId.

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.

createTime

string (Timestamp format)

Output only. The time at which the posture was created.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Output only. The time at which the posture was last updated.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

description

string

Optional. A description of the posture.

policySets[]

object (PolicySet)

Required. The PolicySet resources that the posture includes.

etag

string

Optional. An opaque identifier for the current version of the posture at the specified revisionId.

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.

annotations

map (key: string, value: string)

Optional. The user-specified annotations for the posture.

For details about the values you can use in an annotation, see AIP-148: Standard fields.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

reconciling

boolean

Output only. Whether the posture is in the process of being updated.

categories[]

enum (Category)

Output only. The categories that the posture belongs to, as determined by the Security Posture API.