Method: organizations.locations.postures.patch

Memperbarui revisi Posture yang ada.

Jika revisi postur yang Anda perbarui saat ini di-deploy, revisi postur baru akan dibuat.

Untuk mencegah update serentak saling menimpa, selalu ikuti pola baca-ubah-tulis saat Anda memperbarui postur:

  1. Panggil postures.get untuk mendapatkan versi postur saat ini.
  2. Perbarui kolom dalam postur sesuai kebutuhan.
  3. Panggil postures.patch untuk memperbarui postur. Pastikan permintaan Anda menyertakan nilai etag dari respons postures.get.

Penting: Jika Anda menghilangkan etag saat memanggil postures.patch, postur yang diperbarui akan menimpa postur yang ada tanpa syarat.

Permintaan HTTP

PATCH https://securityposture.googleapis.com/v1/{posture.name=organizations/*/locations/*/postures/*}

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
posture.name

string

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

Parameter kueri

Parameter
updateMask

string (FieldMask format)

Wajib. Kolom di Posture yang akan diperbarui.

Anda hanya dapat memperbarui kolom berikut:

Ini adalah daftar dipisahkan koma yang berisi nama-nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo".
revisionId

string

Wajib. ID revisi postur yang akan diperbarui.

Jika revisi postur yang Anda perbarui saat ini di-deploy, revisi postur baru akan dibuat.

Isi permintaan

Isi permintaan memuat instance Posture.

Isi respons

Jika berhasil, isi respons akan berisi instance Operation.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.

Izin IAM

Memerlukan izin IAM berikut pada resource name:

  • securityposture.postures.update

Untuk mengetahui informasi selengkapnya, lihat dokumentasi IAM.