Menghentikan sumber daya perintah - AWS IoT Core
Pertimbangan utamaMenghilangkan sumber daya perintah (konsol)Menghilangkan sumber daya perintah (CLI)Periksa waktu dan status penghentianKembalikan sumber daya perintah

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

Menghentikan sumber daya perintah

Usang perintah untuk menunjukkan bahwa perintah tersebut sudah usang dan tidak boleh digunakan. Misalnya, perintah usang tidak lagi dipertahankan secara aktif atau saat membuat perintah yang lebih baru dengan ID yang sama tetapi muatan yang berbeda.

Pertimbangan utama

Pertimbangan penting saat menghentikan perintah:

  • Menghentikan perintah tidak menghapusnya. Anda dapat mengambil perintah menggunakan ID dan mengembalikannya untuk digunakan kembali.

  • Mencoba untuk memulai eksekusi baru pada perintah usang menghasilkan kesalahan, mencegah penggunaan perintah usang.

  • Untuk menjalankan perintah usang, pertama-tama pulihkan. Setelah restorasi, perintah menjadi tersedia untuk penggunaan reguler dan eksekusi pada perangkat target.

  • Jika Anda menghentikan perintah saat eksekusi sedang berlangsung, perintah tersebut akan terus berjalan hingga selesai. Anda masih dapat mengambil status eksekusi.

Menghilangkan sumber daya perintah (konsol)

Untuk menghentikan perintah dari konsol, buka Command Hub AWS IoT konsol dan lakukan langkah-langkah berikut.

  1. Pilih perintah yang ingin Anda hentikan, lalu di bawah Actions, pilih Deprecate.

  2. Konfirmasikan bahwa Anda ingin menghentikan perintah dan kemudian pilih Deprecate.

Menghilangkan sumber daya perintah (CLI)

Tandai perintah sebagai usang menggunakan CLI. update-command Anda harus menghentikan perintah sebelum penghapusan. Untuk menggunakan perintah usang, pulihkan terlebih dahulu.

aws iot update-command \ 
    --command-id <command-id> \ 
    --deprecated

Misalnya, jika Anda menghentikan ACSwitch perintah yang Anda perbarui dalam contoh di atas, kode berikut menunjukkan contoh keluaran menjalankan perintah.

{
    "commandId": "turnOffAc",
    "deprecated": true,
    "lastUpdatedAt": "2024-05-09T23:16:51.370000-07:00"
}

Periksa waktu dan status penghentian

Gunakan GetCommand API untuk menentukan apakah perintah tidak digunakan lagi dan kapan terakhir kali tidak digunakan lagi.

aws iot get-command --command-id <turnOffAC>

Perintah ini menghasilkan respons yang berisi informasi perintah, termasuk cap waktu pembuatan dan penghentian dari bidang yang terakhir diperbarui. Ini membantu menentukan masa pakai perintah dan apakah akan menghapus atau menggunakannya kembali. Berikut ini menunjukkan respons sampel untuk turnOffAc perintah:

{
    "commandId": "turnOffAC",
    "commandArn": "arn:aws:iot:us-east-1:123456789012:command/turnOffAC",
    "namespace": "AWS-IoT",
    "payload": {
        "content": "testPayload.json",
        "contentType": "application/json"
    },
    "createdAt": "2024-03-23T00:50:10.095000-07:00",
    "lastUpdatedAt": "2024-05-09T23:16:51.370000-07:00",
    "deprecated": false
}

Kembalikan sumber daya perintah

Untuk menggunakan atau mengirim ACSwitch perintah ke perangkat Anda, pulihkan terlebih dahulu.

Untuk memulihkan perintah dari konsol, buka Command Hub AWS IoT konsol, pilih perintah yang ingin Anda pulihkan, lalu di bawah Tindakan, pilih Pulihkan.

Untuk memulihkan perintah menggunakan AWS IoT Core API atau AWS CLI, gunakan operasi UpdateCommand API atau update-command CLI. Kode berikut menunjukkan permintaan sampel dan respons.

aws iot update-command \ 
    --command-id <command-id> 
    --no-deprecated

Kode berikut menunjukkan output sampel.

{
    "commandId": "ACSwitch",
    "deprecated": false,
    "lastUpdatedAt": "2024-05-09T23:17:21.954000-07:00"
}