Sign in

v1

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

Creates a new Posture.

post/v1/{+parent}/postures

Path parameters

parentstring required

Required. The parent resource name, in the format organizations/{organization}/locations/global.

Query parameters

postureIdstring

Required. An identifier for the posture.

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