REST Resource: organizations.locations.postures

资源:Posture

姿势的详细信息。

JSON 表示法
{
  "name": string,
  "state": enum (State),
  "revisionId": string,
  "createTime": string,
  "updateTime": string,
  "description": string,
  "policySets": [
    {
      object (PolicySet)
    }
  ],
  "etag": string,
  "annotations": {
    string: string,
    ...
  },
  "reconciling": boolean,
  "categories": [
    enum (Category)
  ]
}
字段
name

string

必需。标识符。姿势的名称,格式为 organizations/{organization}/locations/global/postures/{postureId}

state

enum (State)

必需。指定 revisionId 时的姿势状态。

revisionId

string

仅限输出。不可变。一个不透明的八字符字符串,用于标识姿势的修订版本。一个安全状况可以有多个修订版本;部署安全状况时,您部署的是安全状况的特定修订版本。

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

可选。姿势说明。

policySets[]

object (PolicySet)

必需。该状态包含的 PolicySet 资源。

etag

string

可选。指定 revisionId 中当前版本的状态的不透明标识符。

为防止并发更新相互覆盖,请在更新设备状态时始终提供 etag。您还可以在删除某个屏幕状态时提供 etag,以帮助确保您删除的是预期的屏幕状态版本。

annotations

map (key: string, value: string)

可选。用户为姿势指定的注释。

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

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

reconciling

boolean

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

categories[]

enum (Category)

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

Posture 的状态。

枚举
STATE_UNSPECIFIED 默认值。此值未使用。
DEPRECATED 此安全状况已被弃用,无法再部署。
DRAFT 此安全状况为草稿,尚未做好部署准备。
ACTIVE 安全状况已完成,可以进行部署。

方法

create

创建新 Posture

delete

删除 Posture 的所有修订版本。

extract

从组织、文件夹或项目中提取现有政策,并将其作为 Posture 应用于其他组织、文件夹或项目。

get

获取 Posture 的单个修订版本。

list

列出指定组织和位置中所有 Posture 资源的最新修订版本。

listRevisions

列出单个 Posture 的所有修订版本。

patch

更新现有 Posture 的修订版。