

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Gestión de eventos de Deadline Cloud mediante Amazon EventBridge
<a name="eventbridge-integration"></a>

Amazon EventBridge es un servicio sin servidor que utiliza eventos para conectar los componentes de la aplicación, lo que facilita la creación de aplicaciones escalables basadas en eventos. La arquitectura basada en eventos es un estilo de creación de sistemas de software de acoplamiento flexible que funcionan juntos emitiendo eventos y respondiendo a ellos. Los eventos representan un cambio en un recurso o entorno. 

Así es como funciona:

Como ocurre con muchos AWS servicios, Deadline Cloud genera y envía eventos al bus de eventos EventBridge predeterminado. (El bus de eventos predeterminado se aprovisiona automáticamente en todas las AWS cuentas). Un bus de eventos es un enrutador que recibe eventos y los envía a cero o más destinos u *objetivos*. Las reglas que se especifican al bus de eventos evalúan los eventos a medida que llegan. Cada regla comprueba si un evento coincide con el *patrón de evento* de la regla. Si el evento coincide, el bus de eventos envía el evento a los destinos especificados.

![\[AWS los servicios envían los eventos al bus de eventos EventBridge predeterminado. Si el evento coincide con el patrón de eventos de una regla, EventBridge envía el evento a los destinos especificados para esa regla.\]](http://docs.aws.amazon.com/es_es/deadline-cloud/latest/developerguide/images/eventbridge-integration-how-it-works.png)


**Topics**
+ [Eventos de Deadline Cloud](#supported-events)
+ [Entregar eventos de Deadline Cloud mediante EventBridge reglas](#eventbridge-using-events-rules)
+ [Referencia detallada de los eventos de Deadline Cloud](events-detail-reference.md)

## Eventos de Deadline Cloud
<a name="supported-events"></a>

Deadline Cloud envía automáticamente los siguientes eventos al bus de EventBridge eventos predeterminado. Los eventos que coinciden con el patrón de eventos de una regla se envían a los destinos especificados de la [mejor manera posible](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html#eb-service-event-delivery-level). Es posible que los eventos se entreguen fuera de servicio.

Para obtener más información, consulte [Eventos de EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) en la *Guía del usuario de Amazon EventBridge *.


| Tipo de detalle del evento | Description (Descripción) | 
| --- | --- | 
|  [Se ha alcanzado el umbral presupuestario](events-detail-reference.md#event-detail-budget-threshold-reached)  |  Se envía cuando una cola alcanza un porcentaje del presupuesto asignado. | 
|  [Cambio de estado del ciclo de vida del trabajo](events-detail-reference.md#event-detail-job-lifecycle-status-change)  |   Se envía cuando se produce un cambio en el estado del ciclo de vida de un trabajo. | 
|  [Cambio de estado de ejecución de una tarea](events-detail-reference.md#event-detail-job-run-status-change)  |  Se envía cuando cambia el estado general de las tareas de un trabajo. | 
|  [Cambio de estado del ciclo de vida escalonado](events-detail-reference.md#event-detail-step-lifecycle-status-change)  |  Se envía cuando se produce un cambio en el estado del ciclo de vida de un paso de una tarea. | 
|  [Paso: Ejecutar: cambio de estado](events-detail-reference.md#event-detail-step-run-status-change)  |  Se envía cuando cambia el estado general de las tareas de un paso. | 
|  [Cambio de estado de ejecución de la tarea](events-detail-reference.md#event-detail-task-run-status-change)  |  Se envía cuando cambia el estado de una tarea. | 

## Entregar eventos de Deadline Cloud mediante EventBridge reglas
<a name="eventbridge-using-events-rules"></a>

Para que el bus de eventos EventBridge predeterminado envíe los eventos de Deadline Cloud a un destino, debes crear una regla. Cada regla contiene un patrón de eventos que EventBridge coincide con cada evento recibido en el bus de eventos. Si los datos del evento coinciden con el patrón de eventos especificado, EventBridge envía ese evento a los objetivos de la regla.

Para obtener instrucciones detalladas sobre cómo crear reglas de bus de eventos, consulte [Creación de reglas que reaccionan a eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) en la *Guía del usuario de EventBridge *.

### Crear patrones de eventos que coincidan con los eventos de Deadline Cloud
<a name="eventbridge-using-events-rules-patterns"></a>

Cada patrón de eventos es un objeto JSON que contiene:
+ Un atributo `source` que identifica el servicio que envía el evento. En el caso de los eventos de Deadline Cloud, la fuente es`aws.deadline`.
+ (Opcional): un atributo `detail-type` que contiene una matriz de los tipos de eventos que deben coincidir.
+ (Opcional): un atributo `detail` que contiene cualquier otro dato de evento con el que coincidir.

Por ejemplo, el siguiente patrón de eventos coincide con todos los eventos de cambio de tamaño de flota recomendados `farmId` para Deadline Cloud:

```
{
  "source": ["aws.deadline"],
  "detail-type": ["Fleet Size Recommendation Change"],
  "detail": {
     "farmId": "farm-12345678900000000000000000000000"
  }
}
```

Para obtener más información sobre la escritura de los patrones de eventos, consulte [Patrones de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) en la *Guía del usuario de EventBridge *.

# Referencia detallada de los eventos de Deadline Cloud
<a name="events-detail-reference"></a>

Todos los eventos de los AWS servicios tienen un conjunto común de campos que contienen metadatos sobre el evento, como el AWS servicio que lo origina, la hora en que se generó el evento, la cuenta y la región en las que tuvo lugar el evento, etc. Para ver las definiciones de estos campos generales, consulte [Referencia de estructura de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) en la *Guía del usuario de Amazon EventBridge *. 

Además, cada evento tiene un campo `detail` que contiene datos específicos de ese evento en particular. La siguiente referencia define los campos de detalle de los distintos eventos de Deadline Cloud.

Al EventBridge utilizarlos para seleccionar y gestionar eventos de Deadline Cloud, es útil tener en cuenta lo siguiente:
+ El `source` campo para todos los eventos de Deadline Cloud está configurado en`aws.deadline`.
+ El campo `detail-type` especifica el tipo de evento. 

  Por ejemplo, `Fleet Size Recommendation Change`.
+ El campo `detail` contiene los datos específicos de ese evento en particular. 

Para obtener información sobre cómo crear patrones de eventos que permitan que las reglas coincidan con los eventos de Deadline Cloud, consulta [los patrones de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) en la *Guía del Amazon EventBridge usuario*.

Para obtener más información sobre los eventos y cómo se EventBridge procesan, consulte [Amazon EventBridge los eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) en la *Guía del Amazon EventBridge usuario*.

**Topics**
+ [Evento alcanzado el umbral presupuestario](#event-detail-budget-threshold-reached)
+ [Evento de cambio de recomendación de tamaño de flota](#event-detail-fleet-size-recommendation-change)
+ [Evento de cambio de estado del ciclo de vida laboral](#event-detail-job-lifecycle-status-change)
+ [Evento Job Run Status Change](#event-detail-job-run-status-change)
+ [Evento Step Lifecycle Status Change](#event-detail-step-lifecycle-status-change)
+ [Evento Step Run Status Change](#event-detail-step-run-status-change)
+ [Evento de cambio de estado de ejecución de la tarea](#event-detail-task-run-status-change)

## Evento alcanzado el umbral presupuestario
<a name="event-detail-budget-threshold-reached"></a>

Puede utilizar el evento Se ha alcanzado el umbral presupuestario para controlar el porcentaje del presupuesto que se ha utilizado. Deadline Cloud envía los eventos cuando el porcentaje utilizado supera los siguientes umbrales:
+ 10, 20, 30, 40, 50, 60, 70, 75, 80, 85, 90, 95, 96, 97, 98, 99, 100

La frecuencia con la que Deadline Cloud envía eventos relacionados con el umbral de presupuesto alcanzado aumenta a medida que el presupuesto se acerca a su límite. Esta frecuencia le permite supervisar de cerca un presupuesto a medida que se acerca a su límite y tomar medidas para evitar gastos excesivos. También puede establecer sus propios umbrales presupuestarios. Deadline Cloud envía un evento cuando el uso supera tus umbrales personalizados.

Si cambias el importe de un presupuesto, la próxima vez que Deadline Cloud envíe un evento sobre el límite presupuestario alcanzado, se basará en el porcentaje actual del presupuesto que se haya utilizado. Por ejemplo, si añades 50\$1 a un presupuesto de 100\$1 que ha alcanzado su límite, el siguiente evento denominado «Se ha alcanzado el umbral presupuestario» indicará que el presupuesto es del 75 por ciento.

A continuación, se muestran los campos de detalle del evento `Budget Threshold Reached`.

Los `detail-type` campos `source` y se incluyen a continuación porque contienen valores específicos para los eventos de Deadline Cloud. Para ver las definiciones de los demás campos de metadatos que se incluyen en todos los eventos, consulte la [referencia a la estructura de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) en la *Guía del Amazon EventBridge usuario*.

```
{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "Budget Threshold Reached",
    "source": "aws.deadline",
    "account": "111122223333",
    "time": "2017-12-22T18:43:48Z",
    "region": "aa-example-1",
    "resources": [],
    "detail": {
        "farmId": "farm-12345678900000000000000000000000",
        "budgetId": "budget-12345678900000000000000000000000",
        "thresholdInPercent": 0
    }
}
```

`detail-type`  <a name="job-lifecycle-status-change-detail-type"></a>
Identifica el tipo de evento.  
Para este evento, este valor es `Budget Threshold Reached`.

`source`  <a name="job-lifecycle-status-change-source"></a>
Identifica el servicio que generó el evento. Para los eventos de Deadline Cloud, este valor es`aws.deadline`.

`detail`  <a name="job-lifecycle-status-change-detail"></a>
Un objeto JSON que contiene información sobre el evento. El servicio que genera el evento determina el contenido de este campo.  
Para este evento, estos datos incluyen lo siguiente:    
`farmId`  <a name="budget-threshold-reached-field-1"></a>
El identificador de la granja que contiene el trabajo.  
`budgetId`  <a name="budget-threshold-reached-field-2"></a>
El identificador del presupuesto que ha alcanzado un umbral.  
`thresholdInPercent`  <a name="budget-threshold-reached-field-3"></a>
El porcentaje del presupuesto que se ha utilizado.

## Evento de cambio de recomendación de tamaño de flota
<a name="event-detail-fleet-size-recommendation-change"></a>

Cuando configuras tu flota para usar el escalado automático basado en eventos, Deadline Cloud envía eventos que puedes usar para administrar tus flotas. Cada uno de estos eventos contiene información sobre el tamaño actual y el tamaño solicitado de una flota. Para ver un ejemplo del uso de un EventBridge evento y un ejemplo de función Lambda para gestionar el evento, consulte Escalar [automáticamente su flota de Amazon EC2 con la función de recomendación de escalado de Deadline Cloud](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/create-auto-scaling.html#autoscale-ec2-fleet).

El evento de cambio de recomendación de tamaño de la flota se envía cuando ocurre lo siguiente:
+ Cuando el tamaño de flota recomendado cambia y oldFleetSize es diferente de newFleetSize.
+ Cuando el servicio detecta que el tamaño real de la flota no coincide con el tamaño de flota recomendado. Puede obtener el tamaño real de la flota a partir del WorkerCount en la respuesta a la GetFleet operación. Esto puede ocurrir cuando una instancia activa de Amazon EC2 no se registra como trabajadora de Deadline Cloud.

A continuación, se muestran los campos de detalle del evento `Fleet Size Recommendation Change`.

Los `detail-type` campos `source` y se incluyen a continuación porque contienen valores específicos para los eventos de Deadline Cloud. Para ver las definiciones de los demás campos de metadatos que se incluyen en todos los eventos, consulte la [referencia a la estructura de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) en la *Guía del Amazon EventBridge usuario*.

```
{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "Fleet Size Recommendation Change",
    "source": "aws.deadline",
    "account": "111122223333",
    "time": "2017-12-22T18:43:48Z",
    "region": "aa-example-1",
    "resources": [],
    "detail": {
        "farmId": "farm-12345678900000000000000000000000",
        "fleetId": "fleet-12345678900000000000000000000000",
        "oldFleetSize": 1,
        "newFleetSize": 5,
    }
}
```

`detail-type`  <a name="fleet-size-recommendation-change-detail-type"></a>
Identifica el tipo de evento.  
Para este evento, este valor es `Fleet Size Recommendation Change`.

`source`  <a name="fleet-size-recommendation-change-source"></a>
Identifica el servicio que generó el evento. Para los eventos de Deadline Cloud, este valor es`aws.deadline`.

`detail`  <a name="fleet-size-recommendation-change-detail"></a>
Un objeto JSON que contiene información sobre el evento. El servicio que genera el evento determina el contenido de este campo.  
Para este evento, estos datos incluyen lo siguiente:    
`farmId`  <a name="fleet-size-recommendation-change-field-1"></a>
El identificador de la granja que contiene el trabajo.  
`fleetId`  <a name="fleet-size-recommendation-change-field-2"></a>
El identificador de la flota que necesita un cambio de tamaño.  
`oldFleetSize`  <a name="fleet-size-recommendation-change-field-3"></a>
El tamaño actual de la flota.  
`newFleetSize`  <a name="fleet-size-recommendation-change-field-4"></a>
El nuevo tamaño recomendado para la flota.

## Evento de cambio de estado del ciclo de vida laboral
<a name="event-detail-job-lifecycle-status-change"></a>

Al crear o actualizar un trabajo, Deadline Cloud establece el estado del ciclo de vida para mostrar el estado de la acción iniciada por el usuario más recientemente.

Se envía un evento de cambio de estado del ciclo de vida del trabajo para cualquier cambio de estado del ciclo de vida, incluso cuando se crea el trabajo.

A continuación, se muestran los campos de detalle del evento `Job Lifecycle Status Change`.

Los `detail-type` campos `source` y se incluyen a continuación porque contienen valores específicos para los eventos de Deadline Cloud. Para ver las definiciones de los demás campos de metadatos que se incluyen en todos los eventos, consulte la [referencia a la estructura de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) en la *Guía del Amazon EventBridge usuario*.

```
{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "Job Lifecycle Status Change",
    "source": "aws.deadline",
    "account": "111122223333",
    "time": "2017-12-22T18:43:48Z",
    "region": "aa-example-1",
    "resources": [],
    "detail": {
        "farmId": "farm-12345678900000000000000000000000",
        "queueId": "queue-12345678900000000000000000000000",
        "jobId": "job-12345678900000000000000000000000",
        "previousLifecycleStatus": "UPDATE_IN_PROGRESS",
        "lifecycleStatus": "UPDATE_SUCCEEDED"
    }
}
```

`detail-type`  <a name="job-lifecycle-status-change-detail-type"></a>
Identifica el tipo de evento.  
Para este evento, este valor es `Job Lifecycle Status Change`.

`source`  <a name="job-lifecycle-status-change-source"></a>
Identifica el servicio que generó el evento. Para los eventos de Deadline Cloud, este valor es`aws.deadline`.

`detail`  <a name="job-lifecycle-status-change-detail"></a>
Un objeto JSON que contiene información sobre el evento. El servicio que genera el evento determina el contenido de este campo.  
Para este evento, estos datos incluyen lo siguiente:    
`farmId`  <a name="job-lifecycle-status-change-field-1"></a>
El identificador de la granja que contiene el trabajo.  
`queueId`  <a name="job-lifecycle-status-change-field-2"></a>
El identificador de la cola que contiene el trabajo.  
`jobId`  <a name="job-lifecycle-status-change-field-3"></a>
El identificador del trabajo.  
`previousLifecycleStatus`  <a name="job-lifecycle-status-change-field-4"></a>
El estado del ciclo de vida en el que se va a dejar el trabajo. Este campo no se incluye cuando envías un trabajo por primera vez.  
`lifecycleStatus`  <a name="job-lifecycle-status-change-field-5"></a>
El estado del ciclo de vida al que está ingresando el trabajo.

## Evento Job Run Status Change
<a name="event-detail-job-run-status-change"></a>

Un trabajo se compone de muchas tareas. Cada tarea tiene un estado. El estado de todas las tareas se combina para proporcionar un estado general de un trabajo. Para obtener más información, consulta [los estados de los trabajos en Deadline Cloud](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/jobs-states.html) en la *Guía del usuario de AWS Deadline Cloud*.

Se envía un evento de cambio de estado de ejecución de un trabajo cuando:
+ El [taskRunStatus](#job-run-status-change-field-5) campo combinado cambia.
+ El trabajo se vuelve a poner en cola, a menos que esté en el estado LISTO.

NO se envía un evento de cambio de estado de ejecución de una tarea cuando:
+ El trabajo se crea por primera vez. Para supervisar la creación de puestos de trabajo, supervise los eventos de cambio de estado del ciclo de vida del trabajo para detectar cambios.
+ El [taskRunStatusCounts](#job-run-status-change-field-6) campo del trabajo cambia, pero el estado de ejecución de la tarea combinada no cambia.

A continuación, se muestran los campos de detalle del evento `Job Run Status Change`.

Los `detail-type` campos `source` y se incluyen a continuación porque contienen valores específicos para los eventos de Deadline Cloud. Para ver las definiciones de los demás campos de metadatos que se incluyen en todos los eventos, consulte la [referencia a la estructura de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) en la *Guía del Amazon EventBridge usuario*.

```
{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "Job Run Status Change",
    "source": "aws.deadline",
    "account": "111122223333",
    "time": "2017-12-22T18:43:48Z",
    "region": "aa-example-1",
    "resources": [],
    "detail": {
        "farmId": "farm-12345678900000000000000000000000",
        "queueId": "queue-12345678900000000000000000000000",
        "jobId": "job-12345678900000000000000000000000",
        "previousTaskRunStatus": "RUNNING",
        "taskRunStatus": "SUCCEEDED",
        "taskRunStatusCounts": {
            "PENDING": 0,
            "READY": 0,
            "RUNNING": 0,
            "ASSIGNED": 0,
            "STARTING": 0,
            "SCHEDULED": 0,
            "INTERRUPTING": 0,
            "SUSPENDED": 0,
            "CANCELED": 0,
            "FAILED": 0,
            "SUCCEEDED": 20,
            "NOT_COMPATIBLE": 0
       }
    }
}
```

`detail-type`  <a name="job-run-status-change-detail-type"></a>
Identifica el tipo de evento.  
Para este evento, este valor es `Job Run Status Change`.

`source`  <a name="job-run-status-change-source"></a>
Identifica el servicio que generó el evento. Para los eventos de Deadline Cloud, este valor es`aws.deadline`.

`detail`  <a name="job-run-status-change-detail"></a>
Un objeto JSON que contiene información sobre el evento. El servicio que genera el evento determina el contenido de este campo.  
Para este evento, estos datos incluyen lo siguiente:    
`farmId`  <a name="job-run-status-change-field-1"></a>
El identificador de la granja que contiene el trabajo.  
`queueId`  <a name="job-run-status-change-field-2"></a>
El identificador de la cola que contiene el trabajo.  
`jobId`  <a name="job-run-status-change-field-3"></a>
El identificador del trabajo.  
`previousTaskRunStatus`  <a name="job-run-status-change-field-4"></a>
La tarea ejecutada indica que el trabajo se va a finalizar.  
`taskRunStatus`  <a name="job-run-status-change-field-5"></a>
La ejecución de la tarea indica que el trabajo está ingresando.  
`taskRunStatusCounts`  <a name="job-run-status-change-field-6"></a>
El número de tareas del trabajo en cada estado.

## Evento Step Lifecycle Status Change
<a name="event-detail-step-lifecycle-status-change"></a>

Al crear o actualizar un evento, Deadline Cloud establece el estado del ciclo de vida del trabajo para describir el estado de la acción iniciada por el usuario más recientemente.

Se envía un evento de cambio de estado del ciclo de vida escalonado cuando:
+ Se inicia una actualización escalonada (UPDATE\$1IN\$1PROGRESS).
+ La actualización de un paso se completó correctamente (UPDATE\$1SUCEDED).
+ Error en la actualización de un paso (UPDATE\$1FAILED).

No se envía un evento cuando se crea el paso por primera vez. Para supervisar la creación de pasos, supervise los eventos de cambio de estado del ciclo de vida del trabajo para ver si hay cambios.

A continuación, se muestran los campos de detalle del evento `Step Lifecycle Status Change`.

Los `detail-type` campos `source` y se incluyen a continuación porque contienen valores específicos para los eventos de Deadline Cloud. Para ver las definiciones de los demás campos de metadatos que se incluyen en todos los eventos, consulte la [referencia a la estructura de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) en la *Guía del Amazon EventBridge usuario*.

```
{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "Step Lifecycle Status Change",
    "source": "aws.deadline",
    "account": "111122223333",
    "time": "2017-12-22T18:43:48Z",
    "region": "aa-example-1",
    "resources": [],
    "detail": {
        "farmId": "farm-12345678900000000000000000000000",
        "queueId": "queue-12345678900000000000000000000000",
        "jobId": "job-12345678900000000000000000000000",
        "stepId": "step-12345678900000000000000000000000",
        "previousLifecycleStatus": "UPDATE_IN_PROGRESS",
        "lifecycleStatus": "UPDATE_SUCCEEDED"
    }
}
```

`detail-type`  <a name="step-lifecycle-status-change-detail-type"></a>
Identifica el tipo de evento.  
Para este evento, este valor es `Step Lifecycle Status Change`.

`source`  <a name="step-lifecycle-status-change-source"></a>
Identifica el servicio que generó el evento. Para los eventos de Deadline Cloud, este valor es`aws.deadline`.

`detail`  <a name="step-lifecycle-status-change-detail"></a>
Un objeto JSON que contiene información sobre el evento. El servicio que genera el evento determina el contenido de este campo.  
Para este evento, estos datos incluyen lo siguiente:    
`farmId`  <a name="step-lifecycle-status-change-field-1"></a>
El identificador de la granja que contiene el trabajo.  
`queueId`  <a name="step-lifecycle-status-change-field-2"></a>
El identificador de la cola que contiene el trabajo.  
`jobId`  <a name="step-lifecycle-status-change-field-3"></a>
El identificador del trabajo.  
`stepId`  <a name="step-lifecycle-status-change-field-4"></a>
El identificador del paso de trabajo actual.  
`previousLifecycleStatus`  <a name="step-lifecycle-status-change-field-5"></a>
El estado del ciclo de vida del que sale el paso.  
`lifecycleStatus`  <a name="step-lifecycle-status-change-field-6"></a>
El estado del ciclo de vida al que ingresa el paso.

## Evento Step Run Status Change
<a name="event-detail-step-run-status-change"></a>

Cada paso de un trabajo se compone de muchas tareas. Cada tarea tiene un estado. Los estados de las tareas se combinan para proporcionar un estado general de los pasos y los trabajos.

Se envía un evento de cambio de estado de ejecución escalonada cuando:
+ La combinación [taskRunStatus](#step-run-status-change-field-6) cambia.
+ El paso se vuelve a poner en cola, a menos que esté en el estado LISTO. 

No se envía un evento cuando:
+ El paso se crea primero. Para supervisar la creación de pasos, supervise los eventos de cambio de estado del ciclo de vida del trabajo para ver si hay cambios. 
+ El paso [taskRunStatusCounts](#step-run-status-change-field-7) cambia, pero el estado de ejecución de la tarea de los pasos combinados no cambia.

A continuación, se muestran los campos de detalle del evento `Step Run Status Change`.

Los `detail-type` campos `source` y se incluyen a continuación porque contienen valores específicos para los eventos de Deadline Cloud. Para ver las definiciones de los demás campos de metadatos que se incluyen en todos los eventos, consulte la [referencia a la estructura de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) en la *Guía del Amazon EventBridge usuario*.

```
{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "Step Run Status Change",
    "source": "aws.deadline",
    "account": "111122223333",
    "time": "2017-12-22T18:43:48Z",
    "region": "aa-example-1",
    "resources": [],
    "detail": {
        "farmId": "farm-12345678900000000000000000000000",
        "queueId": "queue-12345678900000000000000000000000",
        "jobId": "job-12345678900000000000000000000000",
        "stepId": "step-12345678900000000000000000000000",
        "previousTaskRunStatus": "RUNNING",
        "taskRunStatus": "SUCCEEDED",
        "taskRunStatusCounts": {
            "PENDING": 0,
            "READY": 0,
            "RUNNING": 0,
            "ASSIGNED": 0,
            "STARTING": 0,
            "SCHEDULED": 0,
            "INTERRUPTING": 0,
            "SUSPENDED": 0,
            "CANCELED": 0,
            "FAILED": 0,
            "SUCCEEDED": 20,
            "NOT_COMPATIBLE": 0
       }
    }
}
```

`detail-type`  <a name="step-run-status-change-detail-type"></a>
Identifica el tipo de evento.  
Para este evento, este valor es `Step Run Status Change`.

`source`  <a name="step-run-status-change-source"></a>
Identifica el servicio que generó el evento. Para los eventos de Deadline Cloud, este valor es`aws.deadline`.

`detail`  <a name="step-run-status-change-detail"></a>
Un objeto JSON que contiene información sobre el evento. El servicio que genera el evento determina el contenido de este campo.  
Para este evento, estos datos incluyen lo siguiente:    
`farmId`  <a name="step-run-status-change-field-1"></a>
El identificador de la granja que contiene el trabajo.  
`queueId`  <a name="step-run-status-change-field-2"></a>
El identificador de la cola que contiene el trabajo.  
`jobId`  <a name="step-run-status-change-field-3"></a>
El identificador del trabajo.  
`stepId`  <a name="step-run-status-change-field-4"></a>
El identificador del paso de trabajo actual.  
`previousTaskRunStatus`  <a name="step-run-status-change-field-5"></a>
El estado de ejecución por el que se va el paso.  
`taskRunStatus`  <a name="step-run-status-change-field-6"></a>
El estado de ejecución al que está ingresando el paso.  
`taskRunStatusCounts`  <a name="step-run-status-change-field-7"></a>
El número de tareas del paso en cada estado.

## Evento de cambio de estado de ejecución de la tarea
<a name="event-detail-task-run-status-change"></a>

El [runStatus](#task-run-status-change-field-7) campo se actualiza a medida que se ejecuta la tarea. Se envía un evento cuando:
+ El estado de ejecución de la tarea cambia.
+ La tarea se vuelve a poner en cola, a menos que esté en el estado LISTA. 

No se envía un evento cuando:
+ La tarea se crea por primera vez. Para supervisar la creación de tareas, supervise los eventos de cambio de estado del ciclo de vida del trabajo para ver si hay cambios. 

A continuación, se muestran los campos de detalle del evento `Task Run Status Change`.

Los `detail-type` campos `source` y se incluyen a continuación porque contienen valores específicos para los eventos de Deadline Cloud. Para ver las definiciones de los demás campos de metadatos que se incluyen en todos los eventos, consulte la [referencia a la estructura de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) en la *Guía del Amazon EventBridge usuario*.

```
{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "Task Run Status Change",
    "source": "aws.aws.deadline",
    "account": "111122223333",
    "time": "2017-12-22T18:43:48Z",
    "region": "aa-example-1",
    "resources": [],
    "detail": {
        "farmId": "farm-12345678900000000000000000000000",
        "queueId": "queue-12345678900000000000000000000000",
        "jobId": "job-12345678900000000000000000000000",
        "stepId": "step-12345678900000000000000000000000",
        "taskId": "task-12345678900000000000000000000000-0",
        "previousRunStatus": "RUNNING",
        "runStatus": "SUCCEEDED"
    }
}
```

`detail-type`  <a name="task-run-status-change-detail-type"></a>
Identifica el tipo de evento.  
Para este evento, este valor es `Fleet Size Recommendation Change`.

`source`  <a name="task-run-status-change-source"></a>
Identifica el servicio que generó el evento. Para los eventos de Deadline Cloud, este valor es`aws.deadline`.

`detail`  <a name="task-run-status-change-detail"></a>
Un objeto JSON que contiene información sobre el evento. El servicio que genera el evento determina el contenido de este campo.  
Para este evento, estos datos incluyen lo siguiente:    
`farmId`  <a name="task-run-status-change-field-1"></a>
El identificador de la granja que contiene el trabajo.  
`queueId`  <a name="task-run-status-change-field-2"></a>
El identificador de la cola que contiene el trabajo.  
`jobId`  <a name="task-run-status-change-field-3"></a>
El identificador del trabajo.  
stepId  <a name="task-run-status-change-field-4"></a>
El identificador del paso de trabajo actual.  
`taskId`  <a name="task-run-status-change-field-5"></a>
El identificador de la tarea en ejecución.  
`previousRunStatus`  <a name="task-run-status-change-field-6"></a>
El estado de ejecución por el que sale la tarea.  
`runStatus`  <a name="task-run-status-change-field-7"></a>
El estado de ejecución al que está ingresando la tarea.