Method: projects.locations.deliveryPipelines.rollbackTarget

Crée un Rollout pour effectuer un rollback de la cible spécifiée.

Requête HTTP

POST https://clouddeploy.googleapis.com/v1/{name=projects/*/locations/*/deliveryPipelines/*}:rollbackTarget

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Le DeliveryPipeline pour lequel le Rollout de rollback doit être créé. Le format doit être le suivant : projects/{projectId}/locations/{location_name}/deliveryPipelines/{pipeline_name}.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON
{
  "targetId": string,
  "rolloutId": string,
  "releaseId": string,
  "rolloutToRollBack": string,
  "rollbackConfig": {
    object (RollbackTargetConfig)
  },
  "validateOnly": boolean
}
Champs
targetId

string

Obligatoire. ID de l'objet Target faisant l'objet d'un rollback.

rolloutId

string

Obligatoire. ID du Rollout de rollback à créer.

releaseId

string

Facultatif. ID du Release sur lequel effectuer le rollback. Si cette valeur n'est pas spécifiée, la valeur Rollout ayant réussi précédemment pour la cible spécifiée sera utilisée pour déterminer la valeur Release.

rolloutToRollBack

string

Facultatif. Si ce champ est fourni, il doit s'agir de la dernière version de Rollout spécifiée dans le Target.

rollbackConfig

object (RollbackTargetConfig)

Facultatif. Configurations pour le rollback Rollout.

validateOnly

boolean

Facultatif. Si la valeur est "true", la requête est validée et l'utilisateur reçoit une RollbackTargetResponse.

Corps de la réponse

Objet de réponse de deliveryPipelines.rollbackTarget.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "rollbackConfig": {
    object (RollbackTargetConfig)
  }
}
Champs
rollbackConfig

object (RollbackTargetConfig)

La configuration du Rollout de rollback a été créée ou sera créée.

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.rollouts.rollback

Pour en savoir plus, consultez la documentation IAM.

RollbackTargetConfig

Configurations pour le déploiement du rollback.

Représentation JSON
{
  "rollout": {
    object (Rollout)
  },
  "startingPhaseId": string
}
Champs
rollout

object (Rollout)

Facultatif. Rollout de rollback à créer.

startingPhaseId

string

Facultatif. ID de la phase de début pour Rollout. Si aucune valeur n'est spécifiée, Rollout démarrera dans la phase stable.