REST Resource: folders.locations.securityCenterServices

Resource: SecurityCenterService

Merepresentasikan layanan Security Command Center tertentu. Hal ini mencakup informasi setelan seperti pengaktifan tingkat teratas selain setelan modul individual. Setelan layanan dapat dikonfigurasi di tingkat organisasi, folder, atau project. Setelan layanan di tingkat organisasi atau folder diwariskan oleh setelan di folder dan project turunan.

Representasi JSON 
{
  "name": string,
  "intendedEnablementState": enum (EnablementState),
  "effectiveEnablementState": enum (EnablementState),
  "modules": {
    string: {
      object (ModuleSettings)
    },
    ...
  },
  "updateTime": string,
  "serviceConfig": {
    object
  }
}
Kolom
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
intendedEnablementState

enum (EnablementState)

Opsional. Status pengaktifan yang diinginkan untuk layanan di tingkat hierarki resource-nya. Status DISABLED akan mengganti semua status pengaktifan modul menjadi DISABLED.
effectiveEnablementState

enum (EnablementState)

Hanya output. Status pengaktifan yang efektif untuk layanan di tingkat hierarki resource-nya. Jika status yang diinginkan disetel ke INHERITED, status yang efektif akan diwarisi dari status pengaktifan ancestor. Status ini mungkin berbeda dengan status pengaktifan yang diinginkan karena status orientasi atau kelayakan penagihan.
modules

map (key: string, value: object (ModuleSettings))

Opsional. Konfigurasi modul, termasuk status pengaktifan untuk modul layanan. Tidak adanya modul di peta menyiratkan bahwa konfigurasinya diwarisi dari induknya.

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

string (Timestamp format)

Hanya output. Waktu layanan terakhir diperbarui. Hal ini dapat terjadi karena pembaruan pengguna yang eksplisit atau karena efek samping dari perubahan sistem lain, seperti habis masa berlaku langganan penagihan.

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".
serviceConfig

object (Struct format)

Opsional. Konfigurasi khusus layanan tambahan. Tidak semua layanan akan menggunakan kolom ini.

EnablementState

Merepresentasikan kemungkinan status pengaktifan untuk layanan atau modul.

Enum
ENABLEMENT_STATE_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
INHERITED Status diwarisi dari resource induk. Valid sebagai status pengaktifan yang diinginkan, tetapi tidak valid sebagai status pengaktifan yang efektif.
ENABLED Status diaktifkan.
DISABLED Status dinonaktifkan.
INGEST_ONLY Security Command Center dikonfigurasi untuk menyerap temuan dari layanan ini, tetapi tidak untuk mengaktifkan layanan ini. Status ini menunjukkan bahwa Security Command Center salah dikonfigurasi. Anda tidak dapat menetapkan status ini sendiri.

ModuleSettings

Setelan untuk setiap modul.

Representasi JSON 
{
  "intendedEnablementState": enum (EnablementState),
  "effectiveEnablementState": enum (EnablementState)
}
Kolom
intendedEnablementState

enum (EnablementState)

Opsional. Status pengaktifan yang diinginkan untuk modul pada tingkat hierarki resource-nya.
effectiveEnablementState

enum (EnablementState)

Hanya output. Status pengaktifan yang efektif untuk modul pada tingkat hierarki resource-nya. Jika status yang diinginkan disetel ke INHERITED, status yang efektif akan diwarisi dari status pengaktifan ancestor. Status ini mungkin berbeda dengan status pengaktifan yang diinginkan karena status orientasi atau kelayakan penagihan.

Metode

get

 Mendapatkan setelan layanan untuk layanan Security Command Center yang ditentukan.

list

 Menampilkan daftar semua layanan Security Command Center untuk induk yang ditentukan.

patch

 Memperbarui layanan Security Command Center menggunakan mask pembaruan yang diberikan.