REST Resource: organizations.locations.postureDeployments

Resource: PostureDeployment

Details for a Posture deployment on an organization, folder, or project.

You can deploy at most one posture to each organization, folder, or project. The parent resource for a posture deployment is always the organization, even if the deployment applies to a folder or project.

JSON representation 
{
  "name": string,
  "targetResource": string,
  "state": enum (State),
  "postureId": string,
  "postureRevisionId": string,
  "createTime": string,
  "updateTime": string,
  "description": string,
  "etag": string,
  "annotations": {
    string: string,
    ...
  },
  "reconciling": boolean,
  "desiredPostureId": string,
  "desiredPostureRevisionId": string,
  "failureMessage": string,
  "categories": [
    enum (Category)
  ]
}
Fields
name

string

Required. Identifier. The name of the posture deployment, in the format organizations/{organization}/locations/global/postureDeployments/{deployment_id}.
targetResource

string

Required. The organization, folder, or project where the posture is deployed. Uses one of the following formats:

  • organizations/{organization_number}
  • folders/{folder_number}
  • projects/{project_number}
state

enum (State)

Output only. The state of the posture deployment.
postureId

string

Required. The posture used in the deployment, in the format organizations/{organization}/locations/global/postures/{postureId}.
postureRevisionId

string

Required. The revision ID of the posture used in the deployment.
createTime

string (Timestamp format)

Output only. The time at which the posture deployment 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 deployment 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 deployment.
etag

string

Optional. An opaque identifier for the current version of the posture deployment.

To prevent concurrent updates from overwriting each other, always provide the etag when you update a posture deployment. You can also provide the etag when you delete a posture deployment, to help ensure that you're deleting the intended posture deployment.
annotations

map (key: string, value: string)

Optional. The user-specified annotations for the posture deployment.

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 deployment is in the process of being updated.
desiredPostureId

string

Output only. The posture ID that was specified for the deployment. Present only if the posture deployment is in a failed state.
desiredPostureRevisionId

string

Output only. The revision ID of the posture that was specified for the deployment. Present only if the deployment is in a failed state.
failureMessage

string

Output only. A description of why the posture deployment failed. Present only if the deployment is in a failed state.
categories[]

enum (Category)

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

State

The state of a PostureDeployment.

Enums
STATE_UNSPECIFIED Default value. This value is unused.
CREATING The posture deployment is being created.
DELETING The posture deployment is being deleted.
UPDATING The posture deployment is being updated.
ACTIVE The posture deployment is active and in use.
CREATE_FAILED The posture deployment could not be created.
UPDATE_FAILED The posture deployment could not be updated.
DELETE_FAILED The posture deployment could not be deleted.

Methods

create

 Creates a new PostureDeployment in a given project and location.

delete

 Deletes a PostureDeployment.

get

 Gets details for a PostureDeployment.

list

 Lists every PostureDeployment in a project and location.

patch

 Updates an existing PostureDeployment.