REST Resource: folders.locations.securityCenterServices

Risorsa: SecurityCenterService

Rappresenta un determinato servizio Security Command Center. Sono incluse informazioni sulle impostazioni, come l'attivazione di primo livello, oltre alle impostazioni dei singoli moduli. Le impostazioni dei servizi possono essere configurate a livello di organizzazione, cartella o progetto. Le impostazioni dei servizi a livello di organizzazione o di cartella vengono ereditate da quelle nelle cartelle e nei progetti discendenti.

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

string

Identificatore. Il nome del servizio, in uno dei seguenti formati:

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

I seguenti valori sono validi per {service}:

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

enum (EnablementState)

Facoltativo. Lo stato di abilitazione previsto per il servizio al suo livello della gerarchia delle risorse. Uno stato DISABLED sostituirà tutti gli stati di abilitazione del modulo con DISABLED.
effectiveEnablementState

enum (EnablementState)

Solo output. Lo stato di abilitazione effettivo del servizio al suo livello della gerarchia delle risorse. Se lo stato previsto è impostato su INHERITED, lo stato effettivo verrà ereditato dallo stato di attivazione di un elemento antecedente. Questo stato potrebbe essere diverso dallo stato di attivazione previsto a causa dell'idoneità alla fatturazione o dello stato di onboarding.
modules

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

Facoltativo. Le configurazioni dei moduli, incluso lo stato di abilitazione dei moduli del servizio. L'assenza di un modulo nella mappa implica che la relativa configurazione viene ereditata dai moduli principali.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
updateTime

string (Timestamp format)

Solo output. L'ora dell'ultimo aggiornamento del servizio. Ciò potrebbe essere dovuto a un aggiornamento esplicito dell'utente o a un effetto collaterale di un'altra modifica del sistema, ad esempio la scadenza dell'abbonamento alla fatturazione.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
serviceConfig

object (Struct format)

Facoltativo. Configurazione aggiuntiva specifica del servizio. Non tutti i servizi utilizzeranno questo campo.

EnablementState

Rappresenta i possibili stati di abilitazione per un servizio o un modulo.

Enum
ENABLEMENT_STATE_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
INHERITED Lo stato viene ereditato dalla risorsa principale. Valido come stato di abilitazione previsto, ma non come stato di abilitazione effettivo.
ENABLED Lo stato è attivo.
DISABLED Lo stato è disattivato.
INGEST_ONLY Security Command Center è configurato per importare i risultati di questo servizio, ma non per attivarlo. Questo stato indica che Security Command Center non è configurato correttamente. Non puoi impostare questo stato autonomamente.

ModuleSettings

Le impostazioni dei singoli moduli.

Rappresentazione JSON 
{
  "intendedEnablementState": enum (EnablementState),
  "effectiveEnablementState": enum (EnablementState)
}
Campi
intendedEnablementState

enum (EnablementState)

Facoltativo. Lo stato di abilitazione previsto per il modulo al suo livello della gerarchia delle risorse.
effectiveEnablementState

enum (EnablementState)

Solo output. Lo stato di attivazione effettivo del modulo al suo livello della gerarchia di risorse. Se lo stato previsto è impostato su INHERITED, lo stato effettivo verrà ereditato dallo stato di attivazione di un elemento antecedente. Questo stato potrebbe essere diverso dallo stato di attivazione previsto a causa dell'idoneità alla fatturazione o dello stato di onboarding.

Metodi

get

 Recupera le impostazioni del servizio per il servizio Security Command Center specificato.

list

 Restituisce un elenco di tutti i servizi di Security Command Center per l'organizzazione principale specificata.

patch

 Aggiorna un servizio Security Command Center utilizzando la maschera di aggiornamento specificata.