organizations

Changed on

Creates a new Posture.

post/v1/{+parent}/postures

Request

  • Base URL: https://securityposture.googleapis.com
  • URL: https://securityposture.googleapis.com/v1/{+parent}/postures
  • Auth: OAuth 2 (implicit, authorization URL https://accounts.google.com/o/oauth2/auth, scopes: https://www.googleapis.com/auth/cloud-platform) and OAuth 2 (authorization code, authorization URL https://accounts.google.com/o/oauth2/auth, token URL https://accounts.google.com/o/oauth2/token, scopes: https://www.googleapis.com/auth/cloud-platform)

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

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.

categoriesstring[]

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

createTimestring google-datetime

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

descriptionstring

Optional. A description of the posture.

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.

namestring

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

reconcilingboolean

Output only. Whether the posture is in the process of being 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.

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

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

updateTimestring google-datetime

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

Response

Successful response

Changes

  • fe69852d49bcRevision changes
    • breaking

      removed the request body

    • breaking

      removed the media type */* for the response with the status