REST Resource: organizations.locations.postures

Resource: 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.

State

The state of a Posture.

Enums
STATE_UNSPECIFIED Default value. This value is unused.
DEPRECATED The posture is deprecated and can no longer be deployed.
DRAFT The posture is a draft and is not ready to deploy.
ACTIVE The posture is complete and ready to deploy.

Methods

create

 Creates a new Posture.

delete

 Deletes all revisions of a Posture.

extract

 Extracts existing policies from an organization, folder, or project, and applies them to another organization, folder, or project as a Posture.

get

 Gets a single revision of a Posture.

list

 Lists the most recent revisions of all Posture resources in a specified organization and location.

listRevisions

 Lists all revisions of a single Posture.

patch

 Updates a revision of an existing Posture.