Method: projects.locations.deliveryPipelines.rollbackTarget

Crea un Rollout para revertir el destino especificado.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
name

string

Obligatorio. El DeliveryPipeline para el que se debe crear la reversión Rollout. El formato debe ser projects/{projectId}/locations/{location_name}/deliveryPipelines/{pipeline_name}.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON
{
  "targetId": string,
  "rolloutId": string,
  "releaseId": string,
  "rolloutToRollBack": string,
  "rollbackConfig": {
    object (RollbackTargetConfig)
  },
  "validateOnly": boolean
}
Campos
targetId

string

Obligatorio. ID de la Target que se está revirtiendo.

rolloutId

string

Obligatorio. ID de la reversión Rollout que se creará.

releaseId

string

Opcional. ID de la Release a la que se revertirá. Si no se especifica, se usará el Rollout correcto anterior al objetivo especificado para determinar el Release.

rolloutToRollBack

string

Opcional. Si se proporciona, debe ser el Rollout más reciente que esté en Target.

rollbackConfig

object (RollbackTargetConfig)

Opcional. Parámetros de configuración para la reversión Rollout.

validateOnly

boolean

Opcional. Si se configura como verdadera, la solicitud se valida y el usuario recibe un RollbackTargetResponse.

Cuerpo de la respuesta

El objeto de respuesta de deliveryPipelines.rollbackTarget.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON
{
  "rollbackConfig": {
    object (RollbackTargetConfig)
  }
}
Campos
rollbackConfig

object (RollbackTargetConfig)

La configuración de la reversión Rollout creada o que se creará.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • clouddeploy.rollouts.rollback

Para obtener más información, consulta la documentación de IAM.

RollbackTargetConfig

Parámetros de configuración para el lanzamiento de reversión.

Representación JSON
{
  "rollout": {
    object (Rollout)
  },
  "startingPhaseId": string
}
Campos
rollout

object (Rollout)

Opcional. La reversión Rollout que se creará.

startingPhaseId

string

Opcional. El ID de fase inicial para Rollout. Si no se especifica, Rollout comenzará en la fase estable.