# Lançamento do AWS IoT Jobs SDK Exemplos do usando a AWS CLI
<a name="cli_iot-jobs-data-plane_code_examples"></a>

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o Lançamento do AWS IoT Jobs SDK.

*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

**Topics**
+ [Ações](#actions)

## Ações
<a name="actions"></a>

### `describe-job-execution`
<a name="iot-jobs-data-plane_DescribeJobExecution_cli_topic"></a>

O código de exemplo a seguir mostra como usar `describe-job-execution`.

**AWS CLI**  
**Para obter os detalhes da execução do trabalho**  
O exemplo `describe-job-execution` a seguir recupera detalhes sobre a execução mais recente do trabalho e do item 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
```
Resultado:  

```
{
    "execution": {
        "approximateSecondsBeforeTimedOut": 88,
        "executionNumber": 2939653338,
        "jobId": "SampleJob",
        "lastUpdatedAt": 1567701875.743,
        "queuedAt": 1567701902.444,
        "status": "QUEUED",
        "thingName": "MotionSensor1 ",
        "versionNumber": 3
   }
}
```
Para obter mais informações, consulte [Dispositivos e Trabalhos](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-devices.html) no *Guia do desenvolvedor do AWS IoT*.  
+  Para ver detalhes da API, consulte [DescribeJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-jobs-data/describe-job-execution.html) na *Referência de comandos da AWS CLI*. 

### `get-pending-job-executions`
<a name="iot-jobs-data-plane_GetPendingJobExecutions_cli_topic"></a>

O código de exemplo a seguir mostra como usar `get-pending-job-executions`.

**AWS CLI**  
**Para obter uma lista de todos os trabalhos que não estejam no status de terminal para um item**  
O exemplo `get-pending-job-executions` a seguir exibe uma lista de todos os trabalhos que não estejam em um status de terminal para o item especificado.  

```
aws iot-jobs-data get-pending-job-executions \
    --thing-name MotionSensor1
    --endpoint-url https://1234567890abcd.jobs.iot.us-west-2.amazonaws.com
```
Resultado:  

```
{
    "inProgressJobs": [
    ],
    "queuedJobs": [
        {
            "executionNumber": 2939653338,
            "jobId": "SampleJob",
            "lastUpdatedAt": 1567701875.743,
            "queuedAt": 1567701902.444,
            "versionNumber": 3
      }
    ]
}
```
Para obter mais informações, consulte [Dispositivos e Trabalhos](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-devices.html) no *Guia do desenvolvedor do AWS IoT*.  
+  Para ver detalhes da API, consulte [GetPendingJobExecutions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-jobs-data/get-pending-job-executions.html) na *Referência de comandos da AWS CLI*. 

### `start-next-pending-job-execution`
<a name="iot-jobs-data-plane_StartNextPendingJobExecution_cli_topic"></a>

O código de exemplo a seguir mostra como usar `start-next-pending-job-execution`.

**AWS CLI**  
**Para obter e iniciar a próxima execução de tarefas pendentes para um item**  
O exemplo `start-next-pending-job-execution` a seguir recupera e inicia a próxima execução do trabalho cujo status é IN\$1PROGRESS ou QUEUED para o item especificado.  

```
aws iot-jobs-data start-next-pending-job-execution \
    --thing-name MotionSensor1
    --endpoint-url https://1234567890abcd.jobs.iot.us-west-2.amazonaws.com
```
Resultado:  

```
{
    "execution": {
        "approximateSecondsBeforeTimedOut": 88,
        "executionNumber": 2939653338,
        "jobId": "SampleJob",
        "lastUpdatedAt": 1567714853.743,
        "queuedAt": 1567701902.444,
        "startedAt": 1567714871.690,
        "status": "IN_PROGRESS",
        "thingName": "MotionSensor1 ",
        "versionNumber": 3
   }
}
```
Para obter mais informações, consulte [Dispositivos e Trabalhos](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-devices.html) no *Guia do desenvolvedor do AWS IoT*.  
+  Para ver detalhes da API, consulte [StartNextPendingJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-jobs-data/start-next-pending-job-execution.html) na *Referência de comandos da AWS CLI*. 

### `update-job-execution`
<a name="iot-jobs-data-plane_UpdateJobExecution_cli_topic"></a>

O código de exemplo a seguir mostra como usar `update-job-execution`.

**AWS CLI**  
**Para atualizar o status de uma execução de trabalho**  
O exemplo `update-job-execution` a seguir atualiza o status do trabalho e do item 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
```
Resultado:  

```
{
    "executionState": {
        "status": "REMOVED",
        "versionNumber": 3
    },
}
```
Para obter mais informações, consulte [Dispositivos e Trabalhos](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-devices.html) no *Guia do desenvolvedor do AWS IoT*.  
+  Para ver detalhes da API, consulte [UpdateJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-jobs-data/update-job-execution.html) na *Referência de comandos da AWS CLI*.