Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples).
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.
# Publicación de AWS IoT Jobs SDK ejemplos que utilizan AWS CLI
Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso del AWS Command Line Interface with 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
### `describa la ejecución de un trabajo`
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 más información sobre la API, consulte la Referencia de comandos. [DescribeJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-jobs-data/describe-job-execution.html)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 detalles sobre la API, consulte la Referencia de comandos. [GetPendingJobExecutions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-jobs-data/get-pending-job-executions.html)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\_PROGRESS 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 más información sobre la API, consulte la Referencia de comandos. [StartNextPendingJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-jobs-data/start-next-pending-job-execution.html)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 más información sobre la API, consulte [UpdateJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-jobs-data/update-job-execution.html)la Referencia de comandos.AWS CLI *