Method: folders.locations.securityHealthAnalyticsCustomModules.patch

Memperbarui SecurityHealthAnalyticsCustomModule dengan nama yang diberikan berdasarkan mask update yang diberikan. Memperbarui status pengaktifan didukung pada modul tetap dan modul yang diwarisi (meskipun modul tetap tidak dapat memiliki status pengaktifan "diwarisi"). Memperbarui nama tampilan dan konfigurasi kustom modul hanya didukung di modul resident.

Permintaan HTTP

PATCH https://securitycentermanagement.googleapis.com/v1/{securityHealthAnalyticsCustomModule.name=folders/*/locations/*/securityHealthAnalyticsCustomModules/*}

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
securityHealthAnalyticsCustomModule.name

string

ID. Nama resource lengkap modul kustom, dalam salah satu format berikut:

  • organizations/{organization}/locations/{location}/securityHealthAnalyticsCustomModules/{custom_module}
  • folders/{folder}/locations/{location}/securityHealthAnalyticsCustomModules/{custom_module}
  • projects/{project}/locations/{location}/securityHealthAnalyticsCustomModules/{custom_module}

Parameter kueri

Parameter
updateMask

string (FieldMask format)

Wajib. Kolom yang akan diperbarui. Nilai berikut valid:

  • customConfig
  • enablementState

Jika Anda menghapus kolom ini atau menetapkannya ke nilai karakter pengganti *, semua kolom yang memenuhi syarat akan diperbarui.

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

boolean

Opsional. Jika disetel ke true, permintaan akan divalidasi (termasuk pemeriksaan IAM), tetapi tidak ada modul yang akan diupdate. Respons OK menunjukkan bahwa permintaan valid, sedangkan respons error menunjukkan bahwa permintaan tidak valid.

Jika permintaan valid, permintaan berikutnya untuk mengupdate modul masih dapat gagal karena salah satu alasan berikut:

  • Status resource cloud Anda berubah; misalnya, Anda kehilangan izin IAM yang diperlukan
  • Terjadi error saat membuat modul

Nilai defaultnya adalah false.

Isi permintaan

Isi permintaan memuat instance SecurityHealthAnalyticsCustomModule.

Isi respons

Jika berhasil, isi respons akan berisi instance SecurityHealthAnalyticsCustomModule.

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:

  • securitycentermanagement.securityHealthAnalyticsCustomModules.update

Untuk mengetahui informasi selengkapnya, lihat dokumentasi IAM.