Method: projects.locations.deliveryPipelines.rollbackTarget

Erstellt einen Rollout für das Rollback des angegebenen Ziels.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Die DeliveryPipeline, für die das Rollback-Rollout erstellt werden soll. Verwenden Sie das Format projects/{projectId}/locations/{location_name}/deliveryPipelines/{pipeline_name}.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "targetId": string,
  "rolloutId": string,
  "releaseId": string,
  "rolloutToRollBack": string,
  "rollbackConfig": {
    object (RollbackTargetConfig)
  },
  "validateOnly": boolean
}
Felder
targetId

string

Erforderlich. ID der Target, für die ein Rollback durchgeführt wird.
rolloutId

string

Erforderlich. ID des zu erstellenden Rollback-Rollout.
releaseId

string

Optional. ID des Release, auf den das Rollback durchgeführt werden soll. Wenn dies nicht festgelegt ist, wird der vorherige erfolgreiche Rollout für das angegebene Ziel verwendet, um Release zu bestimmen.
rolloutToRollBack

string

Optional. Falls angegeben, muss dies der letzte Rollout sein, der sich im Target befindet.
rollbackConfig

object (RollbackTargetConfig)

Optional. Konfigurationen für das Rollback Rollout.
validateOnly

boolean

Optional. Wenn die Richtlinie auf „true“ gesetzt ist, wird die Anfrage validiert und der Nutzer erhält eine RollbackTargetResponse.

Antworttext

Das Antwortobjekt aus deliveryPipelines.rollbackTarget.

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

JSON-Darstellung 
{
  "rollbackConfig": {
    object (RollbackTargetConfig)
  }
}
Felder
rollbackConfig

object (RollbackTargetConfig)

Die Konfiguration des Rollback-Rollout, der erstellt wurde oder wird.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource name:

  • clouddeploy.rollouts.rollback

Weitere Informationen finden Sie in der IAM-Dokumentation.

RollbackTargetConfig

Konfigurationen für das Rollback-Rollout.

JSON-Darstellung 
{
  "rollout": {
    object (Rollout)
  },
  "startingPhaseId": string
}
Felder
rollout

object (Rollout)

Optional. Die zu erstellende Rollback-Rollout.
startingPhaseId

string

Optional. Die Startphasen-ID für den Rollout. Wenn keine Vorgabe erfolgt, beginnt Rollout in der stabilen Phase.