Method: organizations.locations.postures.delete

Deletes all revisions of a Posture.

You can only delete a posture if none of its revisions are deployed.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

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

Query parameters

Parameters
etag

string

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

If you provide this value, then it must match the existing value. If the values don't match, then the request fails with an ABORTED error.

If you omit this value, then the posture is deleted regardless of its current etag value.

Request body

The request body must be empty.

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.delete

For more information, see the IAM documentation.