REST Resource: organizations.locations.postures

Resource: Posture

Detail postur.

Representasi 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)
  ]
}
Kolom
name

string

Wajib. ID. Nama postur, dalam format organizations/{organization}/locations/global/postures/{postureId}.

state

enum (State)

Wajib. Status postur pada revisionId yang ditentukan.

revisionId

string

Hanya output. Tidak dapat diubah. String delapan karakter buram yang mengidentifikasi revisi postur. Postur dapat memiliki beberapa revisi; saat men-deploy postur, Anda men-deploy revisi postur tertentu.

createTime

string (Timestamp format)

Hanya output. Waktu saat postur dibuat.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Hanya output. Waktu saat postur terakhir diperbarui.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

description

string

Opsional. Deskripsi postur.

policySets[]

object (PolicySet)

Wajib. Resource PolicySet yang disertakan dalam postur.

etag

string

Opsional. ID buram untuk versi postur saat ini di revisionId yang ditentukan.

Untuk mencegah update serentak saling menimpa, selalu berikan etag saat Anda memperbarui postur. Anda juga dapat memberikan etag saat menghapus postur, untuk membantu memastikan bahwa Anda menghapus versi postur yang diinginkan.

annotations

map (key: string, value: string)

Opsional. Anotasi yang ditentukan pengguna untuk postur.

Untuk mengetahui detail tentang nilai yang dapat Anda gunakan dalam anotasi, lihat AIP-148: Kolom standar.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

reconciling

boolean

Hanya output. Apakah postur sedang dalam proses diperbarui.

categories[]

enum (Category)

Hanya output. Kategori yang menjadi bagian dari postur, seperti yang ditentukan oleh Security Posture API.

Negara bagian/Provinsi

Status Posture.

Enum
STATE_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
DEPRECATED Postur ini tidak digunakan lagi dan tidak dapat di-deploy lagi.
DRAFT Postur ini masih berupa draf dan belum siap di-deploy.
ACTIVE Postur sudah selesai dan siap di-deploy.

Metode

create

Membuat Posture baru.

delete

Menghapus semua revisi Posture.

extract

Mengekstrak kebijakan yang ada dari organisasi, folder, atau project, dan menerapkannya ke organisasi, folder, atau project lain sebagai Posture.

get

Mendapatkan satu revisi Posture.

list

Mencantumkan revisi terbaru dari semua resource Posture di organisasi dan lokasi yang ditentukan.

listRevisions

Mencantumkan semua revisi dari satu Posture.

patch

Memperbarui revisi Posture yang ada.