PostureDeployment

組織、フォルダ、プロジェクトに対する Posture のデプロイの詳細。

各組織、フォルダ、プロジェクトにデプロイできる対策は 1 つのみです。デプロイがフォルダまたはプロジェクトに適用される場合でも、対策のデプロイの親リソースは常に組織です。

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

必須。ID。ポスチャのデプロイの名前(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「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

updateTime

string (Timestamp format)

出力専用。ポスチャのデプロイが最後に更新された時刻。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

description

string

省略可。対策のデプロイの説明。

etag

string

省略可。現在のバージョンのポスチャのデプロイの不透明な ID。

同時実行の更新で互いに上書きされないようにするには、ポスチャのデプロイを更新するときに常に 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 によって決定される、セキュリティ対策デプロイが属するカテゴリ。