Ambil snapshot status kendaraan menggunakan templat status - AWS IoT FleetWise

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

Ambil snapshot status kendaraan menggunakan templat status

penting

Akses ke FleetWise fitur AWS IoT tertentu saat ini terjaga keamanannya. Untuk informasi selengkapnya, lihat AWS Ketersediaan wilayah dan fitur di AWS IoT FleetWise.

Anda dapat mengambil status terakhir kendaraan yang diketahui menggunakan operasi API bidang CreateCommand AWS IoT Core kontrol atau konsol AWS FleetWise IoT.

penting

Pengecualian validasi dapat terjadi dalam salah satu skenario berikut:

  • Templat negara disediakan yang tidak ASSOCIATED dengan kendaraan.

  • Permintaan dibuat untuk mengaktifkan templat status tetapi belum ada DEPLOYED di kendaraan.

  • Permintaan dibuat ke templat negara tetapi sedang berada DELETED di kendaraan.

Anda dapat menggunakan FleetWise konsol AWS IoT untuk mengambil status terakhir kendaraan yang diketahui. AWS IoT FleetWise akan membuat perintah bagi Anda untuk mengambil data.

Untuk mengambil status kendaraan

  1. Buka konsol AWS IoT FleetWise .

  2. Pada panel navigasi, pilih Kendaraan.

  3. Pilih kendaraan dari daftar untuk membuka halaman detailnya.

  4. Pada tab Templat negara, pilih Ambil data.

  5. Pilih peran IAM yang memberikan FleetWise izin AWS IoT untuk mengirim perintah dan mengambil data. Lihat Mengontrol akses.

  6. Pilih status Ambil.

Untuk mengambil snapshot status, pertama-tama buat sumber daya perintah. Anda kemudian dapat mengirim perintah berikut ke kendaraan yang ingin Anda ambil snapshot statusnya. Untuk informasi selengkapnya tentang penggunaan CreateCommand API dan parameternya, lihatMenggunakan API CreateCommand ini.

  1. Buat sumber daya perintah

    Contoh berikut menunjukkan cara membuat sumber daya perintah untuk melakukan operasi pengambilan. Anda dapat menentukan nilai alternatif untuk parameter wajib saat Anda mengirim perintah ke kendaraan. Untuk informasi selengkapnya, lihat Buat sumber daya perintah.

    aws iot create-command \
    --command-id <COMMAND_ID> \
    --display-name "FetchSnapshot State Template" \
    --namespace AWS-IoTFleetWise \
    --mandatory-parameters '[
      {
          "name": "$stateTemplate.name",
          "defaultValue": {"S": "ST123"}
      }, 
      {
          "name": "$stateTemplate.operation",
          "defaultValue": {"S": "fetchSnapshot"}
      }
    ]'

    Respons:

    { 
    "commandId": "<COMMAND_ID>",
    "commandArn": "arn:aws:iot:<REGION>:<ACCOUNT_ID>:command/<COMMAND_ID>"
}
  2. Mulai eksekusi perintah untuk mengambil snapshot status

    Setelah perintah dibuat, kirim perintah ke kendaraan. Jika Anda tidak menentukan nilai untuk parameter wajib saat membuat sumber daya perintah, Anda harus menentukannya sekarang. Untuk informasi selengkapnya, lihat Kirim perintah (AWS CLI).

    aws iot-jobs-data start-command-execution \
    --command-arn arn:aws:iot:<REGION>:<ACCOUNT_ID>:command/<COMMAND_ID> \
    --target-arn arn:aws:iot:<REGION>:<ACCOUNT_ID>:thing/<VEHICLE_NAME>

    Respons:

    {
    "executionId": "<UNIQUE_UUID>"
}

  3. Mengambil status operasi template negara

    Setelah Anda memulai eksekusi perintah, Anda dapat menggunakan GetCommandExecution API untuk mengambil template status.

    aws iot get-command-execution --execution-id <EXECUTION_ID>