REST Resource: folders.locations.securityCenterServices

Recurso: SecurityCenterService

Representa un servicio específico de Security Command Center. Esto incluye información de configuración, como la habilitación de nivel superior, además de la configuración de módulos individuales. La configuración del servicio se puede establecer a nivel de la organización, la carpeta o el proyecto. Los parámetros de configuración de los servicios a nivel de la organización o la carpeta se heredan en las carpetas y los proyectos secundarios.

Representación JSON 
{
  "name": string,
  "intendedEnablementState": enum (EnablementState),
  "effectiveEnablementState": enum (EnablementState),
  "modules": {
    string: {
      object (ModuleSettings)
    },
    ...
  },
  "updateTime": string,
  "serviceConfig": {
    object
  }
}
Campos
name

string

Identificador. El nombre del servicio, en uno de los siguientes formatos:

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

Los siguientes valores son válidos para {service}:

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

enum (EnablementState)

Opcional. Es el estado de habilitación previsto para el servicio en su nivel de la jerarquía de recursos. Un estado DISABLED anulará todos los estados de habilitación de módulos a DISABLED.
effectiveEnablementState

enum (EnablementState)

Solo salida. Es el estado de habilitación efectivo del servicio en su nivel de la jerarquía de recursos. Si el estado deseado se establece en INHERITED, el estado efectivo se heredará del estado de habilitación de un ancestro. Este estado puede diferir del estado de habilitación previsto debido a la elegibilidad de facturación o al estado de integración.
modules

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

Opcional. Las configuraciones de los módulos, incluido el estado de habilitación de los módulos del servicio La ausencia de un módulo en el mapa implica que su configuración se hereda de sus elementos superiores.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
updateTime

string (Timestamp format)

Solo salida. La hora en la que se actualizó el servicio por última vez. Esto puede deberse a una actualización explícita del usuario o a un efecto secundario de otro cambio del sistema, como el vencimiento de la suscripción de facturación.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
serviceConfig

object (Struct format)

Opcional. Configuración adicional específica del servicio No todos los servicios usarán este campo.

EnablementState

Representa los posibles estados de habilitación de un servicio o módulo.

Enums
ENABLEMENT_STATE_UNSPECIFIED Valor predeterminado Este valor no se usa.
INHERITED El estado se hereda del recurso superior. Es válido como estado de habilitación previsto, pero no como estado de habilitación vigente.
ENABLED El estado está habilitado.
DISABLED El estado está inhabilitado.
INGEST_ONLY Security Command Center está configurado para transferir los resultados de este servicio, pero no para habilitarlo. Este estado indica que Security Command Center está mal configurado. No puedes establecer este estado por tu cuenta.

ModuleSettings

La configuración de los módulos individuales

Representación JSON 
{
  "intendedEnablementState": enum (EnablementState),
  "effectiveEnablementState": enum (EnablementState)
}
Campos
intendedEnablementState

enum (EnablementState)

Opcional. Es el estado de habilitación previsto para el módulo en su nivel de la jerarquía de recursos.
effectiveEnablementState

enum (EnablementState)

Solo salida. Es el estado de habilitación efectivo del módulo en su nivel de la jerarquía de recursos. Si el estado deseado se establece en INHERITED, el estado efectivo se heredará del estado de habilitación de un ancestro. Este estado puede diferir del estado de habilitación previsto debido a la elegibilidad de facturación o al estado de integración.

Métodos

get

 Obtiene la configuración del servicio para el servicio de Security Command Center especificado.

list

 Muestra una lista de todos los servicios de Security Command Center para la entidad superior especificada.

patch

 Actualiza un servicio de Security Command Center con la máscara de actualización proporcionada.