PostureDeployment

组织、文件夹或项目上的 Posture 部署的详细信息。

您最多只能向每个组织、文件夹或项目部署一个状态。态势部署的父级资源始终是组织,即使部署应用于文件夹或项目也是如此。

JSON 表示法
{
  "name": string,
  "targetResource": string,
  "state": enum (State),
  "postureId": string,
  "postureRevisionId": string,
  "createTime": string,
  "updateTime": string,
  "description": string,
  "etag": string,
  "annotations": {
    string: string,
    ...
  },
  "reconciling": boolean,
  "desiredPostureId": string,
  "desiredPostureRevisionId": string,
  "failureMessage": string,
  "categories": [
    enum (Category)
  ]
}
字段
name

string

必需。标识符。态势部署的名称,格式为 organizations/{organization}/locations/global/postureDeployments/{deployment_id}

targetResource

string

必需。部署态势的组织、文件夹或项目。采用以下格式之一:

  • organizations/{organization_number}
  • folders/{folder_number}
  • projects/{project_number}
state

enum (State)

仅限输出。设备配置状态。

postureId

string

必需。部署中使用的状态,格式为 organizations/{organization}/locations/global/postures/{postureId}

postureRevisionId

string

必需。部署中使用的状态的修订 ID。

createTime

string (Timestamp format)

仅限输出。创建设备配置部署的时间。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

updateTime

string (Timestamp format)

仅限输出。上次更新配置状态部署的时间。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

description

string

可选。状态配置的说明。

etag

string

可选。当前版态部署的不透明标识符。

为防止并发更新相互覆盖,请在更新设备配置时始终提供 etag。您还可以在删除设备配置时提供 etag,以帮助确保您要删除的是预期的设备配置。

annotations

map (key: string, value: string)

可选。用户为设备状态部署指定的注释。

如需详细了解您可以在注释中使用的值,请参阅 AIP-148:标准字段

包含一系列 "key": value 对的对象。示例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }

reconciling

boolean

仅限输出。安全状况部署是否正在更新。

desiredPostureId

string

仅限输出。为部署指定的状态 ID。仅当设备配置状态处于失败状态时才会显示。

desiredPostureRevisionId

string

仅限输出。为部署指定的状态的修订版本 ID。仅当部署处于失败状态时才会显示。

failureMessage

string

仅限输出。说明状态配置部署失败的原因。仅当部署处于失败状态时才会显示。

categories[]

enum (Category)

仅限输出。安全状况部署所属的类别,由 Security Posture API 确定。