Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Buat template pekerjaan kustom dengan menggunakan AWS CLI

Topik ini menjelaskan cara membuat, menghapus, dan mengambil detail tentang template pekerjaan dengan menggunakan AWS CLI.

Buat template pekerjaan dari awal

Per AWS CLI intah berikut menunjukkan cara membuat pekerjaan menggunakan dokumen pekerjaan (job-document.json) yang disimpan dalam bucket S3 dan peran dengan izin untuk mengunduh file dari Amazon S3 (S3DownloadRole).

aws iot create-job-template  \
      --job-template-id 010  \
      --description "My custom job template for updating the device firmware"
      --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}" 
            

timeout-configParameter opsional menentukan jumlah waktu yang dimiliki setiap perangkat untuk menyelesaikan menjalankan pekerjaan. Timer dimulai saat status eksekusi pekerjaan disetel keIN_PROGRESS. Jika status eksekusi pekerjaan tidak disetel ke status terminal lain sebelum waktu berakhir, status tersebut disetel keTIMED_OUT.

Pengatur waktu dalam proses tidak dapat diperbarui dan berlaku untuk semua peluncuran pekerjaan untuk pekerjaan tersebut. Setiap kali peluncuran pekerjaan tetap dalam IN_PROGRESS status lebih lama dari interval ini, peluncuran pekerjaan gagal dan beralih ke TIMED_OUT status terminal. AWS IoT juga menerbitkan pemberitahuan MQTT.

Untuk informasi selengkapnya tentang membuat konfigurasi tentang peluncuran dan pembatalan pekerjaan, lihat Peluncuran pekerjaan dan pembatalan konfigurasi.

Membuat template pekerjaan dari pekerjaan yang sudah ada

Per AWS CLI intah berikut membuat template pekerjaan dengan menentukan Nama Sumber Daya Amazon (ARN) dari pekerjaan yang ada. Template pekerjaan baru menggunakan semua konfigurasi yang ditentukan dalam pekerjaan. Secara opsional, Anda dapat mengubah konfigurasi apa pun dalam pekerjaan yang ada dengan menggunakan salah satu parameter opsional.

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

Dapatkan detail tentang template pekerjaan

Per AWS CLI intah berikut mendapatkan detail tentang template pekerjaan tertentu.

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

Perintah menampilkan output berikut.

{
   "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
   }
}
                

Daftar templat pekerjaan

Per AWS CLI intah berikut mencantumkan semua template pekerjaan di Anda Akun AWS.

 aws iot list-job-templates
                

Perintah menampilkan output berikut.

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

Untuk mengambil halaman tambahan hasil, gunakan nilai nextToken bidang.

Menghapus templat pekerjaan

Per AWS CLI intah berikut menghapus template pekerjaan tertentu.

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

Perintah tidak menampilkan output.

Membuat pekerjaan dari template pekerjaan kustom

Per AWS CLI intah berikut membuat pekerjaan dari template pekerjaan kustom. Ini menargetkan perangkat bernama thingOne dan menentukan Nama Sumber Daya Amazon (ARN) dari template pekerjaan yang akan digunakan sebagai dasar untuk pekerjaan. Anda dapat mengganti konfigurasi lanjutan, seperti batas waktu dan konfigurasi pembatalan, dengan meneruskan parameter terkait perintah. 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