REST Resource: folders.locations.securityCenterServices

Ressource: SecurityCenterService

Représente un service Security Command Center particulier. Cela inclut des informations sur les paramètres, telles que l'activation de niveau supérieur, en plus des paramètres de chaque module. Les paramètres du service peuvent être configurés au niveau de l'organisation, du dossier ou du projet. Les paramètres de service au niveau de l'organisation ou du dossier sont hérités par ceux des dossiers et des projets descendants.

Représentation JSON 
{
  "name": string,
  "intendedEnablementState": enum (EnablementState),
  "effectiveEnablementState": enum (EnablementState),
  "modules": {
    string: {
      object (ModuleSettings)
    },
    ...
  },
  "updateTime": string,
  "serviceConfig": {
    object
  }
}
Champs
name

string

Identifiant. Nom du service, dans l'un des formats suivants:

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

Les valeurs suivantes sont valides pour {service}:

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

enum (EnablementState)

Facultatif. État d'activation prévu pour le service au niveau de la hiérarchie des ressources. Un état DISABLED remplace tous les états d'activation du module par DISABLED.
effectiveEnablementState

enum (EnablementState)

Uniquement en sortie. État d'activation effectif du service au niveau de la hiérarchie des ressources. Si l'état prévu est défini sur INHERITED, l'état effectif est hérité de l'état d'activation d'un ancêtre. Cet état peut différer de l'état d'activation prévu en raison de l'éligibilité à la facturation ou de l'état d'intégration.
modules

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

Facultatif. Les configurations des modules, y compris l'état d'activation des modules du service. L'absence d'un module dans la carte implique que sa configuration est héritée de ses parents.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
updateTime

string (Timestamp format)

Uniquement en sortie. Heure de la dernière mise à jour du service. Cela peut être dû à une mise à jour explicite de l'utilisateur ou à un effet secondaire d'un autre changement système, comme l'expiration de l'abonnement de facturation.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
serviceConfig

object (Struct format)

Facultatif. Configuration supplémentaire spécifique au service. Ce champ n'est pas utilisé par tous les services.

EnablementState

Représente les états d'activation possibles pour un service ou un module.

Enums
ENABLEMENT_STATE_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
INHERITED L'état est hérité de la ressource parente. Valide en tant qu'état d'activation prévu, mais pas en tant qu'état d'activation effectif.
ENABLED L'état est activé.
DISABLED L'état est désactivé.
INGEST_ONLY Security Command Center est configuré pour ingérer les résultats de ce service, mais pas pour l'activer. Cet état indique que Security Command Center est mal configuré. Vous ne pouvez pas définir vous-même cet état.

ModuleSettings

Paramètres de chaque module.

Représentation JSON 
{
  "intendedEnablementState": enum (EnablementState),
  "effectiveEnablementState": enum (EnablementState)
}
Champs
intendedEnablementState

enum (EnablementState)

Facultatif. État d'activation prévu pour le module au niveau de la hiérarchie des ressources.
effectiveEnablementState

enum (EnablementState)

Uniquement en sortie. État d'activation effectif du module au niveau de la hiérarchie des ressources. Si l'état prévu est défini sur INHERITED, l'état effectif est hérité de l'état d'activation d'un ancêtre. Cet état peut différer de l'état d'activation prévu en raison de l'éligibilité à la facturation ou de l'état d'intégration.

Méthodes

get

 Récupère les paramètres de service pour le service Security Command Center spécifié.

list

 Renvoie la liste de tous les services Security Command Center pour le parent donné.

patch

 Met à jour un service Security Command Center à l'aide du masque de mise à jour donné.