Method: projects.locations.targets.patch

Met à jour les paramètres d'une cible unique.

Requête HTTP

PATCH https://clouddeploy.googleapis.com/v1/{target.name=projects/*/locations/*/targets/*}

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
target.name

string

Facultatif. Nom du Target. Le format est le suivant : projects/{project}/locations/{location}/targets/{target}. Le composant target doit correspondre à [a-z]([a-z0-9-]{0,61}[a-z0-9])?

Paramètres de requête

Paramètres
updateMask

string (FieldMask format)

Obligatoire. Le masque de champ permet de spécifier les champs à remplacer dans la ressource cible par la mise à jour. Les champs spécifiés dans updateMask sont relatifs à la ressource, et non à la requête complète. Si un champ se trouve dans le masque, il sera remplacé. Si l'utilisateur ne fournit pas de masque, tous les champs sont é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 afin que, si vous devez relancer la requête, le serveur sache qu'il doit l'ignorer si elle est déjà terminée. Le serveur garantit que pendant au moins 60 minutes après la première requête.

Par exemple, imaginons que vous effectuez une requête initiale et que celle-ci expire. Si vous effectuez à nouveau la requête avec le même ID de requête, le serveur peut vérifier si une opération d'origine ayant le même ID de requête a été reçue et, le cas échéant, ignorer la deuxième requête. Ainsi, les clients ne peuvent pas créer accidentellement des engagements en double.

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

allowMissing

boolean

Facultatif. Si la valeur est "true", la mise à jour d'un Target qui n'existe pas entraînera la création d'un Target.

validateOnly

boolean

Facultatif. Si la valeur est "true", la requête est validée et l'utilisateur reçoit un résultat attendu, mais aucune modification réelle n'est apportée.

Corps de la requête

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

Corps de la réponse

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

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:

  • clouddeploy.targets.update

Pour en savoir plus, consultez la documentation IAM.