{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/google-cloud-security-command-center/json-schema/google-cloud-security-command-center-posture-deployment-schema.json",
  "title": "PostureDeployment",
  "description": "Details for a Posture deployment on an organization, folder, or project. You can deploy at most one posture to each organization, folder, or project. The parent resource for a posture deployment is always the organization, even if the deployment applies to a folder or project.",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-cloud-security-command-center-securityposture-organizations-api-openapi.yml#/components/schemas/PostureDeployment",
  "properties": {
    "description": {
      "description": "Optional. A description of the posture deployment.",
      "type": "string"
    },
    "reconciling": {
      "readOnly": true,
      "description": "Output only. Whether the posture deployment is in the process of being updated.",
      "type": "boolean"
    },
    "etag": {
      "description": "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.",
      "type": "string"
    },
    "targetResource": {
      "description": "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}`",
      "type": "string"
    },
    "name": {
      "description": "Required. Identifier. The name of the posture deployment, in the format `organizations/{organization}/locations/global/postureDeployments/{deployment_id}`.",
      "type": "string"
    },
    "postureId": {
      "type": "string",
      "description": "Required. The posture used in the deployment, in the format `organizations/{organization}/locations/global/postures/{posture_id}`."
    },
    "createTime": {
      "description": "Output only. The time at which the posture deployment was created.",
      "type": "string",
      "readOnly": true,
      "format": "google-datetime"
    },
    "state": {
      "type": "string",
      "readOnly": true,
      "enum": [
        "STATE_UNSPECIFIED",
        "CREATING",
        "DELETING",
        "UPDATING",
        "ACTIVE",
        "CREATE_FAILED",
        "UPDATE_FAILED",
        "DELETE_FAILED"
      ],
      "description": "Output only. The state of the posture deployment."
    },
    "failureMessage": {
      "readOnly": true,
      "type": "string",
      "description": "Output only. A description of why the posture deployment failed. Present only if the deployment is in a failed state."
    },
    "updateTime": {
      "description": "Output only. The time at which the posture deployment was last updated.",
      "format": "google-datetime",
      "type": "string",
      "readOnly": true
    },
    "annotations": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "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](https://google.aip.dev/148#annotations)."
    },
    "desiredPostureRevisionId": {
      "type": "string",
      "description": "Output only. The revision ID of the posture that was specified for the deployment. Present only if the deployment is in a failed state.",
      "readOnly": true
    },
    "categories": {
      "type": "array",
      "description": "Output only. The categories that the posture deployment belongs to, as determined by the Security Posture API.",
      "items": {
        "enum": [
          "CATEGORY_UNSPECIFIED",
          "AI",
          "AWS",
          "GCP",
          "AZURE"
        ],
        "type": "string"
      },
      "readOnly": true
    },
    "postureRevisionId": {
      "type": "string",
      "description": "Required. The revision ID of the posture used in the deployment."
    },
    "desiredPostureId": {
      "description": "Output only. The posture ID that was specified for the deployment. Present only if the posture deployment is in a failed state.",
      "type": "string",
      "readOnly": true
    }
  },
  "type": "object"
}