# Publicación de AWS IoT Jobs SDK Ejemplos de usando AWS CLI
En los siguientes ejemplos de código se muestra cómo realizar acciones e implementar escenarios comunes usando AWS Command Line Interface con Publicación de AWS IoT Jobs SDK.
Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
**Topics**
+ [Acciones](#actions)
## Acciones
### `describe-job-execution`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-job-execution`.
**AWS CLI**
**Para obtener los detalles de una ejecución de trabajo**
En el siguiente ejemplo de `describe-job-execution`, se recuperan los detalles de la última ejecución del trabajo y el objeto especificados.
```
aws iot-jobs-data describe-job-execution \
--job-id SampleJob \
--thing-name MotionSensor1 \
--endpoint-url https://1234567890abcd.jobs.iot.us-west-2.amazonaws.com
```
Salida:
```
{
"execution": {
"approximateSecondsBeforeTimedOut": 88,
"executionNumber": 2939653338,
"jobId": "SampleJob",
"lastUpdatedAt": 1567701875.743,
"queuedAt": 1567701902.444,
"status": "QUEUED",
"thingName": "MotionSensor1 ",
"versionNumber": 3
}
}
```
Para obtener más información, consulte los [Devices and Jobs](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-devices.html) en la *Guía para desarrolladores de AWS IoT*.
+ Para obtener información sobre la API, consulte [DescribeJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-jobs-data/describe-job-execution.html) en la *Referencia de comandos de la AWS CLI*.
### `get-pending-job-executions`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-pending-job-executions`.
**AWS CLI**
**Para obtener la lista de todos los trabajos que no tienen un estado terminal para un objeto**
En el siguiente ejemplo de `get-pending-job-executions`, se muestra una lista de todos los trabajos que no tienen un estado terminal para el objeto especificado.
```
aws iot-jobs-data get-pending-job-executions \
--thing-name MotionSensor1
--endpoint-url https://1234567890abcd.jobs.iot.us-west-2.amazonaws.com
```
Salida:
```
{
"inProgressJobs": [
],
"queuedJobs": [
{
"executionNumber": 2939653338,
"jobId": "SampleJob",
"lastUpdatedAt": 1567701875.743,
"queuedAt": 1567701902.444,
"versionNumber": 3
}
]
}
```
Para obtener más información, consulte los [Devices and Jobs](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-devices.html) en la *Guía para desarrolladores de AWS IoT*.
+ Para obtener información sobre la API, consulte [GetPendingJobExecutions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-jobs-data/get-pending-job-executions.html) en la *Referencia de comandos de la AWS CLI*.
### `start-next-pending-job-execution`
En el siguiente ejemplo de código, se muestra cómo utilizar `start-next-pending-job-execution`.
**AWS CLI**
**Para obtener e iniciar la siguiente ejecución de trabajos pendiente para un objeto**
En el siguiente ejemplo de `start-next-pending-job-execution`, se recupera e inicia la siguiente ejecución de trabajo cuyo estado es IN\$1PROGRESS o QUEUED para el objeto especificado.
```
aws iot-jobs-data start-next-pending-job-execution \
--thing-name MotionSensor1
--endpoint-url https://1234567890abcd.jobs.iot.us-west-2.amazonaws.com
```
Salida:
```
{
"execution": {
"approximateSecondsBeforeTimedOut": 88,
"executionNumber": 2939653338,
"jobId": "SampleJob",
"lastUpdatedAt": 1567714853.743,
"queuedAt": 1567701902.444,
"startedAt": 1567714871.690,
"status": "IN_PROGRESS",
"thingName": "MotionSensor1 ",
"versionNumber": 3
}
}
```
Para obtener más información, consulte los [Devices and Jobs](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-devices.html) en la *Guía para desarrolladores de AWS IoT*.
+ Para obtener información sobre la API, consulte [StartNextPendingJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-jobs-data/start-next-pending-job-execution.html) en la *Referencia de comandos de la AWS CLI*.
### `update-job-execution`
En el siguiente ejemplo de código, se muestra cómo utilizar `update-job-execution`.
**AWS CLI**
**Para actualizar el estado de una ejecución de trabajo**
En el siguiente ejemplo de `update-job-execution`, se actualiza el estado de un trabajo y un objeto especificados.
```
aws iot-jobs-data update-job-execution \
--job-id SampleJob \
--thing-name MotionSensor1 \
--status REMOVED \
--endpoint-url https://1234567890abcd.jobs.iot.us-west-2.amazonaws.com
```
Salida:
```
{
"executionState": {
"status": "REMOVED",
"versionNumber": 3
},
}
```
Para obtener más información, consulte los [Devices and Jobs](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-devices.html) en la *Guía para desarrolladores de AWS IoT*.
+ Para obtener información acerca de la API, consulte [UpdateJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-jobs-data/update-job-execution.html) en la *Referencia de comandos de la AWS CLI*.