Method: organizations.locations.securityCenterServices.patch

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

Requête HTTP

PATCH https://securitycentermanagement.googleapis.com/v1/{securityCenterService.name=organizations/*/locations/*/securityCenterServices/*}

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
securityCenterService.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

Paramètres de requête

Paramètres
updateMask

string (FieldMask format)

Obligatoire. Champs à mettre à jour. Accepte les valeurs suivantes :

  • intendedEnablementState
  • modules

Si ce paramètre est omis, tous les champs éligibles sont mis à jour.

Il s'agit d'une liste de noms de champs complets séparés par une virgule. Exemple : "user.displayName,photo".
validateOnly

boolean

Facultatif. Si la valeur est true, la requête est validée (y compris les vérifications IAM), mais aucun service n'est mis à jour. Une réponse OK indique que la requête est valide, tandis qu'une réponse d'erreur indique qu'elle est non valide.

Si la requête est valide, une requête ultérieure de mise à jour du service peut toujours échouer pour l'une des raisons suivantes:

  • L'état de vos ressources cloud a changé (par exemple, vous avez perdu une autorisation IAM requise).
  • Une erreur s'est produite lors de la mise à jour du service

La valeur par défaut est false.

Corps de la requête

Le corps de la requête contient une instance de SecurityCenterService.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de SecurityCenterService.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.

Autorisations IAM

Nécessite l'autorisation IAM suivante sur la ressource name :

  • securitycentermanagement.securityCenterServices.update

Pour en savoir plus, consultez la documentation IAM.