REST Resource: projects.locations.deliveryPipelines.automationRuns

Recurso: AutomationRun

Un recurso AutomationRun en la API de Cloud Deploy

Un AutomationRun representa una instancia de ejecución de una regla de automatización.

Representación JSON
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "serviceAccount": string,
  "automationSnapshot": {
    object (Automation)
  },
  "targetId": string,
  "state": enum (State),
  "stateDescription": string,
  "expireTime": string,
  "ruleId": string,
  "automationId": string,
  "waitUntilTime": string,

  // Union field operation can be only one of the following:
  "promoteReleaseOperation": {
    object (PromoteReleaseOperation)
  },
  "advanceRolloutOperation": {
    object (AdvanceRolloutOperation)
  },
  "repairRolloutOperation": {
    object (RepairRolloutOperation)
  }
  // End of list of possible types for union field operation.
}
Campos
name

string

Solo salida. Es el nombre del AutomationRun. El formato es projects/{project}/locations/{location}/deliveryPipelines/{deliveryPipeline}/automationRuns/{automationRun}.

createTime

string (Timestamp format)

Solo salida. Hora a la que se creó el objeto AutomationRun.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Solo salida. Hora a la que se actualizó la automaticRun.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

etag

string

Solo salida. La ETag débil del recurso AutomationRun. El servidor calcula esta suma de comprobación en función del valor de otros campos, y es posible que se envíe en solicitudes de actualización y eliminación para garantizar que el cliente tenga un valor actualizado antes de continuar.

serviceAccount

string

Solo salida. Dirección de correo electrónico de la cuenta de servicio de IAM administrada por el usuario que realiza las operaciones en los recursos de Cloud Deploy.

automationSnapshot

object (Automation)

Solo salida. Instantánea de la automatización tomada en el momento de creación de AutomationRun.

targetId

string

Solo salida. El ID del destino que representa la etapa de promoción que inicia el AutomationRun. El valor de este campo es el último segmento del nombre de un destino.

state

enum (State)

Solo salida. Estado actual de AutomationRun.

stateDescription

string

Solo salida. Explica el estado actual de AutomationRun. Está presente solo cuando se necesita una explicación.

expireTime

string (Timestamp format)

Solo salida. Hora en que vence el AutomationRun. Un AutomationRun vence 14 días después de su fecha de creación.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

ruleId

string

Solo salida. El ID de la regla de automatización que inició la operación.

automationId

string

Solo salida. Es el ID de la automatización que inició la operación.

waitUntilTime

string (Timestamp format)

Solo salida. Es la hora más temprana en que se intentará reanudar AutomationRun. El tiempo de espera lo configura wait en la regla de automatización.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

Campo de unión operation. La operación que realizará AutomationRun. operation puede ser solo uno de los siguientes:
promoteReleaseOperation

object (PromoteReleaseOperation)

Solo salida. Promueve una versión a un "Destino" especificado.

advanceRolloutOperation

object (AdvanceRolloutOperation)

Solo salida. Avanzar un lanzamiento a la siguiente fase

repairRolloutOperation

object (RepairRolloutOperation)

Solo salida. Repara un "lanzamiento" con errores.

Estado

Es el estado válido de un AutomationRun.

Enums
STATE_UNSPECIFIED AutomationRun tiene un estado no especificado.
SUCCEEDED AutomationRun se realizó correctamente.
CANCELLED Se canceló el AutomationRun.
FAILED Se produjo un error con AutomationRun.
IN_PROGRESS La AutomationRun está en curso.
PENDING La AutomationRun está pendiente.
ABORTED Se anuló el AutomationRun.

PromoteReleaseOperation

Contiene la información de una operación automatizada de promoción y lanzamiento.

Representación JSON
{
  "targetId": string,
  "wait": string,
  "rollout": string,
  "phase": string
}
Campos
targetId

string

Solo salida. El ID del destino que representa la etapa de promoción a la que se promocionará la versión. El valor de este campo es el último segmento del nombre de un destino.

wait

string (Duration format)

Solo salida. El tiempo durante el que se detendrá la operación.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

rollout

string

Solo salida. El nombre del lanzamiento que inicia AutomationRun.

phase

string

Solo salida. La fase inicial del lanzamiento creado por esta operación.

AdvanceRolloutOperation

Contiene la información de una operación automática de lanzamiento avanzado.

Representación JSON
{
  "sourcePhase": string,
  "wait": string,
  "rollout": string,
  "destinationPhase": string
}
Campos
sourcePhase

string

Solo salida. La fase de una implementación que inició la operación.

wait

string (Duration format)

Solo salida. El tiempo durante el que se detendrá la operación.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

rollout

string

Solo salida. El nombre del lanzamiento que inicia AutomationRun.

destinationPhase

string

Solo salida. La fase a la que se avanzará el lanzamiento

RepairRolloutOperation

Contiene la información para una operación repair rollout automática.

Representación JSON
{
  "rollout": string,
  "currentRepairModeIndex": string,
  "repairPhases": [
    {
      object (RepairPhase)
    }
  ],
  "phaseId": string,
  "jobId": string
}
Campos
rollout

string

Solo salida. El nombre del lanzamiento que inicia AutomationRun.

currentRepairModeIndex

string (int64 format)

Solo salida. El índice de la acción de reparación actual en la secuencia de reparación.

repairPhases[]

object (RepairPhase)

Solo salida. Registros de los intentos de reparación. Cada fase de reparación puede tener varios reintentos o un solo intento de reversión.

phaseId

string

Solo salida. El ID de la fase que incluye el trabajo que se está reparando.

jobId

string

Solo salida. El ID del trabajo que se reparará.

RepairPhase

RepairFase realiza un seguimiento de los intentos de reparación realizados para cada RepairMode especificado en el recurso Automation.

Representación JSON
{

  // Union field repair_phase can be only one of the following:
  "retry": {
    object (RetryPhase)
  },
  "rollback": {
    object (RollbackAttempt)
  }
  // End of list of possible types for union field repair_phase.
}
Campos

Campo de unión repair_phase.

repair_phase puede ser una de las siguientes opciones:

retry

object (RetryPhase)

Solo salida. Registros de los reintentos para el modo de reparación de reintentos

rollback

object (RollbackAttempt)

Solo salida. Intento de reversión para el modo de reparación de reversión .

RetryPhase

RetryFase contiene los reintentos y los metadatos para iniciar un intento nuevo.

Representación JSON
{
  "totalAttempts": string,
  "backoffMode": enum (BackoffMode),
  "phaseId": string,
  "jobId": string,
  "attempts": [
    {
      object (RetryAttempt)
    }
  ]
}
Campos
totalAttempts

string (int64 format)

Solo salida. Es la cantidad de intentos que se realizaron.

backoffMode

enum (BackoffMode)

Solo salida. El patrón de cómo se calcula el tiempo de espera del reintento.

phaseId
(deprecated)

string

Solo salida. El ID de la fase que incluye el trabajo que se reintenta.

jobId
(deprecated)

string

Solo salida. El ID de tarea del trabajo que se debe reintentar.

attempts[]

object (RetryAttempt)

Solo salida. Detalle de una acción de reintento.

RetryAttempt

Reintentar representa una acción para reintentar el trabajo de Cloud Deploy con errores.

Representación JSON
{
  "attempt": string,
  "wait": string,
  "state": enum (RepairState),
  "stateDesc": string
}
Campos
attempt

string (int64 format)

Solo salida. El índice de este reintento.

wait

string (Duration format)

Solo salida. El tiempo durante el que se detendrá la operación.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

state

enum (RepairState)

Solo salida. Estado válido de esta acción de reintento.

stateDesc

string

Solo salida. Descripción del estado del reintento.

RepairState

Es el estado válido de un intento de reparación.

Enums
REPAIR_STATE_UNSPECIFIED repair tiene un estado no especificado.
REPAIR_STATE_SUCCEEDED Se completó correctamente la acción repair.
REPAIR_STATE_CANCELLED Se canceló la acción repair.
REPAIR_STATE_FAILED No se pudo realizar la acción repair.
REPAIR_STATE_IN_PROGRESS La acción repair está en curso.
REPAIR_STATE_PENDING La acción repair está pendiente.
REPAIR_STATE_SKIPPED Se omitió la acción repair.
REPAIR_STATE_ABORTED Se anuló la acción repair.

RollbackAttempt

RollbackAttempt representa una acción de revertir un “Target” de Cloud Deploy.

Representación JSON
{
  "destinationPhase": string,
  "rolloutId": string,
  "state": enum (RepairState),
  "stateDesc": string
}
Campos
destinationPhase

string

Solo salida. La fase a la que se revertirá el lanzamiento

rolloutId

string

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

state

enum (RepairState)

Solo salida. Estado válido de esta acción de reversión.

stateDesc

string

Solo salida. Descripción del estado de la reversión.

Métodos

cancel

Cancela un AutomationRun.

get

Obtiene detalles de un solo AutomationRun.

list

Muestra una lista de AutomationRuns en un proyecto y una ubicación determinados.