AWS L'IoT non FleetWise è più aperto a nuovi clienti. FleetWise I clienti AWS IoT esistenti possono continuare a utilizzare il servizio. La [ Guidance for Connected Mobility on AWS](https://aws.amazon.com/solutions/guidance/connected-mobility-on-aws/) fornisce indicazioni su come sviluppare e implementare servizi modulari per soluzioni di mobilità connessa che possono essere utilizzate per ottenere funzionalità equivalenti a quelle dell' AWS IoT FleetWise.
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Crea un AWS FleetWise Veicolo IoT
**Importante**
L'accesso a determinate FleetWise funzionalità AWS dell'IoT è attualmente limitato. Per ulteriori informazioni, consulta [AWS Disponibilità di aree e funzionalità nell' AWS IoT FleetWise](fleetwise-regions.md).
Puoi utilizzare la FleetWise console o l'API AWS IoT per creare un veicolo.
**Importante**
Prima di iniziare, controlla quanto segue:
È necessario disporre di un modello di veicolo e lo stato del modello del veicolo deve essere`ACTIVE`. Per ulteriori informazioni, consulta [Gestisci i modelli di FleetWise veicoli AWS IoT](vehicle-models.md).
Il modello del veicolo deve essere associato a un manifesto del decodificatore e lo stato del manifesto del decodificatore deve esserlo. `ACTIVE` Per ulteriori informazioni, consulta [Gestione dei manifesti dei FleetWise decoder AWS IoT](decoder-manifests.md).
**Topics**
+ [Crea un veicolo (console)](#create-vehicle-console)
+ [Crea un veicolo (AWS CLI)](#create-vehicle-cli)
## Crea un veicolo (console)
Puoi utilizzare la FleetWise console AWS IoT per creare un veicolo.
**Per creare un veicolo**
1. Apri la FleetWise console [AWS IoT](https://console.aws.amazon.com/iotfleetwise).
1. Nel pannello di navigazione, scegli ** Veicoli**.
1. Nella pagina di riepilogo del veicolo, scegli ** Crea veicolo**, quindi procedi come segue.
**Topics**
+ [Fase 1: Definisci le proprietà del veicolo](#define-vehicle-properties-console)
+ [Fase 2: Configurare il certificato del veicolo](#define-vehicle-certificate-console)
+ [Passaggio 3: allegare le politiche al certificato](#attach-vehicle-policy-console)
+ [Fase 4: Revisione e creazione](#review-and-create-vehicle-console)
### Fase 1: Definisci le proprietà del veicolo
In questa fase, si assegna un nome al veicolo e lo si associa al manifesto del modello e al manifesto del decodificatore.
1. Inserisci un nome univoco per il veicolo.
**Importante**
Un veicolo corrisponde a AWS IoT qualcosa. Se esiste già un oggetto con quel nome, scegli ** Associa il veicolo a un oggetto IoT ** per aggiornarlo con il veicolo. Oppure, scegli un nome diverso per il veicolo e l' AWS IoT FleetWise creerà automaticamente una nuova cosa per il veicolo.
1. Scegli un modello di veicolo (manifesto del modello) dall'elenco.
1. Scegliete un manifesto del decodificatore dall'elenco. Il manifesto del decodificatore è associato al modello del veicolo.
1. (Facoltativo) Per associare gli attributi del veicolo, scegli ** Aggiungi attributi**. Se salti questo passaggio, devi aggiungere gli attributi dopo la creazione del veicolo prima di poterlo distribuire nelle campagne.
1. (Facoltativo) Per associare i tag al veicolo, scegli ** Aggiungi nuovo tag. ** Puoi aggiungere tag anche dopo la creazione del veicolo.
1. Scegli **Avanti**.
### Fase 2: Configurare il certificato del veicolo
Per utilizzare il veicolo come AWS IoT qualcosa, è necessario configurare un certificato del veicolo con una politica allegata. Se salti questo passaggio, devi configurare un certificato dopo la creazione del veicolo prima di poterlo distribuire nelle campagne.
1. Scegli ** Auto-generate un nuovo certificato (consigliato). **
1. Scegli **Avanti**.
### Passaggio 3: allegare le politiche al certificato
Allega una policy al certificato che hai configurato nel passaggio precedente.
1. Per ** Policy**, inserisci un nome di policy esistente. Per creare una nuova policy, scegli ** Crea policy**.
1. Scegli **Avanti**.
### Fase 4: Revisione e creazione
Verifica le configurazioni del veicolo, quindi scegli ** Crea veicolo**.
**Importante**
Dopo aver creato il veicolo, devi scaricare il certificato e le chiavi. Utilizzerai il certificato e la chiave privata per connettere il veicolo nel FleetWise software Edge Agent for AWS IoT.
## Crea un veicolo (AWS CLI)
Quando si crea un veicolo, è necessario utilizzare un modello di veicolo associato a un manifesto del decodificatore. È possibile utilizzare l'operazione [ CreateVehicle ](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateVehicle.html) API per creare un veicolo. Gli esempi seguenti utilizzano AWS CLI.
Per creare un veicolo, esegui il comando seguente.
Sostituiscilo {{file-name}} con il nome del file .json che contiene la configurazione del veicolo.
```
aws iotfleetwise create-vehicle --cli-input-json file://{{file-name}}.json
```
**Example — configurazione del veicolo**
+ (Facoltativo) Il `associationBehavior` valore può essere uno dei seguenti:
+ `CreateIotThing`— Quando il veicolo viene creato, l' AWS IoT crea FleetWise automaticamente un AWS IoT elemento con il nome dell'ID del veicolo.
+ `ValidateIotThingExists`— Usa un AWS IoT oggetto esistente per creare un veicolo.
Per creare un AWS IoT oggetto, esegui il comando seguente. Sostituisci {{thing-name}} con il nome dell'oggetto che vuoi creare.
```
aws iot create-thing --thing-name {{thing-name}}
```
Se non è specificato, l' AWS IoT crea FleetWise automaticamente AWS IoT qualcosa per il tuo veicolo.
**Importante**
Assicurati che l' AWS IoT oggetto sia predisposto dopo la creazione del veicolo. Per ulteriori informazioni, consulta [Fornitura AWS FleetWise Veicoli IoT](provision-vehicles.md).
+ Sostituiscilo {{vehicle-name}} con uno dei seguenti.
+ Il nome della AWS IoT cosa su cui `associationBehavior` è configurato`ValidateIotThingExists`.
+ L'ID del veicolo su cui crearlo `associationBehavior` è configurato`CreateIotThing`.
L'ID del veicolo può contenere da 1 a 100 caratteri. Caratteri validi: a—z, A—Z, 0—9, trattino (‐), trattino basso (\_) e due punti (:).
+ Sostituiscilo {{model-manifest-ARN}} con l'ARN del modello del tuo veicolo (manifesto del modello).
+ Sostituire {{decoder-manifest-ARN}} con l'ARN del manifesto del decodificatore associato al modello di veicolo specificato.
+ (Facoltativo) Puoi aggiungere attributi aggiuntivi per distinguere questo veicolo dagli altri veicoli creati con lo stesso modello di veicolo. Ad esempio, se hai un'auto elettrica, puoi specificare il seguente valore per un attributo:`{"fuelType": "electric"}`.
**Importante**
Gli attributi devono essere definiti nel modello di veicolo associato prima di poterli aggiungere ai singoli veicoli.
```
{
"associationBehavior": "{{associationBehavior}}",
"vehicleName": "{{vehicle-name}}",
"modelManifestArn": "{{model-manifest-ARN}}",
"decoderManifestArn": "{{decoder-manifest-ARN}}",
"attributes": {
"{{key}}": "{{value}}"
}
}
```
**Example — associare un modello di stato al veicolo**
È possibile [ associare modelli di ](state-templates.md) stato al veicolo per consentire la raccolta degli aggiornamenti di stato dal veicolo nel cloud utilizzando il `stateTemplates` campo.
In questo esempio, `{{stateTemplateUpdateStrategy}}` può essere uno dei seguenti:
+ `periodic`: consente di specificare una frequenza fissa alla quale il software Edge Agent invierà gli aggiornamenti dei segnali al cloud (il software Edge Agent invierà gli aggiornamenti anche se il valore del segnale non è cambiato tra un aggiornamento e l'altro).
+ `onChange`: il software Edge Agent invierà aggiornamenti del segnale ogni volta che il segnale cambia.
```
aws iotfleetwise create-vehicle --cli-input-json file://{{create-vehicle.json}}
```
Dove il `{{create-vehicle.json}}` file contiene (ad esempio):
```
{
"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}}
}
}
}
}
]
}
```
Se hai [ abilitato la crittografia ](key-management.md) utilizzando una AWS KMS chiave gestita dal cliente, includi la seguente dichiarazione politica in modo che il tuo ruolo possa richiamare l'operazione `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}}"
]
}
]
}
```
------