Method: folders.locations.securityCenterServices.patch

Memperbarui layanan Security Command Center menggunakan mask pembaruan yang diberikan.

Permintaan HTTP

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

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
securityCenterService.name

string

ID. Nama layanan, dalam salah satu format berikut:

  • organizations/{organization}/locations/{location}/securityCenterServices/{service}
  • folders/{folder}/locations/{location}/securityCenterServices/{service}
  • projects/{project}/locations/{location}/securityCenterServices/{service}

Nilai berikut valid untuk {service}:

  • container-threat-detection
  • event-threat-detection
  • security-health-analytics
  • vm-threat-detection
  • web-security-scanner

Parameter kueri

Parameter
updateMask

string (FieldMask format)

Wajib. Kolom yang akan diperbarui. Menerima nilai berikut:

  • intendedEnablementState
  • modules

Jika dihilangkan, 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 ditetapkan ke true, permintaan akan divalidasi (termasuk pemeriksaan IAM), tetapi tidak ada layanan yang akan diperbarui. Respons OK menunjukkan bahwa permintaan valid, sedangkan respons error menunjukkan bahwa permintaan tidak valid.

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

  • Status resource cloud Anda berubah; misalnya, Anda kehilangan izin IAM yang diperlukan
  • Terjadi error selama update layanan

Nilai defaultnya adalah false.

Isi permintaan

Isi permintaan memuat instance SecurityCenterService.

Isi respons

Jika berhasil, isi respons akan berisi instance SecurityCenterService.

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.securityCenterServices.update

Untuk mengetahui informasi selengkapnya, lihat dokumentasi IAM.