Method: organizations.locations.securityHealthAnalyticsCustomModules.patch

Met à jour le SecurityHealthAnalyticsCustomModule sous le nom donné en fonction du masque de mise à jour donné. La mise à jour de l'état d'activation est compatible avec les modules résidents et hérités (bien que les modules résidents ne puissent pas avoir un état d'activation "hérité"). La modification du nom à afficher et de la configuration personnalisée d'un module n'est possible que pour les modules résidents.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
securityHealthAnalyticsCustomModule.name

string

Identifiant. Nom de ressource complet du module personnalisé, dans l'un des formats suivants:

  • organizations/{organization}/locations/{location}/securityHealthAnalyticsCustomModules/{custom_module}
  • folders/{folder}/locations/{location}/securityHealthAnalyticsCustomModules/{custom_module}
  • projects/{project}/locations/{location}/securityHealthAnalyticsCustomModules/{custom_module}

Paramètres de requête

Paramètres
updateMask

string (FieldMask format)

Obligatoire. Champs à mettre à jour. Les valeurs suivantes sont valides:

  • customConfig
  • enablementState

Si vous omettez ce champ ou le définissez sur la valeur générique *, 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. Lorsque cette valeur est définie sur true, la requête est validée (y compris les vérifications IAM), mais aucun module 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 module 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 création du module

La valeur par défaut est false.

Corps de la requête

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

Corps de la réponse

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

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.securityHealthAnalyticsCustomModules.update

Pour en savoir plus, consultez la documentation IAM.