As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Crie modelos de trabalho personalizados usando o AWS CLI

Este tópico explica como criar, excluir e recuperar detalhes sobre modelos de trabalho usando a AWS CLI.

Crie um modelo de trabalho do zero

O AWS CLI comando a seguir mostra como criar um trabalho usando um documento de trabalho (job-document.json) armazenado em um bucket do S3 e em uma função com permissão para baixar arquivos do Amazon S3 (S3DownloadRole).

aws iot create-job-template  \
      --job-template-id 010  \
      --document-source https://s3.amazonaws.com/amzn-s3-demo-bucket/job-document.json  \
      --timeout-config inProgressTimeoutInMinutes=100 \
      --job-executions-rollout-config "{ \"exponentialRate\": { \"baseRatePerMinute\": 50, \"incrementFactor\": 2, \"rateIncreaseCriteria\": { \"numberOfNotifiedThings\": 1000, \"numberOfSucceededThings\": 1000}}, \"maximumPerMinute\": 1000}" \
      --abort-config "{ \"criteriaList\": [ { \"action\": \"CANCEL\", \"failureType\": \"FAILED\", \"minNumberOfExecutedThings\": 100, \"thresholdPercentage\": 20}, { \"action\": \"CANCEL\", \"failureType\": \"TIMED_OUT\", \"minNumberOfExecutedThings\": 200, \"thresholdPercentage\": 50}]}" \          
      --presigned-url-config "{\"roleArn\":\"arn:aws:iam::123456789012:role/S3DownloadRole\", \"expiresInSec\":3600}" 
            

O parâmetro opcional timeout-config especifica o tempo que cada dispositivo tem para concluir a execução do trabalho. O temporizador é iniciado quando o status da execução do trabalho é definido como IN_PROGRESS. Se o status da execução do trabalho não estiver definido como outro estado terminal antes que o tempo expire, ele será definido como TIMED_OUT.

O temporizador em andamento não pode ser atualizado e é aplicado a todos os lançamentos de trabalho para o trabalho. Sempre que o lançamento de um trabalho permanece no IN_PROGRESS estado por mais tempo do que esse intervalo, o lançamento do trabalho falha e muda para o TIMED_OUT status do terminal. AWS IoT também publica uma MQTT notificação.

Para obter mais informações sobre como criar configurações para distribuir e anular trabalhos, consulte Configuração para distribuir e anular trabalhos.

Crie um modelo de trabalho a partir de um trabalho existente

O AWS CLI comando a seguir cria um modelo de trabalho especificando o Amazon Resource Name (ARN) de um trabalho existente. O novo modelo de trabalho usa todas as configurações especificadas no trabalho. Opcionalmente, você pode alterar qualquer configuração no trabalho existente usando qualquer um dos parâmetros opcionais.

aws iot create-job-template  \
      --job-arn arn:aws:iot:region:123456789012:job/job-name  \      
      --timeout-config inProgressTimeoutInMinutes=100
            

Obtenha detalhes sobre um modelo de trabalho

O AWS CLI comando a seguir obtém detalhes sobre um modelo de trabalho especificado.

aws iot describe-job-template \
      --job-template-id template-id
                

O comando exibe a seguinte saída.

{
   "abortConfig": { 
      "criteriaList": [ 
         { 
            "action": "string",
            "failureType": "string",
            "minNumberOfExecutedThings": number,
            "thresholdPercentage": number
         }
      ]
   },
   "createdAt": number,
   "description": "string",
   "document": "string",
   "documentSource": "string",
   "jobExecutionsRolloutConfig": { 
      "exponentialRate": { 
         "baseRatePerMinute": number,
         "incrementFactor": number,
         "rateIncreaseCriteria": { 
            "numberOfNotifiedThings": number,
            "numberOfSucceededThings": number
         }
      },
      "maximumPerMinute": number
   },
   "jobTemplateArn": "string",
   "jobTemplateId": "string",
   "presignedUrlConfig": { 
      "expiresInSec": number,
      "roleArn": "string"
   },
   "timeoutConfig": { 
      "inProgressTimeoutInMinutes": number
   }
}
                

Liste modelos de trabalho

O AWS CLI comando a seguir lista todos os modelos de trabalho em seu Conta da AWS.

 aws iot list-job-templates
                

O comando exibe a seguinte saída.

{
   "jobTemplates": [ 
      { 
         "createdAt": number,
         "description": "string",
         "jobTemplateArn": "string",
         "jobTemplateId": "string"
      }
   ],
   "nextToken": "string"
}
                

Para recuperar páginas adicionais de resultados, use o valor do campo nextToken.

Exclua um modelo de trabalho

O AWS CLI comando a seguir exclui um modelo de trabalho especificado.

aws iot delete-job-template \
      --job-template-id template-id
                

O comando não exibe nenhuma saída.

Crie um trabalho com base em um modelo de trabalho personalizado

O AWS CLI comando a seguir cria um trabalho a partir de um modelo de trabalho personalizado. Ele tem como alvo um dispositivo chamado thingOne e especifica o Amazon Resource Name (ARN) do modelo de trabalho a ser usado como base para o trabalho. Você pode substituir configurações avançadas, como configurações de tempo limite e cancelamento, passando os parâmetros associados do comando create-job.

aws iot create-job \ 
      --targets arn:aws:iot:region:123456789012:thing/thingOne  \
      --job-template-arn arn:aws:iot:region:123456789012:jobtemplate/template-id