- Requête HTTP
- Paramètres de chemin d'accès
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- Autorisations IAM
- Essayer
Crée une cible dans un projet et un emplacement donnés.
Requête HTTP
POST https://clouddeploy.googleapis.com/v1/{parent=projects/*/locations/*}/targets
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
parent |
Obligatoire. Collection parente dans laquelle créer le |
Paramètres de requête
Paramètres | |
---|---|
targetId |
Obligatoire. ID de |
requestId |
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é. |
validateOnly |
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 nouvelle 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 parent
:
clouddeploy.targets.create
Pour en savoir plus, consultez la documentation IAM.