Exemplos de AWS IoT Jobs SDK release usando a AWS CLI - AWS Command Line Interface
Ações

Esta documentação é somente para a versão 1 da AWS CLI. Para obter a documentação relacionada à AWS CLI versão 2, consulte o Guia do usuário da versão 2.

Exemplos de AWS IoT Jobs SDK release usando a AWS CLI

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 AWS IoT Jobs SDK release.

Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar funções 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.

Tópicos

Ações

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

Saída:

{
    "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 no Guia do desenvolvedor do AWS IoT.

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

Saída:

{
    "inProgressJobs": [
    ],
    "queuedJobs": [
        {
            "executionNumber": 2939653338,
            "jobId": "SampleJob",
            "lastUpdatedAt": 1567701875.743,
            "queuedAt": 1567701902.444,
            "versionNumber": 3
      }
    ]
}

Para obter mais informações, consulte Dispositivos e Trabalhos no Guia do desenvolvedor do AWS IoT.

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_PROGRESS 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

Saída:

{
    "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 no Guia do desenvolvedor do AWS IoT.

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

Saída:

{
    "executionState": {
        "status": "REMOVED",
        "versionNumber": 3
    },
}

Para obter mais informações, consulte Dispositivos e Trabalhos no Guia do desenvolvedor do AWS IoT.

  • Para ver detalhes da API, consulte UpdateJobExecution na Referência de comandos da AWS CLI.