Pilih preferensi cookie Anda

Kami menggunakan cookie penting serta alat serupa yang diperlukan untuk menyediakan situs dan layanan. Kami menggunakan cookie performa untuk mengumpulkan statistik anonim sehingga kami dapat memahami cara pelanggan menggunakan situs dan melakukan perbaikan. Cookie penting tidak dapat dinonaktifkan, tetapi Anda dapat mengklik “Kustom” atau “Tolak” untuk menolak cookie performa.

Jika Anda setuju, AWS dan pihak ketiga yang disetujui juga akan menggunakan cookie untuk menyediakan fitur situs yang berguna, mengingat preferensi Anda, dan menampilkan konten yang relevan, termasuk iklan yang relevan. Untuk menerima atau menolak semua cookie yang tidak penting, klik “Terima” atau “Tolak”. Untuk membuat pilihan yang lebih detail, klik “Kustomisasi”.

Preferensi
Hubungi Kami
Umpan Balik
AWS Documentation
Buat Akun AWS

Perangkat pekerjaan HTTP API

PDF
Mode fokus
Perangkat pekerjaan HTTP API - AWS IoT Core

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

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

Perangkat dapat berkomunikasi dengan AWS IoT Jobs menggunakan HTTP Signature Version 4 pada port 443. Ini adalah metode yang digunakan oleh AWS SDKs danCLI. Untuk informasi selengkapnya tentang alat tersebut, lihat Referensi AWS CLI Perintah: iot-jobs-data atau AWS SDKsdan Alat.

Perintah berikut tersedia untuk perangkat yang menjalankan pekerjaan. Untuk informasi tentang penggunaan API operasi dengan MQTT protokol, lihatPekerjaan MQTT API operasi perangkat.

Mendapat daftar semua pekerjaan yang tidak dalam status terminal, untuk hal tertentu.

HTTPS request
GET /things/thingName/jobs

Respons:

{
"inProgressJobs" : [ JobExecutionSummary ... ], 
"queuedJobs" : [ JobExecutionSummary ... ]
}

Untuk informasi selengkapnya, lihat GetPendingJobExecutions.

CLI syntax
aws iot-jobs-data get-pending-job-executions \
--thing-name <value>  \
[--cli-input-json <value>] \
[--generate-cli-skeleton]

cli-input-jsonformat:

{
"thingName": "string"
}

Untuk informasi selengkapnya, lihat get-pending-job-executions.

Mendapat daftar semua pekerjaan yang tidak dalam status terminal, untuk hal tertentu.

HTTPS request
GET /things/thingName/jobs

Respons:

{
"inProgressJobs" : [ JobExecutionSummary ... ], 
"queuedJobs" : [ JobExecutionSummary ... ]
}

Untuk informasi selengkapnya, lihat GetPendingJobExecutions.

CLI syntax
aws iot-jobs-data get-pending-job-executions \
--thing-name <value>  \
[--cli-input-json <value>] \
[--generate-cli-skeleton]

cli-input-jsonformat:

{
"thingName": "string"
}

Untuk informasi selengkapnya, lihat get-pending-job-executions.

anchoranchor
GET /things/thingName/jobs

Respons:

{
"inProgressJobs" : [ JobExecutionSummary ... ], 
"queuedJobs" : [ JobExecutionSummary ... ]
}

Untuk informasi selengkapnya, lihat GetPendingJobExecutions.

Mendapat dan memulai eksekusi pekerjaan tertunda berikutnya untuk suatu hal (dengan status IN_PROGRESS atauQUEUED).

  • Setiap eksekusi pekerjaan dengan status IN_PROGRESS dikembalikan terlebih dahulu.

  • Eksekusi Job dikembalikan dalam urutan di mana mereka diciptakan.

  • Jika eksekusi pekerjaan tertunda berikutnyaQUEUED, statusnya berubah menjadi IN_PROGRESS dan rincian status eksekusi pekerjaan ditetapkan seperti yang ditentukan.

  • Jika eksekusi pekerjaan tertunda berikutnya sudahIN_PROGRESS, detail statusnya tidak berubah.

  • Jika tidak ada eksekusi pekerjaan yang tertunda, respons tidak menyertakan execution bidang.

  • Secara opsional, Anda dapat membuat pengatur waktu langkah dengan menetapkan nilai untuk stepTimeoutInMinutes properti. Jika Anda tidak memperbarui nilai properti ini dengan menjalankanUpdateJobExecution, eksekusi pekerjaan akan habis saat pengatur waktu langkah kedaluwarsa.

HTTPS request

Contoh berikut menunjukkan sintaks permintaan:

PUT /things/thingName/jobs/$next
{
"statusDetails": { 
    "string": "string" 
    ... 
},
"stepTimeoutInMinutes": long
}

Untuk informasi selengkapnya, lihat StartNextPendingJobExecution.

CLI syntax

Sinopsis:

aws iot-jobs-data  start-next-pending-job-execution \
--thing-name <value> \
{--step-timeout-in-minutes <value>] \
[--status-details <value>]  \
[--cli-input-json <value>] \
[--generate-cli-skeleton]

cli-input-jsonformat:

{
"thingName": "string",
"statusDetails": {
"string": "string"
},
"stepTimeoutInMinutes": long
}

Untuk informasi selengkapnya, lihat start-next-pending-job-execution.

Mendapat dan memulai eksekusi pekerjaan tertunda berikutnya untuk suatu hal (dengan status IN_PROGRESS atauQUEUED).

  • Setiap eksekusi pekerjaan dengan status IN_PROGRESS dikembalikan terlebih dahulu.

  • Eksekusi Job dikembalikan dalam urutan di mana mereka diciptakan.

  • Jika eksekusi pekerjaan tertunda berikutnyaQUEUED, statusnya berubah menjadi IN_PROGRESS dan rincian status eksekusi pekerjaan ditetapkan seperti yang ditentukan.

  • Jika eksekusi pekerjaan tertunda berikutnya sudahIN_PROGRESS, detail statusnya tidak berubah.

  • Jika tidak ada eksekusi pekerjaan yang tertunda, respons tidak menyertakan execution bidang.

  • Secara opsional, Anda dapat membuat pengatur waktu langkah dengan menetapkan nilai untuk stepTimeoutInMinutes properti. Jika Anda tidak memperbarui nilai properti ini dengan menjalankanUpdateJobExecution, eksekusi pekerjaan akan habis saat pengatur waktu langkah kedaluwarsa.

HTTPS request

Contoh berikut menunjukkan sintaks permintaan:

PUT /things/thingName/jobs/$next
{
"statusDetails": { 
    "string": "string" 
    ... 
},
"stepTimeoutInMinutes": long
}

Untuk informasi selengkapnya, lihat StartNextPendingJobExecution.

CLI syntax

Sinopsis:

aws iot-jobs-data  start-next-pending-job-execution \
--thing-name <value> \
{--step-timeout-in-minutes <value>] \
[--status-details <value>]  \
[--cli-input-json <value>] \
[--generate-cli-skeleton]

cli-input-jsonformat:

{
"thingName": "string",
"statusDetails": {
"string": "string"
},
"stepTimeoutInMinutes": long
}

Untuk informasi selengkapnya, lihat start-next-pending-job-execution.

anchoranchor

Contoh berikut menunjukkan sintaks permintaan:

PUT /things/thingName/jobs/$next
{
"statusDetails": { 
    "string": "string" 
    ... 
},
"stepTimeoutInMinutes": long
}

Untuk informasi selengkapnya, lihat StartNextPendingJobExecution.

Mendapat informasi rinci tentang eksekusi pekerjaan.

Anda dapat mengatur jobId to $next untuk mengembalikan eksekusi pekerjaan tertunda berikutnya untuk suatu hal. Status eksekusi pekerjaan harus QUEUED atauIN_PROGRESS.

HTTPS request

Permintaan:

GET /things/thingName/jobs/jobId?executionNumber=executionNumber&includeJobDocument=includeJobDocument

Respons:

{
"execution" : JobExecution,
}

Untuk informasi selengkapnya, lihat DescribeJobExecution.

CLI syntax

Sinopsis:

aws iot-jobs-data  describe-job-execution \
--job-id <value> \
--thing-name <value> \
[--include-job-document | --no-include-job-document] \
[--execution-number <value>]  \
[--cli-input-json <value>] \
[--generate-cli-skeleton]

cli-input-jsonformat:

{
"jobId": "string",
"thingName": "string",
"includeJobDocument": boolean,
"executionNumber": long
}

Untuk informasi selengkapnya, lihat describe-job-execution.

Mendapat informasi rinci tentang eksekusi pekerjaan.

Anda dapat mengatur jobId to $next untuk mengembalikan eksekusi pekerjaan tertunda berikutnya untuk suatu hal. Status eksekusi pekerjaan harus QUEUED atauIN_PROGRESS.

HTTPS request

Permintaan:

GET /things/thingName/jobs/jobId?executionNumber=executionNumber&includeJobDocument=includeJobDocument

Respons:

{
"execution" : JobExecution,
}

Untuk informasi selengkapnya, lihat DescribeJobExecution.

CLI syntax

Sinopsis:

aws iot-jobs-data  describe-job-execution \
--job-id <value> \
--thing-name <value> \
[--include-job-document | --no-include-job-document] \
[--execution-number <value>]  \
[--cli-input-json <value>] \
[--generate-cli-skeleton]

cli-input-jsonformat:

{
"jobId": "string",
"thingName": "string",
"includeJobDocument": boolean,
"executionNumber": long
}

Untuk informasi selengkapnya, lihat describe-job-execution.

anchoranchor

Permintaan:

GET /things/thingName/jobs/jobId?executionNumber=executionNumber&includeJobDocument=includeJobDocument

Respons:

{
"execution" : JobExecution,
}

Untuk informasi selengkapnya, lihat DescribeJobExecution.

Memperbarui status eksekusi pekerjaan. Secara opsional, Anda dapat membuat pengatur waktu langkah dengan menetapkan nilai untuk stepTimeoutInMinutes properti. Jika Anda tidak memperbarui nilai properti ini dengan menjalankan UpdateJobExecution lagi, eksekusi pekerjaan akan habis saat pengatur waktu langkah kedaluwarsa.

HTTPS request

Permintaan:

POST /things/thingName/jobs/jobId
{
"status": "job-execution-state",
"statusDetails": { 
    "string": "string"
    ...
},
"expectedVersion": "number",
"includeJobExecutionState": boolean,
"includeJobDocument": boolean,
"stepTimeoutInMinutes": long,
"executionNumber": long 
}

Untuk informasi selengkapnya, lihat UpdateJobExecution.

CLI syntax

Sinopsis:

aws iot-jobs-data  update-job-execution \
--job-id <value> \
--thing-name <value> \
--status <value> \
[--status-details <value>] \
[--expected-version <value>] \
[--include-job-execution-state | --no-include-job-execution-state] \
[--include-job-document | --no-include-job-document] \
[--execution-number <value>]  \
[--cli-input-json <value>] \
[--step-timeout-in-minutes <value>] \
[--generate-cli-skeleton]

cli-input-jsonformat:

{
"jobId": "string",
"thingName": "string",
"status": "string",
"statusDetails": {
"string": "string"
},
"stepTimeoutInMinutes": number,
"expectedVersion": long,
"includeJobExecutionState": boolean,
"includeJobDocument": boolean,
"executionNumber": long
}

Untuk informasi selengkapnya, lihat update-job-execution.

Memperbarui status eksekusi pekerjaan. Secara opsional, Anda dapat membuat pengatur waktu langkah dengan menetapkan nilai untuk stepTimeoutInMinutes properti. Jika Anda tidak memperbarui nilai properti ini dengan menjalankan UpdateJobExecution lagi, eksekusi pekerjaan akan habis saat pengatur waktu langkah kedaluwarsa.

HTTPS request

Permintaan:

POST /things/thingName/jobs/jobId
{
"status": "job-execution-state",
"statusDetails": { 
    "string": "string"
    ...
},
"expectedVersion": "number",
"includeJobExecutionState": boolean,
"includeJobDocument": boolean,
"stepTimeoutInMinutes": long,
"executionNumber": long 
}

Untuk informasi selengkapnya, lihat UpdateJobExecution.

CLI syntax

Sinopsis:

aws iot-jobs-data  update-job-execution \
--job-id <value> \
--thing-name <value> \
--status <value> \
[--status-details <value>] \
[--expected-version <value>] \
[--include-job-execution-state | --no-include-job-execution-state] \
[--include-job-document | --no-include-job-document] \
[--execution-number <value>]  \
[--cli-input-json <value>] \
[--step-timeout-in-minutes <value>] \
[--generate-cli-skeleton]

cli-input-jsonformat:

{
"jobId": "string",
"thingName": "string",
"status": "string",
"statusDetails": {
"string": "string"
},
"stepTimeoutInMinutes": number,
"expectedVersion": long,
"includeJobExecutionState": boolean,
"includeJobDocument": boolean,
"executionNumber": long
}

Untuk informasi selengkapnya, lihat update-job-execution.

anchoranchor

Permintaan:

POST /things/thingName/jobs/jobId
{
"status": "job-execution-state",
"statusDetails": { 
    "string": "string"
    ...
},
"expectedVersion": "number",
"includeJobExecutionState": boolean,
"includeJobDocument": boolean,
"stepTimeoutInMinutes": long,
"executionNumber": long 
}

Untuk informasi selengkapnya, lihat UpdateJobExecution.

Related resources

AWS IoT Core Referensi API
AWS CLI perintah untuk AWS IoT Core
SDKs & Alat 

Related resources

AWS IoT Core Referensi API
AWS CLI perintah untuk AWS IoT Core
SDKs & Alat 
PrivasiSyarat situsPreferensi cookie
© 2025, Amazon Web Services, Inc. atau afiliasinya. Semua hak dilindungi undang-undang.