AWS IoT tidak FleetWise akan lagi terbuka untuk pelanggan baru pada 30 April 2026. FleetWise Pelanggan AWS IoT yang ada dapat terus menggunakan layanan ini. [Panduan untuk Mobilitas Terhubung AWS](https://aws.amazon.com/solutions/guidance/connected-mobility-on-aws/) memberikan panduan tentang cara mengembangkan dan menerapkan layanan modular untuk solusi mobilitas terhubung yang dapat digunakan untuk mencapai kemampuan yang setara dengan AWS IoT FleetWise.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Aktifkan dan nonaktifkan pengumpulan data negara menggunakan templat negara
**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](fleetwise-regions.md).
Bagian berikut menjelaskan cara mengaktifkan dan menonaktifkan konsumsi data dengan templat status menggunakan. AWS CLI
**penting**
Sebelum Anda mulai, pastikan bahwa Anda sudah membuat [template status](state-templates.md), dan mengaitkannya dan strategi pembaruannya dengan kendaraan.
Anda harus mengaktifkan templat status sehingga Agen Edge dapat mengirim pembaruan sinyal ke cloud.
Untuk melakukan operasi ini dengan template status, pertama buat sumber daya perintah dan kemudian mulai eksekusi perintah pada kendaraan. Bagian berikut menjelaskan cara menggunakan API ini dan cara mengaktifkan dan menonaktifkan konsumsi data.
**Topics**
+ [Menggunakan API `CreateCommand` ini](#start-stop-ingestion-create-command)
+ [Contoh: Aktifkan templat negara](#start-stop-ingestion-activate-template)
+ [Contoh: Nonaktifkan template status](#start-stop-ingestion-deactivate-template)
## Menggunakan API `CreateCommand` ini
Buat sumber daya perintah di namespace `AWS-IoTFleetwise` "”, dan gunakan parameter berikut saat Anda membuat atau mengirim sumber daya perintah untuk templat status:
+ `$stateTemplate.name`— Nama template negara tempat untuk melakukan operasi. Template status harus diterapkan pada kendaraan sebelum Anda dapat melakukan operasi. Untuk informasi selengkapnya, lihat [Kaitkan templat FleetWise status AWS IoT dengan kendaraan](state-templates.md#apply-state-templates).
+ `$stateTemplate.operation`— Operasi yang akan dilakukan pada template negara. Gunakan salah satu nilai berikut untuk parameter ini:
+ `activate`— Agen Edge mulai mengirim pembaruan sinyal ke cloud berdasarkan yang `stateTemplateUpdateStrategy` Anda tentukan (on-change atau periodik) saat Anda menerapkan templat status ke kendaraan. Untuk informasi selengkapnya, lihat [Kaitkan templat FleetWise status AWS IoT dengan kendaraan](state-templates.md#apply-state-templates).
Selain itu, Anda dapat menentukan waktu penonaktifan templat status otomatis untuk menghentikan pembaruan setelah jangka waktu tertentu. Jika waktu penonaktifan otomatis tidak disediakan, templat status akan terus mengirimkan pembaruan hingga panggilan nonaktif dikeluarkan.
Segera setelah `activate` perintah diterima, perangkat harus mengirim sinyal yang ditentukan dalam templat status sesuai dengan strategi pembaruan. AWS IoT FleetWise merekomendasikan bahwa ketika perintah aktifkan diterima oleh perangkat, pesan pertama yang dikirim harus berisi snapshot dari semua sinyal dalam template status. Pesan selanjutnya harus dikirim sesuai dengan strategi pembaruan.
+ `deactivate`— Agen Edge berhenti mengirim pembaruan sinyal ke cloud.
+ `fetchSnapshot`— Agen Edge mengirimkan snapshot satu kali dari sinyal yang ditentukan dalam templat status terlepas dari yang `stateTemplateUpdateStrategy` Anda tentukan saat Anda menerapkan templat status ke kendaraan.
+ (Opsional) `$stateTemplate.deactivateAfterSeconds` - Template status secara otomatis dinonaktifkan setelah waktu yang ditentukan. Parameter ini hanya dapat digunakan ketika nilai `$stateTemplate.operation` parameter adalah “aktifkan”. Jika parameter ini tidak ditentukan, atau jika nilai parameter ini adalah 0, Agen Edge terus mengirimkan pembaruan sinyal ke cloud hingga operasi “nonaktifkan” diterima untuk templat status. Template status tidak pernah dinonaktifkan secara otomatis.
Nilai minimum: 0, nilai maksimum: 4294967295.
**catatan**
API mengembalikan keberhasilan dalam menanggapi permintaan aktivasi untuk template yang sudah dalam status aktif.
API mengembalikan keberhasilan dalam menanggapi permintaan penonaktifan untuk template yang sudah dalam status penonaktifan.
Permintaan terbaru yang Anda buat pada templat status adalah permintaan yang berlaku. Misalnya, jika Anda membuat permintaan untuk template status untuk dinonaktifkan dalam satu jam, kemudian membuat permintaan kedua untuk template yang sama untuk dinonaktifkan dalam empat jam, penonaktifan empat jam akan berlaku karena itu menjadi permintaan terbaru.
**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.
## Contoh: Aktifkan templat negara
Untuk mengaktifkan templat status, pertama-tama buat sumber daya perintah. Anda kemudian dapat mengirim perintah berikut ke kendaraan tempat Anda ingin mengaktifkan templat status. Contoh ini menunjukkan bagaimana Anda dapat menentukan nilai default untuk parameter saat membuat perintah. Parameter ini dan nilai-nilainya digunakan saat memulai eksekusi perintah untuk mengaktifkan template status.
1.
**Buat sumber daya perintah**
Sebelum Anda dapat mengirim perintah ke kendaraan, Anda harus membuat sumber daya perintah. Anda dapat menentukan nilai alternatif untuk parameter wajib saat Anda mengirim perintah ke kendaraan. Untuk informasi selengkapnya, lihat [Buat sumber daya perintah](create-manage-remote-command-cli.md#create-remote-command-cli).
**penting**
`$stateTemplate.name`dan `$stateTemplate.operation` parameter harus disediakan sebagai tipe data string. Jika ada tipe data lain yang disediakan, atau jika salah satu dari dua parameter ini hilang, eksekusi perintah gagal dengan pengecualian validasi. `$stateTemplate.deactivateAfterSeconds`Parameter harus disediakan sebagai tipe `Long` data.
```
aws iot create-command \
--description "This command activates a state template on a vehicle"
--command-id ActivateStateTemplate \
--display-name "Activate State Template" \
--namespace AWS-IoTFleetWise \
--mandatory-parameters '[
{
"name": "$stateTemplate.name",
"defaultValue": {"S": "ST123"}
},
{
"name": "$stateTemplate.operation",
"defaultValue": {"S": "activate"}
},
{
"name": "$stateTemplate.deactivateAfterSeconds",
"defaultValue": {"L": "120"}
}
]'
```
1.
**Mulai eksekusi perintah pada kendaraan**
Setelah perintah dibuat, kirim perintah ke kendaraan. Jika Anda tidak menentukan nilai untuk parameter wajib saat Anda membuat sumber daya perintah, Anda harus menentukannya sekarang. Untuk informasi selengkapnya, lihat [Kirim perintah (AWS CLI)](send-monitor-remote-command-cli.md#send-remote-command-cli).
**penting**
Pastikan Anda menggunakan titik akhir API bidang data AWS IoT pekerjaan khusus akun untuk operasi API.
```
aws iot-jobs-data start-command-execution \
--endpoint-url \
--command-arn arn:aws:iot:{{region}}:{{111122223333}}:command/ActivateStateTemplate \
--target-arn arn:aws:iot:{{region}}:{{111122223333}}:thing/{{}}
```
1.
**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 {{}}
```
## Contoh: Nonaktifkan template status
Untuk menonaktifkan templat status, pertama-tama buat sumber daya perintah. Anda kemudian dapat mengirim perintah berikut ke kendaraan tempat Anda ingin menonaktifkan templat status. Contoh ini menunjukkan bagaimana Anda dapat menentukan nilai default untuk parameter saat membuat perintah. Parameter ini dan nilai-nilainya digunakan saat memulai eksekusi perintah untuk menonaktifkan template status.
1.
**Buat sumber daya perintah**
Sebelum Anda dapat mengirim perintah ke kendaraan, Anda harus membuat sumber daya perintah. Anda dapat menentukan nilai alternatif untuk parameter wajib saat Anda mengirim perintah ke kendaraan. Untuk informasi selengkapnya, lihat [Buat sumber daya perintah](create-manage-remote-command-cli.md#create-remote-command-cli).
```
aws iot create-command \
--description "This command deactivates a state template on a vehicle"
--command-id DeactivateStateTemplate \
--display-name "Deactivate State Template" \
--namespace AWS-IoTFleetWise \
--mandatory-parameters '[
{
"name": "$stateTemplate.name",
"defaultValue": {"S": "ST123"}
},
{
"name": "$stateTemplate.operation",
"defaultValue": {"S": "deactivate"}
}
]'
```
1.
**Mulai eksekusi perintah pada kendaraan**
Setelah perintah dibuat, kirim perintah ke kendaraan. Jika Anda tidak menentukan nilai untuk parameter wajib saat Anda membuat sumber daya perintah, Anda harus menentukannya sekarang. Untuk informasi selengkapnya, lihat [Kirim perintah (AWS CLI)](send-monitor-remote-command-cli.md#send-remote-command-cli).
```
aws iot-jobs-data start-command-execution \
--endpoint-url \
--command-arn arn:aws:iot:{{region}}:{{111122223333}}:command/DeactivateStateTemplate \
--target-arn arn:aws:iot:{{region}}:{{111122223333}}:thing/{{}}
```
1.
**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 {{}}
```