Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Kelola AWS kendaraan IoT FleetWise
Kendaraan adalah contoh model kendaraan. Kendaraan harus dibuat dari model kendaraan dan dikaitkan dengan manifes decoder. Kendaraan mengunggah satu atau lebih aliran data ke cloud. Misalnya, kendaraan dapat mengirim jarak tempuh, suhu mesin, dan status data pemanas ke cloud. Setiap kendaraan berisi informasi berikut:
`vehicleName`
ID yang mengidentifikasi kendaraan.
Jangan menambahkan informasi identitas pribadi (PII) atau informasi rahasia atau sensitif lainnya dalam nama kendaraan Anda. Nama kendaraan dapat diakses oleh AWS layanan lain, termasuk Amazon CloudWatch. Nama kendaraan tidak dimaksudkan untuk digunakan untuk data pribadi atau sensitif.
`modelManifestARN`
Nama Sumber Daya Amazon (ARN) dari model kendaraan (manifes model). Setiap kendaraan dibuat dari model kendaraan. Kendaraan yang dibuat dari model kendaraan yang sama terdiri dari kelompok sinyal yang sama yang diwarisi dari model kendaraan. Sinyal-sinyal ini didefinisikan dan distandarisasi dalam katalog sinyal.
`decoderManifestArn`
ARN dari manifes decoder. Manifes decoder menyediakan informasi decoding yang FleetWise dapat digunakan AWS IoT untuk mengubah data sinyal mentah (data biner) menjadi nilai yang dapat dibaca manusia. Manifes dekoder harus dikaitkan dengan model kendaraan. AWS IoT FleetWise menggunakan manifes decoder yang sama untuk memecahkan kode data mentah dari kendaraan yang dibuat berdasarkan model kendaraan yang sama.
`attributes`
Atribut adalah pasangan kunci-nilai yang berisi informasi statis. Kendaraan dapat berisi atribut yang diwarisi dari model kendaraan. Anda dapat menambahkan atribut tambahan untuk membedakan kendaraan individu dari kendaraan lain yang dibuat dari model kendaraan yang sama. Misalnya, jika Anda memiliki mobil hitam, Anda dapat menentukan nilai berikut untuk atribut:`{"color": "black"}`.
Atribut harus didefinisikan dalam model kendaraan terkait sebelum Anda dapat menambahkannya ke kendaraan individu.
Untuk informasi selengkapnya tentang model kendaraan, manifes decoder, dan atribut, lihat. [Model AWS kendaraan IoT FleetWise](vehicle-modeling.md)
AWS IoT FleetWise menyediakan operasi API berikut yang dapat Anda gunakan untuk membuat dan mengelola kendaraan.
+ [CreateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateVehicle.html)— Menciptakan kendaraan baru.
+ [BatchCreateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_BatchCreateVehicle.html)— Menciptakan satu atau lebih kendaraan baru.
+ [UpdateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateVehicle.html)— Memperbarui kendaraan yang ada.
+ [BatchUpdateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_BatchUpdateVehicle.html)— Memperbarui satu atau lebih kendaraan yang ada.
+ [DeleteVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteVehicle.html)— Menghapus kendaraan yang ada.
+ [ListVehicles](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListVehicles.html)— Mengambil daftar ringkasan semua kendaraan yang diberi halaman.
+ [GetVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetVehicle.html)— Mengambil informasi tentang kendaraan.
**Topics**
+ [Penyediaan AWS kendaraan IoT FleetWise](provision-vehicles.md)
+ [Topik yang dicadangkan di AWS IoT FleetWise](reserved-topics.md)
+ [Buat kendaraan AWS IoT FleetWise](create-vehicle.md)
+ [Buat beberapa kendaraan AWS IoT FleetWise](create-vehicles-cli.md)
+ [Perbarui kendaraan AWS IoT FleetWise](update-vehicle-cli.md)
+ [Perbarui beberapa AWS kendaraan IoT FleetWise](update-vehicles-cli.md)
+ [Hapus kendaraan AWS IoT FleetWise](delete-vehicle.md)
+ [Dapatkan AWS informasi kendaraan IoT FleetWise](get-vehicle-information-cli.md)
# Penyediaan AWS kendaraan IoT FleetWise
Agen Edge untuk FleetWise perangkat lunak AWS IoT yang berjalan di kendaraan Anda mengumpulkan dan mentransfer data ke cloud. AWS IoT FleetWise terintegrasi dengan AWS IoT Core untuk mendukung komunikasi yang aman antara perangkat lunak Edge Agent dan cloud melalui MQTT. Setiap kendaraan sesuai dengan suatu AWS IoT hal. Anda dapat menggunakan AWS IoT benda yang sudah ada untuk membuat kendaraan atau mengatur AWS IoT FleetWise untuk secara otomatis membuat AWS IoT sesuatu untuk kendaraan Anda. Untuk informasi selengkapnya, lihat [Buat kendaraan AWS IoT FleetWise](create-vehicle.md).
AWS IoT Core mendukung [otentikasi](https://docs.aws.amazon.com/iot/latest/developerguide/authentication.html) dan [otorisasi](https://docs.aws.amazon.com/iot/latest/developerguide/iot-authorization.html) yang membantu mengontrol akses ke sumber daya AWS IoT dengan aman. FleetWise Kendaraan dapat menggunakan sertifikat X.509 untuk mendapatkan otentikasi (masuk) untuk menggunakan AWS IoT FleetWise dan AWS IoT Core kebijakan untuk mendapatkan otorisasi (memiliki izin) untuk melakukan tindakan tertentu.
## Otentikasi kendaraan
Anda dapat membuat AWS IoT Core kebijakan untuk mengautentikasi kendaraan Anda.
**Untuk mengautentikasi kendaraan Anda**
+ Untuk membuat AWS IoT Core kebijakan, jalankan perintah berikut.
+ Ganti *policy-name* dengan nama kebijakan yang ingin Anda buat.
+ Ganti *file-name* dengan nama file JSON yang berisi AWS IoT Core kebijakan.
```
aws iot create-policy --policy-name policy-name --policy-document file://file-name.json
```
### Contoh AWS IoT Core kebijakan
Sebelum Anda menggunakan kebijakan contoh, lakukan hal berikut:
+ Ganti *us-east-1* dengan AWS Wilayah tempat Anda membuat sumber daya AWS IoT FleetWise.
+ Ganti *111122223333* dengan ID AWS akun Anda.
Contoh ini mencakup topik yang dicadangkan oleh AWS IoT FleetWise. Anda harus menambahkan topik ke kebijakan. Untuk informasi selengkapnya, lihat [Topik yang dicadangkan di AWS IoT FleetWise](reserved-topics.md).
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"iot:Connect"
],
"Resource": [
"arn:aws:iot:us-east-1:111122223333:client/${iot:Connection.Thing.ThingName}"
]
},
{
"Effect": "Allow",
"Action": [
"iot:Publish"
],
"Resource": [
"arn:aws:iot:us-east-1:111122223333:topic/$aws/iotfleetwise/vehicles/${iot:Connection.Thing.ThingName}/checkins",
"arn:aws:iot:us-east-1:111122223333:topic/$aws/iotfleetwise/vehicles/${iot:Connection.Thing.ThingName}/signals"
]
},
{
"Effect": "Allow",
"Action": [
"iot:Subscribe"
],
"Resource": [
"arn:aws:iot:us-east-1:111122223333:topicfilter/$aws/iotfleetwise/vehicles/${iot:Connection.Thing.ThingName}/collection_schemes",
"arn:aws:iot:us-east-1:111122223333:topicfilter/$aws/iotfleetwise/vehicles/${iot:Connection.Thing.ThingName}/decoder_manifests"
]
},
{
"Effect": "Allow",
"Action": [
"iot:Receive"
],
"Resource": [
"arn:aws:iot:us-east-1:111122223333:topic/$aws/iotfleetwise/vehicles/${iot:Connection.Thing.ThingName}/collection_schemes",
"arn:aws:iot:us-east-1:111122223333:topic/$aws/iotfleetwise/vehicles/${iot:Connection.Thing.ThingName}/decoder_manifests"
]
}
]
}
```
------
## Otorisasi kendaraan
Anda dapat membuat sertifikat X.509 untuk mengotorisasi kendaraan Anda.
**Untuk mengotorisasi kendaraan Anda**
**penting**
Kami menyarankan Anda membuat sertifikat baru untuk setiap kendaraan.
1. Untuk membuat key pair RSA dan mengeluarkan sertifikat X.509, jalankan perintah berikut.
+ Ganti *cert* dengan nama file yang menyimpan isi output perintah CertificatePEM.
+ Ganti *public-key* dengan nama file yang menyimpan isi output perintah KeyPair. PublicKey.
+ Ganti *private-key* dengan nama file yang menyimpan isi output perintah KeyPair. PrivateKey.
```
aws iot create-keys-and-certificate \
--set-as-active \
--certificate-pem-outfile cert.pem \
--public-key-outfile public-key.key" \
--private-key-outfile private-key.key"
```
1. Salin Nama Sumber Daya Amazon (ARN) sertifikat dari output.
1. Untuk melampirkan kebijakan ke sertifikat, jalankan perintah berikut.
+ Ganti *policy-name* dengan nama AWS IoT Core kebijakan yang Anda buat.
+ Ganti *certificate-arn* dengan ARN sertifikat yang Anda salin.
```
aws iot attach-policy \
--policy-name policy-name\
--target "certificate-arn"
```
1. Untuk melampirkan sertifikat ke benda itu, jalankan perintah berikut.
+ Ganti *thing-name* dengan nama AWS IoT barang Anda atau ID kendaraan Anda.
+ Ganti *certificate-arn* dengan ARN sertifikat yang Anda salin.
```
aws iot attach-thing-principal \
--thing-name thing-name \
--principal "certificate-arn"
```
# Topik yang dicadangkan di AWS IoT FleetWise
**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).
AWS IoT FleetWise mencadangkan penggunaan topik-topik berikut. Jika topik yang dicadangkan memungkinkan, Anda dapat berlangganan atau mempublikasikannya. Namun, Anda tidak dapat membuat topik baru yang dimulai dengan tanda dolar (\$1). Jika Anda menggunakan operasi publikasi atau berlangganan yang tidak didukung dengan topik yang dicadangkan, hal itu dapat mengakibatkan koneksi berakhir.
| Topik | Operasi klien diizinkan | Deskripsi |
| --- | --- | --- |
| `$aws/iotfleetwise/vehicles/vehicleName/checkins` | Publikasikan | Perangkat lunak Edge Agent menerbitkan informasi status kendaraan untuk topik ini. Informasi status kendaraan dipertukarkan dalam format buffer protokol (Protobuf). Untuk informasi selengkapnya, lihat Panduan [https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models). |
| `$aws/iotfleetwise/vehicles/vehicleName/signals` | Publikasikan | Perangkat lunak Edge Agent menerbitkan sinyal untuk topik ini. Informasi sinyal dipertukarkan dalam format buffer protokol (Protobuf). Untuk informasi selengkapnya, lihat Panduan [https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models). |
| `$aws/iotfleetwise/vehicles/vehicleName/collection_schemes` | Langganan | AWS IoT FleetWise menerbitkan skema pengumpulan data untuk topik ini. Kendaraan mengkonsumsi skema pengumpulan data ini. |
| `$aws/iotfleetwise/vehicles/vehicleName/decoder_manifests` | Langganan | AWS IoT FleetWise menerbitkan manifes decoder untuk topik ini. Kendaraan mengkonsumsi manifes decoder ini. |
| `$aws/iotfleetwise/vehicles/vehicleName/command/request` | Langganan | AWS IoT FleetWise menerbitkan permintaan untuk menjalankan perintah ke topik ini. Kendaraan kemudian mengkonsumsi permintaan perintah ini. |
| `$aws/iotfleetwise/vehicles/vehicleName/command/response` | Publikasikan | Perangkat lunak Edge Agent menerbitkan tanggapan perintah dari kendaraan ke topik ini. Respons perintah dipertukarkan dalam format buffer protokol (Protobuf). Untuk informasi selengkapnya, lihat Panduan [https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models). |
| `$aws/iotfleetwise/vehicles/vehicleName/command/notification` | Langganan | AWS IoT FleetWise menerbitkan pembaruan status perintah untuk topik ini. Notifikasi dikirim dalam format JSON. |
| `$aws/iotfleetwise/vehicles/$vehicle_name/last_known_states/config` | Langganan | AWS IoT FleetWise menerbitkan konfigurasi templat status untuk topik ini. Kendaraan menggunakan konfigurasi template status ini. |
| `$aws/iotfleetwise/vehicles/$vehicle_name/last_known_states/data` | Publikasikan | Perangkat lunak Edge Agent menerbitkan data yang dikumpulkan dari sinyal ke topik ini. |
| `$aws/iotfleetwise/vehicles/$vehicle_name/last_known_state/$state_template_name/data` | Langganan | AWS IoT FleetWise menerbitkan data yang dikumpulkan dari sinyal yang dikonfigurasi dalam yang ditentukan `$state_template_name` untuk topik ini. Pembaruan dapat sebagian. Misalnya, jika asosiasi templat status berisi beberapa sinyal dengan strategi pembaruan saat berubah, maka hanya sinyal yang telah berubah yang terkandung dalam pesan tertentu. Informasi sinyal dipertukarkan dalam format buffer protokol (Protobuf). Untuk informasi selengkapnya, lihat Panduan [https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models). |
# Buat kendaraan AWS IoT FleetWise
**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).
Anda dapat menggunakan FleetWise konsol AWS IoT atau API untuk membuat kendaraan.
**penting**
Sebelum Anda mulai, periksa yang berikut ini:
Anda harus memiliki model kendaraan dan status model kendaraan harus`ACTIVE`. Untuk informasi selengkapnya, lihat [Kelola AWS model kendaraan IoT FleetWiseModel kendaraan](vehicle-models.md).
Model kendaraan Anda harus dikaitkan dengan manifes decoder, dan status manifes decoder harus. `ACTIVE` Untuk informasi selengkapnya, lihat [Kelola AWS manifes dekoder IoT FleetWise](decoder-manifests.md).
**Topics**
+ [Buat kendaraan (konsol)](#create-vehicle-console)
+ [Buat kendaraan (AWS CLI)](#create-vehicle-cli)
## Buat kendaraan (konsol)
Anda dapat menggunakan FleetWise konsol AWS IoT untuk membuat kendaraan.
**Untuk membuat kendaraan**
1. Buka konsol [AWS IoT FleetWise ](https://console.aws.amazon.com/iotfleetwise).
1. Pada panel navigasi, pilih **Kendaraan**.
1. Pada halaman ringkasan kendaraan, pilih **Buat kendaraan**, lalu lakukan langkah-langkah berikut.
**Topics**
+ [Langkah 1: Tentukan properti kendaraan](#define-vehicle-properties-console)
+ [Langkah 2: Konfigurasikan sertifikat kendaraan](#define-vehicle-certificate-console)
+ [Langkah 3: Lampirkan kebijakan ke sertifikat](#attach-vehicle-policy-console)
+ [Langkah 4: Tinjau dan buat](#review-and-create-vehicle-console)
### Langkah 1: Tentukan properti kendaraan
Pada langkah ini, Anda memberi nama kendaraan dan mengaitkannya dengan manifes model dan manifes dekoder.
1. Masukkan nama unik untuk kendaraan.
**penting**
Kendaraan sesuai dengan AWS IoT sesuatu. Jika sesuatu sudah ada dengan nama itu, pilih **Kaitkan kendaraan dengan IoT** untuk memperbarui barang dengan kendaraan. Atau, pilih nama kendaraan yang berbeda dan AWS IoT FleetWise akan secara otomatis membuat hal baru untuk kendaraan.
1. Pilih model kendaraan (manifes model) dari daftar.
1. Pilih manifes decoder dari daftar. Manifes decoder dikaitkan dengan model kendaraan.
1. (Opsional) Untuk mengaitkan atribut kendaraan, pilih **Tambahkan atribut**. Jika Anda melewati langkah ini, Anda harus menambahkan atribut setelah kendaraan dibuat sebelum Anda dapat menerapkannya ke kampanye.
1. (Opsional) Untuk mengaitkan tag dengan kendaraan, pilih **Tambahkan tag baru**. Anda juga dapat menambahkan tag setelah kendaraan dibuat.
1. Pilih **Berikutnya**.
### Langkah 2: Konfigurasikan sertifikat kendaraan
Untuk menggunakan kendaraan Anda sebagai AWS IoT sesuatu, Anda harus mengonfigurasi sertifikat kendaraan dengan kebijakan terlampir. Jika Anda melewati langkah ini, Anda harus mengonfigurasi sertifikat setelah kendaraan dibuat sebelum Anda dapat menerapkannya ke kampanye.
1. Pilih **Buat otomatis sertifikat baru (disarankan)**.
1. Pilih **Berikutnya**.
### Langkah 3: Lampirkan kebijakan ke sertifikat
Lampirkan kebijakan ke sertifikat yang Anda konfigurasikan pada langkah sebelumnya.
1. Untuk **Kebijakan**, masukkan nama kebijakan yang ada. Untuk membuat kebijakan baru, pilih **Buat kebijakan**.
1. Pilih **Berikutnya**.
### Langkah 4: Tinjau dan buat
Verifikasi konfigurasi untuk kendaraan, lalu pilih **Buat kendaraan**.
**penting**
Setelah kendaraan dibuat, Anda harus mengunduh sertifikat dan kunci. Anda akan menggunakan sertifikat dan kunci pribadi untuk menghubungkan kendaraan di Edge Agent untuk perangkat lunak AWS IoT FleetWise .
## Buat kendaraan (AWS CLI)
Saat Anda membuat kendaraan, Anda harus menggunakan model kendaraan yang dikaitkan dengan manifes dekoder. Anda dapat menggunakan operasi [CreateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateVehicle.html)API untuk membuat kendaraan. Contoh berikut menggunakan AWS CLI.
Untuk membuat kendaraan, jalankan perintah berikut.
Ganti *file-name* dengan nama file.json yang berisi konfigurasi kendaraan.
```
aws iotfleetwise create-vehicle --cli-input-json file://file-name.json
```
**Example — konfigurasi kendaraan**
+ (Opsional) `associationBehavior` Nilainya dapat berupa salah satu dari yang berikut:
+ `CreateIotThing`— Ketika kendaraan Anda dibuat, AWS IoT FleetWise secara otomatis membuat AWS IoT sesuatu dengan nama ID kendaraan Anda untuk kendaraan Anda.
+ `ValidateIotThingExists`— Gunakan AWS IoT hal yang sudah ada untuk membuat kendaraan.
Untuk membuat AWS IoT sesuatu, jalankan perintah berikut. Ganti *thing-name* dengan nama benda yang ingin Anda buat.
```
aws iot create-thing --thing-name thing-name
```
Jika tidak ditentukan, AWS IoT FleetWise secara otomatis menciptakan AWS IoT sesuatu untuk kendaraan Anda.
**penting**
Pastikan AWS IoT barang itu disediakan setelah kendaraan dibuat. Untuk informasi selengkapnya, lihat [Penyediaan AWS kendaraan IoT FleetWise](provision-vehicles.md).
+ Ganti *vehicle-name* dengan salah satu dari berikut ini.
+ Nama AWS IoT barang Anda jika `associationBehavior` dikonfigurasi ke`ValidateIotThingExists`.
+ ID kendaraan yang akan dibuat jika `associationBehavior` dikonfigurasi ke`CreateIotThing`.
ID kendaraan dapat memiliki 1-100 karakter. Karakter yang valid: a—z, A-Z, 0—9, dasbor (‐), garis bawah (\$1), dan titik dua (:).
+ Ganti *model-manifest-ARN* dengan ARN model kendaraan Anda (manifes model).
+ Ganti *decoder-manifest-ARN* dengan ARN dari manifes decoder yang terkait dengan model kendaraan yang ditentukan.
+ (Opsional) Anda dapat menambahkan atribut tambahan untuk membedakan kendaraan ini dari kendaraan lain yang dibuat dari model kendaraan yang sama. Misalnya, jika Anda memiliki mobil listrik, Anda dapat menentukan nilai berikut untuk atribut:`{"fuelType": "electric"}`.
**penting**
Atribut harus didefinisikan dalam model kendaraan terkait sebelum Anda dapat menambahkannya ke kendaraan individu.
```
{
"associationBehavior": "associationBehavior",
"vehicleName": "vehicle-name",
"modelManifestArn": "model-manifest-ARN",
"decoderManifestArn": "decoder-manifest-ARN",
"attributes": {
"key": "value"
}
}
```
**Example — kaitkan templat negara dengan kendaraan**
Anda dapat mengaitkan [templat status](state-templates.md) dengan kendaraan untuk memungkinkan pengumpulan pembaruan status dari kendaraan di cloud dengan menggunakan `stateTemplates` bidang.
Dalam contoh ini, `stateTemplateUpdateStrategy` bisa menjadi salah satu dari:
+ `periodic`: memungkinkan Anda untuk menentukan tingkat tetap di mana perangkat lunak Edge Agent akan mengirim pembaruan sinyal ke cloud (perangkat lunak Edge Agent akan mengirim pembaruan bahkan jika nilai sinyal tidak berubah di antara pembaruan).
+ `onChange`: Perangkat lunak Edge Agent akan mengirimkan pembaruan sinyal setiap kali sinyal berubah.
```
aws iotfleetwise create-vehicle --cli-input-json file://create-vehicle.json
```
Dimana `create-vehicle.json` file berisi (misalnya):
```
{
"associationBehavior": "associationBehavior",
"vehicleName": "vehicle-name",
"modelManifestArn": "model-manifest-ARN",
"decoderManifestArn": "decoder-manifest-ARN",
"attributes": {
"key": "value"
},
"stateTemplates": [
{
"identifier": "state-template-name",
"stateTemplateUpdateStrategy": {
"periodic": {
"stateTemplateUpdateRate": {
"unit": "SECOND",
"value": 10
}
}
}
}
]
}
```
Jika Anda [mengaktifkan enkripsi](key-management.md) menggunakan AWS KMS kunci terkelola pelanggan, sertakan pernyataan kebijakan berikut agar peran Anda dapat menjalankan operasi `CreateVehicle` API.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey*",
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
# Buat beberapa kendaraan AWS IoT FleetWise
Anda dapat menggunakan operasi [BatchCreateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_BatchCreateVehicle.html)API untuk membuat beberapa kendaraan sekaligus. Contoh berikut menggunakan AWS CLI.
Untuk membuat beberapa kendaraan, jalankan perintah berikut.
Ganti *file-name* dengan nama file.json yang berisi konfigurasi beberapa kendaraan.
```
aws iotfleetwise batch-create-vehicle --cli-input-json file://file-name.json
```
**Example — konfigurasi kendaraan**
```
{
"vehicles": [
{
"associationBehavior": "associationBehavior",
"vehicleName": "vehicle-name",
"modelManifestArn": "model-manifest-ARN",
"decoderManifestArn": "decoder-manifest-ARN",
"attributes": {
"key": "value"
}
},
{
"associationBehavior": "associationBehavior",
"vehicleName": "vehicle-name",
"modelManifestArn": "model-manifest-ARN",
"decoderManifestArn": "decoder-manifest-ARN",
"attributes": {
"key": "value"
}
}
]
}
```
Anda dapat membuat hingga 10 kendaraan untuk setiap operasi batch. Untuk informasi lebih lanjut tentang konfigurasi kendaraan, lihat[Buat kendaraan AWS IoT FleetWise](create-vehicle.md).
Jika Anda [mengaktifkan enkripsi](key-management.md) menggunakan AWS KMS kunci terkelola pelanggan, sertakan pernyataan kebijakan berikut agar peran Anda dapat menjalankan operasi `BatchCreateVehicle` API.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey*",
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
# Perbarui kendaraan AWS IoT FleetWise
**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).
Anda dapat menggunakan operasi [UpdateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateVehicle.html)API untuk memperbarui kendaraan yang ada. Contoh berikut menggunakan AWS CLI.
Untuk memperbarui kendaraan, jalankan perintah berikut.
Ganti *file-name* dengan nama file.json yang berisi konfigurasi kendaraan Anda.
```
aws iotfleetwise update-vehicle --cli-input-json file://file-name.json
```
**Example — konfigurasi kendaraan**
+ Ganti *vehicle-name* dengan ID kendaraan yang ingin Anda perbarui.
+ (Opsional) Ganti *model-manifest-ARN* dengan ARN model kendaraan (manifes model) yang Anda gunakan untuk mengganti model kendaraan yang digunakan.
+ (Opsional) Ganti *decoder-manifest-ARN* dengan ARN manifes dekoder Anda yang terkait dengan model kendaraan baru yang Anda tentukan.
+ (Opsional) Ganti *attribute-update-mode* dengan atribut kendaraan.
+ `Merge`— Gabungkan atribut baru ke atribut yang ada dengan memperbarui atribut yang ada dengan nilai baru dan menambahkan atribut baru jika tidak ada.
Misalnya, jika kendaraan memiliki atribut berikut:`{"color": "black", "fuelType": "electric"}`, dan Anda memperbarui kendaraan dengan atribut berikut:`{"color": "", "fuelType": "gasoline", "model": "x"}`, kendaraan yang diperbarui memiliki atribut berikut:`{"fuelType": "gasoline", "model": "x"}`.
+ `Overwrite`— Ganti atribut yang ada dengan atribut baru.
Misalnya, jika kendaraan memiliki atribut berikut:`{"color": "black", "fuelType": "electric"}`, dan Anda memperbarui kendaraan dengan `{"model": "x"}` atribut, kendaraan yang diperbarui memiliki `{"model": "x"}` atribut.
Ini diperlukan jika atribut hadir dalam input.
+ (Opsional) Untuk menambahkan atribut baru atau memperbarui yang sudah ada dengan nilai baru, konfigurasikan`attributes`. Misalnya, jika Anda memiliki mobil listrik, Anda dapat menentukan nilai berikut untuk atribut:`{"fuelType": "electric"}`.
Untuk menghapus atribut, konfigurasikan `attributeUpdateMode` ke`Merge`.
**penting**
Atribut harus didefinisikan dalam model kendaraan terkait sebelum Anda dapat menambahkannya ke kendaraan individu.
```
{
"vehicleName": "vehicle-name",
"modelManifestArn": "model-manifest-arn",
"decoderManifestArn": "decoder-manifest-arn",
"attributeUpdateMode": "attribute-update-mode"
}
}
```
**Example — menambah atau menghapus template negara yang terkait dengan kendaraan**
Anda dapat mengaitkan templat status tambahan atau menghapus asosiasi yang ada dari kendaraan menggunakan bidang berikut:
+ `stateTemplatesToAdd`
+ `stateTemplatesToRemove`
```
aws iotfleetwise update-vehicle --cli-input-json file://update-vehicle.json
```
Dimana `update-vehicle.json` file berisi (misalnya):
```
{
"vehicleName": "vehicle-name",
"modelManifestArn": "model-manifest-arn",
"decoderManifestArn": "decoder-manifest-arn",
"attributeUpdateMode": "attribute-update-mode",
"stateTemplatesToAdd": [
{
"identifier": "state-template-name",
"stateTemplateUpdateStrategy": {
"onChange": {}
}
}
],
"stateTemplatesToRemove": ["state-template-name"]
}
```
Jika Anda [mengaktifkan enkripsi](key-management.md) menggunakan AWS KMS kunci terkelola pelanggan, sertakan pernyataan kebijakan berikut agar peran Anda dapat menjalankan operasi `UpdateVehicle` API.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey*",
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
# Perbarui beberapa AWS kendaraan IoT FleetWise
Anda dapat menggunakan operasi [BatchUpdateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_BatchUpdateVehicle.html)API untuk memperbarui beberapa kendaraan yang ada sekaligus. Contoh berikut menggunakan AWS CLI.
Untuk memperbarui beberapa kendaraan, jalankan perintah berikut.
Ganti *file-name* dengan nama file.json yang berisi konfigurasi beberapa kendaraan.
```
aws iotfleetwise batch-update-vehicle --cli-input-json file://file-name.json
```
**Example — konfigurasi kendaraan**
```
{
"vehicles": [
{
"vehicleName": "vehicle-name",
"modelManifestArn": "model-manifest-arn",
"decoderManifestArn": "decoder-manifest-arn",
"mergeAttributes": true,
"attributes": {
"key": "value"
}
},
{
"vehicleName": "vehicle-name",
"modelManifestArn": "model-manifest-arn",
"decoderManifestArn": "decoder-manifest-arn",
"mergeAttributes": true,
"attributes": {
"key": "value"
}
}
]
}
```
Anda dapat memperbarui hingga 10 kendaraan untuk setiap operasi batch. Untuk informasi lebih lanjut tentang konfigurasi setiap kendaraan, lihat[Perbarui kendaraan AWS IoT FleetWise](update-vehicle-cli.md).
Jika Anda [mengaktifkan enkripsi](key-management.md) menggunakan AWS KMS kunci terkelola pelanggan, sertakan pernyataan kebijakan berikut agar peran Anda dapat menjalankan operasi `BatchUpdateVehicle` API.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey*",
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
# Hapus kendaraan AWS IoT FleetWise
Anda dapat menggunakan FleetWise konsol AWS IoT atau API untuk menghapus kendaraan.
**penting**
Setelah kendaraan dihapus, AWS IoT FleetWise secara otomatis menghapus kendaraan dari armada dan kampanye terkait. Untuk informasi selengkapnya, lihat [Kelola armada di AWS IoT FleetWise](fleets.md) dan [Kumpulkan FleetWise data AWS IoT dengan kampanye](campaigns.md). Namun, kendaraan masih ada sebagai benda atau masih dikaitkan dengan sesuatu di dalamnya AWS IoT Core. Untuk petunjuk cara menghapus sesuatu, lihat [Menghapus sesuatu](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html#delete-thing) di *Panduan AWS IoT Core Pengembang*.
## Hapus kendaraan (konsol)
Anda dapat menggunakan FleetWise konsol AWS IoT untuk menghapus kendaraan.
**Untuk menghapus kendaraan**
1. Buka konsol [AWS IoT FleetWise ](https://console.aws.amazon.com/iotfleetwise).
1. Pada panel navigasi, pilih **Kendaraan**.
1. Pada halaman **Kendaraan**, pilih tombol di sebelah kendaraan yang ingin Anda hapus.
1. Pilih **Hapus**.
1. Di **Hapus **vehicle-name****, masukkan nama kendaraan, lalu pilih **Hapus**.
## Hapus kendaraan (AWS CLI)
Anda dapat menggunakan operasi [DeleteVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteVehicle.html)API untuk menghapus kendaraan. Contoh berikut menggunakan AWS CLI.
Untuk menghapus kendaraan, jalankan perintah berikut.
Ganti *vehicle-name* dengan ID kendaraan yang ingin Anda hapus.
```
aws iotfleetwise delete-vehicle --vehicle-name vehicle-name
```
### Verifikasi penghapusan kendaraan
Anda dapat menggunakan operasi [ListVehicles](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListVehicles.html)API untuk memverifikasi apakah kendaraan telah dihapus. Contoh berikut menggunakan AWS CLI.
Untuk mengambil daftar paginasi ringkasan semua kendaraan, jalankan perintah berikut.
```
aws iotfleetwise list-vehicles
```
Jika Anda [mengaktifkan enkripsi](key-management.md) menggunakan AWS KMS kunci terkelola pelanggan, sertakan pernyataan kebijakan berikut agar peran Anda dapat menjalankan operasi `ListVehicles` API.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
# Dapatkan AWS informasi kendaraan IoT FleetWise
**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).
Anda dapat menggunakan operasi [GetVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetVehicle.html)API untuk mengambil informasi kendaraan. Contoh berikut menggunakan AWS CLI.
Untuk mengambil metadata kendaraan, jalankan perintah berikut.
Ganti *vehicle-name* dengan ID kendaraan yang ingin Anda ambil.
```
aws iotfleetwise get-vehicle --vehicle-name vehicle-name
```
**catatan**
Operasi ini [pada akhirnya konsisten](https://web.stanford.edu/class/cs345d-01/rl/eventually-consistent.pdf). Dengan kata lain, perubahan pada kendaraan mungkin tidak langsung tercermin.
Anda dapat menggunakan operasi [GetVehicleStatus](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetVehicleStatus.html)API untuk mengambil status sumber daya yang terkait dengan kendaraan. Contoh berikut menggunakan AWS CLI.
Untuk mengambil status sumber daya yang terkait dengan kendaraan, jalankan perintah berikut.
+ Ganti *vehicle-name* dengan ID kendaraan yang terkait dengan sumber daya.
+ Ganti *type* dengan jenis sumber daya yang statusnya ingin Anda ambil. Nilai yang valid untuk `type` adalah `CAMPAIGN`, `STATE_TEMPLATE`, dan `DECODER`.
```
aws iotfleetwise get-vehicle-status --vehicle-name vehicle-name --type type
```
Jika Anda [mengaktifkan enkripsi](key-management.md) menggunakan AWS KMS kunci terkelola pelanggan, sertakan pernyataan kebijakan berikut agar peran Anda dapat menjalankan operasi `GetVehicle` atau `GetVehicleStatus` API.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------