REST Resource: folders.locations.securityCenterServices

Ressource: SecurityCenterService

Stellt einen bestimmten Security Command Center-Dienst dar. Dazu gehören neben den Einstellungen für einzelne Module auch Informationen zu Einstellungen auf oberster Ebene. Diensteinstellungen können auf Organisations-, Ordner- oder Projektebene konfiguriert werden. Diensteinstellungen auf Organisations- oder Ordnerebene werden von untergeordneten Ordnern und Projekten übernommen.

JSON-Darstellung 
{
  "name": string,
  "intendedEnablementState": enum (EnablementState),
  "effectiveEnablementState": enum (EnablementState),
  "modules": {
    string: {
      object (ModuleSettings)
    },
    ...
  },
  "updateTime": string,
  "serviceConfig": {
    object
  }
}
Felder
name

string

Kennung. Der Name des Dienstes in einem der folgenden Formate:

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

Die folgenden Werte sind für {service} zulässig:

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

enum (EnablementState)

Optional. Der beabsichtigte Aktivierungsstatus für den Dienst auf seiner Ebene in der Ressourcenhierarchie. Bei einem Status von DISABLED werden alle Modulaktivierungsstatus durch DISABLED überschrieben.
effectiveEnablementState

enum (EnablementState)

Nur Ausgabe. Der aktuelle Aktivierungsstatus des Dienstes auf seiner Ebene in der Ressourcenhierarchie. Wenn der gewünschte Status auf INHERITED festgelegt ist, wird der effektive Status vom Aktivierungsstatus eines übergeordneten Elements übernommen. Dieser Status kann aufgrund der Abrechnungsvoraussetzungen oder des Onboarding-Status vom gewünschten Aktivierungsstatus abweichen.
modules

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

Optional. Die Modulkonfigurationen, einschließlich des Aktivierungsstatus für die Module des Dienstes. Wenn ein Modul nicht in der Karte enthalten ist, wird seine Konfiguration von den übergeordneten Elementen übernommen.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem der Dienst zuletzt aktualisiert wurde. Das kann auf eine explizite Nutzeraktualisierung oder auf einen Nebeneffekt einer anderen Systemänderung zurückzuführen sein, z. B. auf das Ablaufen des Abrechnungsabos.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
serviceConfig

object (Struct format)

Optional. Zusätzliche dienstspezifische Konfiguration. Dieses Feld wird nicht von allen Diensten verwendet.

EnablementState

Stellt die möglichen Aktivierungsstatus für einen Dienst oder ein Modul dar.

Enums
ENABLEMENT_STATE_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
INHERITED Der Status wird von der übergeordneten Ressource übernommen. Gültig als beabsichtigter Aktivierungsstatus, aber nicht als effektiver Aktivierungsstatus.
ENABLED Der Status ist aktiviert.
DISABLED Der Status ist deaktiviert.
INGEST_ONLY Security Command Center ist so konfiguriert, dass Ergebnisse aus diesem Dienst aufgenommen werden, der Dienst aber nicht aktiviert wird. Dieser Status zeigt an, dass Security Command Center falsch konfiguriert ist. Sie können diesen Status nicht selbst festlegen.

ModuleSettings

Die Einstellungen für einzelne Module.

JSON-Darstellung 
{
  "intendedEnablementState": enum (EnablementState),
  "effectiveEnablementState": enum (EnablementState)
}
Felder
intendedEnablementState

enum (EnablementState)

Optional. Der beabsichtigte Aktivierungsstatus für das Modul auf seiner Ebene in der Ressourcenhierarchie.
effectiveEnablementState

enum (EnablementState)

Nur Ausgabe. Der effektive Aktivierungsstatus für das Modul auf seiner Ebene in der Ressourcenhierarchie. Wenn der gewünschte Status auf INHERITED festgelegt ist, wird der effektive Status vom Aktivierungsstatus eines übergeordneten Elements übernommen. Dieser Status kann aufgrund der Abrechnungsvoraussetzungen oder des Onboarding-Status vom gewünschten Aktivierungsstatus abweichen.

Methoden

get

 Ruft die Diensteinstellungen für den angegebenen Security Command Center-Dienst ab.

list

 Gibt eine Liste aller Security Command Center-Dienste für das angegebene übergeordnete Element zurück.

patch

 Aktualisiert einen Security Command Center-Dienst mit der angegebenen Aktualisierungsmaske.