Method: projects.locations.networkPolicies.patch

Modifie une ressource NetworkPolicy. Seuls les champs suivants peuvent être mis à jour : internetAccess, externalIp et edgeServicesCidr. Seuls les champs spécifiés dans updateMask sont appliqués. Lorsque vous mettez à jour une règle de réseau, le service réseau d'adresses IP externes ne peut être désactivé que si aucune adresse IP externe n'est présente dans le champ d'application de la règle. De plus, un NetworkService ne peut pas être mis à jour lorsque NetworkService.state est défini sur RECONCILING.

Pendant le traitement de l'opération, la ressource est temporairement à l'état ACTIVE avant que l'opération ne soit entièrement terminée. Pendant cette période, vous ne pouvez pas mettre à jour la ressource. Utilisez l'état de l'opération pour déterminer quand le traitement est terminé.

Requête HTTP

PATCH https://vmwareengine.googleapis.com/v1/{networkPolicy.name=projects/*/locations/*/networkPolicies/*}

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
networkPolicy.name

string

Uniquement en sortie. Identifiant. Nom de ressource de cette règle de réseau. Les noms de ressources sont des URI sans schéma qui suivent les conventions décrites sur https://cloud.google.com/apis/design/resource_names. Par exemple : projects/my-project/locations/us-central1/networkPolicies/my-network-policy

Paramètres de requête

Paramètres
updateMask

string (FieldMask format)

Obligatoire. Le masque de champ permet de spécifier les champs à écraser dans la ressource NetworkPolicy lors de la mise à jour. Les champs spécifiés dans le paramètre updateMask sont relatifs à la ressource, et non à la requête complète. Un champ sera écrasé s'il figure dans le masque. Si l'utilisateur ne fournit pas de masque, tous les champs seront écrasés.

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

requestId

string

Facultatif. ID de requête permettant d'identifier les requêtes. Spécifiez un ID de requête unique pour indiquer au serveur d'ignorer la requête si vous devez la relancer alors qu'elle a déjà été traitée. Le serveur garantit qu'une requête n'entraîne pas la création d'engagements en double pendant au moins 60 minutes.

Imaginons que vous effectuez une requête initiale et que celle-ci expire. Si vous effectuez de nouveau la requête avec le même ID, le serveur peut vérifier si une opération initiale avec cet ID de requête a déjà été reçue et, si c'est le cas, ignorer la deuxième requête. Cela permet d'éviter que les clients ne créent accidentellement des engagements en double.

L'ID de requête doit être un UUID valide, sachant qu'un UUID égal à zéro (00000000-0000-0000-0000-000000000000) n'est pas accepté.

Corps de la requête

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

Corps de la réponse

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

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la Authentication Overview.