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 FleetWise veicolo AWS IoT
**Importante**
L'accesso a determinate FleetWise funzionalità AWS 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 di veicolo deve essere`ACTIVE`. Per ulteriori informazioni, consulta [Gestisci i modelli di FleetWise veicoli AWS IoTModelli di veicoli](vehicle-models.md).
Il modello del veicolo deve essere associato a un manifesto del decodificatore e lo stato del manifesto del decodificatore deve essere. `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 nel seguente modo.
**Topics**
+ [Fase 1: Definizione delle proprietà del veicolo](#define-vehicle-properties-console)
+ [Fase 2: Configurare il certificato del veicolo](#define-vehicle-certificate-console)
+ [Fase 3: Allega le politiche al certificato](#attach-vehicle-policy-console)
+ [Fase 4: Revisione e creazione](#review-and-create-vehicle-console)
### Fase 1: Definizione delle proprietà del veicolo
In questo passaggio, si assegna un nome al veicolo e lo si associa al manifesto del modello e al manifesto del decodificatore.
1. Inserite 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 aggiornare l'oggetto al veicolo. Oppure, scegli un nome diverso per il veicolo e l' AWS IoT FleetWise creerà automaticamente qualcosa di nuovo 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, scegliete **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 anche aggiungere tag dopo aver creato il veicolo.
1. Scegli **Next (Successivo)**.
### Fase 2: Configurare il certificato del veicolo
Per utilizzare il veicolo come AWS IoT oggetto, è 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 **Genera automaticamente un nuovo certificato (consigliato)**.
1. Scegli **Next (Successivo)**.
### Fase 3: Allega le politiche al certificato
Allega una policy al certificato che hai configurato nel passaggio precedente.
1. Per **Politiche**, inserisci il nome di una politica esistente. Per creare una nuova politica, scegli **Crea politica**.
1. Scegli **Next (Successivo)**.
### Fase 4: Revisione e creazione
Verifica le configurazioni per il 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 di decodifica. È 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.
Sostituisci *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 AWS IoT qualcosa, esegui il seguente comando. Sostituisci *thing-name* con il nome dell'oggetto che desideri 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 venga fornito dopo la creazione del veicolo. Per ulteriori informazioni, consulta [Fornitura di FleetWise veicoli AWS IoT](provision-vehicles.md).
+ Sostituiscilo *vehicle-name* con uno dei seguenti.
+ Il nome del file AWS IoT if `associationBehavior` è configurato su`ValidateIotThingExists`.
+ L'ID del veicolo su cui creare if `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 (\$1) e due punti (:).
+ Sostituisci *model-manifest-ARN* con l'ARN del tuo modello di veicolo (manifesto del modello).
+ Sostituire *decoder-manifest-ARN* con l'ARN del manifesto del decoder associato al modello di veicolo specificato.
+ (Facoltativo) È possibile aggiungere attributi aggiuntivi per distinguere questo veicolo dagli altri veicoli creati dallo 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**
Puoi associare [modelli di stato](state-templates.md) al veicolo per consentire la raccolta di aggiornamenti sullo stato dal veicolo nel cloud utilizzando il `stateTemplates` campo.
In questo esempio, `stateTemplateUpdateStrategy` può essere uno dei seguenti:
+ `periodic`: consente di specificare una velocità fissa alla quale il software Edge Agent invierà gli aggiornamenti del segnale 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 di politica in modo che il tuo ruolo possa richiamare l'operazione dell'`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"
]
}
]
}
```
------