Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-13154261.4 KB
organizations

Updates a revision of an existing Posture. If the posture revision that you update is currently deployed, then a new revision of the posture is created. To prevent concurrent updates from overwriting each other, always follow the read-modify-write pattern when you update a posture: 1. Call GetPosture to get the current version of the posture. 2. Update the fields in the posture as needed. 3. Call UpdatePosture to update the posture. Ensure that your request includes the etag value from the GetPosture response. Important: If you omit the etag when you call UpdatePosture, then the updated posture unconditionally overwrites the existing posture.

patch/v1/{+name}

Path parameters

namestring required

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

Query parameters

revisionIdstring

Required. The revision ID of the posture to update. If the posture revision that you update is currently deployed, then a new revision of the posture is created.

updateMaskstring

Required. The fields in the Posture to update. You can update only the following fields: * Posture.description * Posture.policy_sets * Posture.state

Request body

categoriesstring[]

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

updateTimestring google-datetime

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

revisionIdstring

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.

descriptionstring

Optional. A description of the posture.

annotationsobject

Optional. The user-specified annotations for the posture. For details about the values you can use in an annotation, see AIP-148: Standard fields.

etagstring

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.

createTimestring google-datetime

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

state'STATE_UNSPECIFIED' | 'DEPRECATED' | 'DRAFT' | 'ACTIVE'

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

reconcilingboolean

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

namestring

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

Response

Successful response