Sign in

v1

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

Creates a new PostureDeployment in a given project and location.

post/v1/{+parent}/postureDeployments

Path parameters

parentstring required

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

Query parameters

postureDeploymentIdstring

Required. An identifier for the posture deployment.

Request body

state'STATE_UNSPECIFIED' | 'CREATING' | 'DELETING' | 'UPDATING' | 'ACTIVE' | 'CREATE_FAILED' | 'UPDATE_FAILED' | 'DELETE_FAILED'

Output only. The state of the posture deployment.

postureRevisionIdstring

Required. The revision ID of the posture used in the deployment.

categoriesstring[]

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

desiredPostureIdstring

Output only. The posture ID that was specified for the deployment. Present only if the posture deployment is in a failed state.

failureMessagestring

Output only. A description of why the posture deployment failed. Present only if the deployment is in a failed state.

reconcilingboolean

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

desiredPostureRevisionIdstring

Output only. The revision ID of the posture that was specified for the deployment. Present only if the deployment is in a failed state.

postureIdstring

Required. The posture used in the deployment, in the format organizations/{organization}/locations/global/postures/{posture_id}.

namestring

Required. Identifier. The name of the posture deployment, in the format organizations/{organization}/locations/global/postureDeployments/{deployment_id}.

updateTimestring google-datetime

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

targetResourcestring

Required. The organization, folder, or project where the posture is deployed. Uses one of the following formats: * organizations/{organization_number} * folders/{folder_number} * projects/{project_number}

descriptionstring

Optional. A description of the posture deployment.

annotationsobject

Optional. The user-specified annotations for the posture deployment. 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 deployment. To prevent concurrent updates from overwriting each other, always provide the etag when you update a posture deployment. You can also provide the etag when you delete a posture deployment, to help ensure that you're deleting the intended posture deployment.

createTimestring google-datetime

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

Response

Successful response