Method: organizations.locations.postures.patch

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 postures.get to get the current version of the posture.
  2. Update the fields in the posture as needed.
  3. Call postures.patch to update the posture. Ensure that your request includes the etag value from the postures.get response.

Important: If you omit the etag when you call postures.patch, then the updated posture unconditionally overwrites the existing posture.

HTTP request

PATCH https://securityposture.googleapis.com/v1/{posture.name=organizations/*/locations/*/postures/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
posture.name

string

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

Query parameters

Parameters
updateMask

string (FieldMask format)

Required. The fields in the Posture to update.

You can update only the following fields:

This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".
revisionId

string

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.

Request body

The request body contains an instance of Posture.

Response body

If successful, the response body contains an instance of Operation.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the name resource:

  • securityposture.postures.update

For more information, see the IAM documentation.