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à. # Gestisci i FleetWise veicoli AWS IoT I veicoli sono esempi di modelli di veicoli. I veicoli devono essere creati a partire da un modello di veicolo e associati a un manifesto di decodifica. I veicoli caricano uno o più flussi di dati sul cloud. Ad esempio, un veicolo può inviare al cloud i dati su chilometraggio, temperatura del motore e stato del riscaldatore. Ogni veicolo contiene le seguenti informazioni: `vehicleName` Un ID che identifica il veicolo. Non aggiungere informazioni di identificazione personale (PII) o altre informazioni riservate o sensibili nel nome del veicolo. I nomi dei veicoli sono accessibili tramite altri AWS servizi, tra cui Amazon CloudWatch. I nomi dei veicoli non sono pensati per essere utilizzati per dati privati o sensibili. `modelManifestARN` L'Amazon Resource Name (ARN) di un modello di veicolo (manifesto del modello). Ogni veicolo viene creato a partire da un modello di veicolo. I veicoli creati a partire dallo stesso modello di veicolo sono costituiti dallo stesso gruppo di segnali ereditati dal modello di veicolo. Questi segnali sono definiti e standardizzati nel catalogo dei segnali. `decoderManifestArn` L'ARN del manifesto del decoder. Un manifesto di decodifica fornisce informazioni di decodifica che l' AWS IoT FleetWise può utilizzare per trasformare i dati grezzi del segnale (dati binari) in valori leggibili dall'uomo. Un manifesto del decodificatore deve essere associato a un modello di veicolo. AWS L'IoT FleetWise utilizza lo stesso manifesto di decodifica per decodificare i dati grezzi dei veicoli creati sulla base dello stesso modello di veicolo. `attributes` Gli attributi sono coppie chiave-valore che contengono informazioni statiche. I veicoli possono contenere attributi ereditati dal modello di veicolo. Puoi aggiungere attributi aggiuntivi per distinguere un singolo veicolo dagli altri veicoli creati dallo stesso modello di veicolo. Per esempio, se hai un'auto nera, puoi specificare il seguente valore per un attributo:`{"color": "black"}`. Gli attributi devono essere definiti nel modello di veicolo associato prima di poterli aggiungere ai singoli veicoli. Per ulteriori informazioni sui modelli di veicoli, i manifesti dei decoder e gli attributi, vedere. [Modelli di FleetWise veicoli AWS IoT](vehicle-modeling.md) AWS L'IoT FleetWise fornisce le seguenti operazioni API che puoi utilizzare per creare e gestire veicoli. + [CreateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateVehicle.html)— Crea un nuovo veicolo. + [BatchCreateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_BatchCreateVehicle.html)— Crea uno o più veicoli nuovi. + [UpdateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateVehicle.html)— Aggiorna un veicolo esistente. + [BatchUpdateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_BatchUpdateVehicle.html)— Aggiorna uno o più veicoli esistenti. + [DeleteVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteVehicle.html)— Elimina un veicolo esistente. + [ListVehicles](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListVehicles.html)— Recupera un elenco impaginato di riepiloghi di tutti i veicoli. + [GetVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetVehicle.html)— Recupera informazioni su un veicolo. **Topics** + [Fornitura di FleetWise veicoli AWS IoT](provision-vehicles.md) + [Argomenti riservati in AWS IoT FleetWise](reserved-topics.md) + [Crea un FleetWise veicolo AWS IoT](create-vehicle.md) + [Crea più FleetWise veicoli AWS IoT](create-vehicles-cli.md) + [Aggiorna un FleetWise veicolo AWS IoT](update-vehicle-cli.md) + [Aggiorna più FleetWise veicoli AWS IoT](update-vehicles-cli.md) + [Eliminare un FleetWise veicolo AWS IoT](delete-vehicle.md) + [Ottieni informazioni sui FleetWise veicoli AWS IoT](get-vehicle-information-cli.md) # Fornitura di FleetWise veicoli AWS IoT Il FleetWise software Edge Agent for AWS IoT in esecuzione nel veicolo raccoglie e trasferisce i dati nel cloud. AWS L'IoT FleetWise si integra AWS IoT Core per supportare una comunicazione sicura tra il software Edge Agent e il cloud tramite MQTT. Ogni veicolo corrisponde a qualcosa. AWS IoT Puoi usare un AWS IoT oggetto esistente per creare un veicolo o impostare l' AWS IoT FleetWise per creare automaticamente un AWS IoT oggetto per il tuo veicolo. Per ulteriori informazioni, consulta [Crea un FleetWise veicolo AWS IoT](create-vehicle.md). AWS IoT Core supporta [l'autenticazione e l'](https://docs.aws.amazon.com/iot/latest/developerguide/authentication.html)[autorizzazione](https://docs.aws.amazon.com/iot/latest/developerguide/iot-authorization.html) che aiutano a controllare in modo sicuro l'accesso alle FleetWise risorse AWS IoT. I veicoli possono utilizzare i certificati X.509 per autenticarsi (accedere) per utilizzare l' AWS IoT FleetWise e AWS IoT Core le policy per ottenere l'autorizzazione (disporre delle autorizzazioni) per eseguire azioni specifiche. ## Autentica i veicoli Puoi creare AWS IoT Core politiche per autenticare i tuoi veicoli. **Per autenticare il tuo veicolo** + Per creare una AWS IoT Core politica, esegui il comando seguente. + Sostituisci *policy-name* con il nome della politica che desideri creare. + Sostituisci *file-name* con il nome del file JSON che contiene la AWS IoT Core policy. ``` aws iot create-policy --policy-name policy-name --policy-document file://file-name.json ``` ### Politica di esempio AWS IoT Core Prima di utilizzare la politica di esempio, procedi come segue: + Sostituisci *us-east-1* con la AWS regione in cui hai creato FleetWise le risorse AWS IoT. + *111122223333*Sostituiscilo con l'ID AWS del tuo account. Questo esempio include argomenti riservati all' AWS IoT FleetWise. È necessario aggiungere gli argomenti alla politica. Per ulteriori informazioni, consulta [Argomenti riservati in 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" ] } ] } ``` ------ ## Autorizza i veicoli Puoi creare certificati X.509 per autorizzare i tuoi veicoli. **Per autorizzare il tuo veicolo** **Importante** Ti consigliamo di creare un nuovo certificato per ogni veicolo. 1. Per creare una coppia di key pair RSA ed emettere un certificato X.509, esegui il comando seguente. + Sostituisci *cert* con il nome del file che salva il contenuto dell'output del comando di CertificatePEM. + Sostituisci *public-key* con il nome del file che salva il contenuto dell'output del comando di KeyPair. PublicKey. + Sostituisci *private-key* con il nome del file che salva il contenuto dell'output del comando di 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. Copia l'Amazon Resource Name (ARN) del certificato dall'output. 1. Per allegare la policy al certificato, esegui il comando seguente. + Sostituisci *policy-name* con il nome della AWS IoT Core politica che hai creato. + Sostituisci *certificate-arn* con l'ARN del certificato che hai copiato. ``` aws iot attach-policy \ --policy-name policy-name\ --target "certificate-arn" ``` 1. Per allegare il certificato all'oggetto, esegui il comando seguente. + Sostituiscilo *thing-name* con il nome dell' AWS IoT oggetto o l'ID del veicolo. + Sostituisci *certificate-arn* con l'ARN del certificato che hai copiato. ``` aws iot attach-thing-principal \ --thing-name thing-name \ --principal "certificate-arn" ``` # Argomenti riservati in AWS IoT FleetWise **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). AWS L'IoT FleetWise si riserva l'uso dei seguenti argomenti. Se l'argomento riservato lo consente, puoi abbonarti o pubblicarlo. Tuttavia, non puoi creare nuovi argomenti che iniziano con il simbolo del dollaro (\$1). Se utilizzi operazioni di pubblicazione o sottoscrizione non supportate con argomenti riservati, la connessione può terminare. | Topic | Operazione del client consentita | Description | | --- | --- | --- | | `$aws/iotfleetwise/vehicles/vehicleName/checkins` | Pubblica | Il software Edge Agent pubblica informazioni sullo stato del veicolo su questo argomento. Le informazioni sullo stato del veicolo vengono scambiate in formato buffer di protocollo (Protobuf). Per ulteriori informazioni, consulta la [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` | Pubblica | Il software Edge Agent pubblica segnali relativi a questo argomento. Le informazioni sui segnali vengono scambiate in formato buffer di protocollo (Protobuf). Per ulteriori informazioni, consulta la [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` | Subscribe | AWS L'IoT FleetWise pubblica schemi di raccolta dati su questo argomento. I veicoli utilizzano questi schemi di raccolta dati. | | `$aws/iotfleetwise/vehicles/vehicleName/decoder_manifests` | Subscribe | AWS L'IoT FleetWise pubblica i manifesti dei decoder relativi a questo argomento. I veicoli utilizzano questi manifesti di decodifica. | | `$aws/iotfleetwise/vehicles/vehicleName/command/request` | Subscribe | AWS L'IoT FleetWise pubblica le richieste di esecuzione di comandi su questo argomento. I veicoli utilizzano quindi queste richieste di comando. | | `$aws/iotfleetwise/vehicles/vehicleName/command/response` | Pubblica | Il software Edge Agent pubblica le risposte ai comandi del veicolo a questo argomento. Le risposte ai comandi vengono scambiate in formato buffer di protocollo (Protobuf). Per ulteriori informazioni, consulta la [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` | Subscribe | AWS IoT FleetWise pubblica aggiornamenti sullo stato dei comandi su questo argomento. Le notifiche vengono inviate in formato JSON. | | `$aws/iotfleetwise/vehicles/$vehicle_name/last_known_states/config` | Subscribe | AWS IoT FleetWise pubblica le configurazioni dei modelli di stato su questo argomento. I veicoli utilizzano queste configurazioni di modelli di stato. | | `$aws/iotfleetwise/vehicles/$vehicle_name/last_known_states/data` | Pubblica | Il software Edge Agent pubblica i dati raccolti dai segnali su questo argomento. | | `$aws/iotfleetwise/vehicles/$vehicle_name/last_known_state/$state_template_name/data` | Subscribe | AWS L'IoT FleetWise pubblica i dati raccolti dai segnali configurati nel modo specificato `$state_template_name` in questo argomento. Gli aggiornamenti possono essere parziali. Ad esempio, se un'associazione di modelli di stato contiene più segnali con la strategia di aggiornamento in caso di modifica, in un determinato messaggio sono contenuti solo i segnali che sono stati modificati. Le informazioni sui segnali vengono scambiate in formato buffer di protocollo (Protobuf). Per ulteriori informazioni, consulta la [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). | # 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" ] } ] } ``` ------ # Crea più FleetWise veicoli AWS IoT Puoi utilizzare l'operazione [BatchCreateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_BatchCreateVehicle.html)API per creare più veicoli contemporaneamente. Gli esempi seguenti utilizzano AWS CLI. Per creare più veicoli, esegui il comando seguente. Sostituisci *file-name* con il nome del file.json che contiene le configurazioni di più veicoli. ``` aws iotfleetwise batch-create-vehicle --cli-input-json file://file-name.json ``` **Example — configurazioni dei veicoli** ``` { "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" } } ] } ``` È possibile creare fino a 10 veicoli per ogni operazione in batch. Per ulteriori informazioni sulla configurazione del veicolo, consulta[Crea un FleetWise veicolo AWS IoT](create-vehicle.md). 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'`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" ] } ] } ``` ------ # Aggiorna 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 l'operazione [UpdateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateVehicle.html)API per aggiornare un veicolo esistente. Gli esempi seguenti utilizzano AWS CLI. Per aggiornare un veicolo, esegui il comando seguente. Sostituiscilo *file-name* con il nome del file.json che contiene la configurazione del veicolo. ``` aws iotfleetwise update-vehicle --cli-input-json file://file-name.json ``` **Example — configurazione del veicolo** + Sostituisci *vehicle-name* con l'ID del veicolo che desideri aggiornare. + (Facoltativo) Sostituiscilo *model-manifest-ARN* con l'ARN del modello di veicolo (manifesto del modello) che utilizzi per sostituire il modello di veicolo in uso. + (Facoltativo) Sostituiscilo *decoder-manifest-ARN* con l'ARN del manifesto del decoder associato al nuovo modello di veicolo specificato. + (Facoltativo) Sostituiscilo *attribute-update-mode* con gli attributi del veicolo. + `Merge`— Unisce nuovi attributi in attributi esistenti aggiornando gli attributi esistenti con nuovi valori e aggiungendo nuovi attributi se non esistono. Per esempio, se un veicolo ha i seguenti attributi:`{"color": "black", "fuelType": "electric"}`, e aggiorni il veicolo con i seguenti attributi:`{"color": "", "fuelType": "gasoline", "model": "x"}`, il veicolo aggiornato ha i seguenti attributi:`{"fuelType": "gasoline", "model": "x"}`. + `Overwrite`— Sostituire gli attributi esistenti con nuovi attributi. Ad esempio, se un veicolo ha i seguenti attributi: e `{"color": "black", "fuelType": "electric"}` si aggiorna il veicolo con l'`{"model": "x"}`attributo, il veicolo aggiornato dispone dell'`{"model": "x"}`attributo. Questo è necessario se nell'input sono presenti degli attributi. + (Facoltativo) Per aggiungere nuovi attributi o aggiornare quelli esistenti con nuovi valori, configura`attributes`. Ad esempio, se hai un'auto elettrica, puoi specificare il seguente valore per un attributo:`{"fuelType": "electric"}`. Per eliminare gli attributi, configura `attributeUpdateMode` su`Merge`. **Importante** Gli attributi devono essere definiti nel modello di veicolo associato prima di poterli aggiungere ai singoli veicoli. ``` { "vehicleName": "vehicle-name", "modelManifestArn": "model-manifest-arn", "decoderManifestArn": "decoder-manifest-arn", "attributeUpdateMode": "attribute-update-mode" } } ``` **Example — aggiungere o rimuovere modelli di stato associati al veicolo** Puoi associare modelli di stato aggiuntivi o rimuovere le associazioni esistenti dal veicolo utilizzando i seguenti campi: + `stateTemplatesToAdd` + `stateTemplatesToRemove` ``` aws iotfleetwise update-vehicle --cli-input-json file://update-vehicle.json ``` Dove il `update-vehicle.json` file contiene (ad esempio): ``` { "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"] } ``` 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'`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" ] } ] } ``` ------ # Aggiorna più FleetWise veicoli AWS IoT Puoi utilizzare l'operazione [BatchUpdateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_BatchUpdateVehicle.html)API per aggiornare più veicoli esistenti contemporaneamente. Gli esempi seguenti utilizzano AWS CLI. Per aggiornare più veicoli, esegui il comando seguente. Sostituisci *file-name* con il nome del file.json che contiene le configurazioni di più veicoli. ``` aws iotfleetwise batch-update-vehicle --cli-input-json file://file-name.json ``` **Example — configurazioni dei veicoli** ``` { "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" } } ] } ``` Puoi aggiornare fino a 10 veicoli per ogni operazione in batch. Per ulteriori informazioni sulla configurazione di ciascun veicolo, consulta[Aggiorna un FleetWise veicolo AWS IoT](update-vehicle-cli.md). 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'`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" ] } ] } ``` ------ # Eliminare un FleetWise veicolo AWS IoT Puoi utilizzare la FleetWise console o l'API AWS IoT per eliminare i veicoli. **Importante** Dopo l'eliminazione di un veicolo, l' AWS IoT FleetWise lo rimuove automaticamente dalle flotte e dalle campagne associate. Per ulteriori informazioni, consultare [Gestisci le flotte in AWS IoT FleetWise](fleets.md) e [Raccogli FleetWise dati AWS IoT con le campagne](campaigns.md). Tuttavia, il veicolo esiste ancora come oggetto o è ancora associato a qualcosa dentro AWS IoT Core. Per istruzioni sull'eliminazione di un elemento, consulta [Eliminare un oggetto](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html#delete-thing) nella *Guida per gli AWS IoT Core sviluppatori*. ## Eliminare un veicolo (console) Puoi utilizzare la FleetWise console AWS IoT per eliminare un veicolo. **Per eliminare 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 **Veicoli**, seleziona il pulsante accanto al veicolo che desideri eliminare. 1. Scegli **Elimina**. 1. In **Elimina **vehicle-name****, inserisci il nome del veicolo, quindi scegli **Elimina**. ## Elimina un veicolo (AWS CLI) Puoi utilizzare l'operazione [DeleteVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteVehicle.html)API per eliminare un veicolo. L'esempio seguente utilizza AWS CLI. Per eliminare un veicolo, esegui il comando seguente. Sostituiscilo *vehicle-name* con l'ID del veicolo che desideri eliminare. ``` aws iotfleetwise delete-vehicle --vehicle-name vehicle-name ``` ### Verifica l'eliminazione del veicolo Puoi utilizzare l'operazione [ListVehicles](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListVehicles.html)API per verificare se un veicolo è stato eliminato. Gli esempi seguenti utilizzano AWS CLI. Per recuperare un elenco impaginato di riepiloghi di tutti i veicoli, esegui il comando seguente. ``` aws iotfleetwise list-vehicles ``` 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'API. `ListVehicles` ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "kms:Decrypt" ], "Resource": [ "arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID" ] } ] } ``` ------ # Ottieni informazioni sui FleetWise veicoli 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). È possibile utilizzare il funzionamento dell'[GetVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetVehicle.html)API per recuperare le informazioni sul veicolo. Gli esempi seguenti utilizzano AWS CLI. Per recuperare i metadati di un veicolo, esegui il comando seguente. Sostituiscilo *vehicle-name* con l'ID del veicolo che desideri recuperare. ``` aws iotfleetwise get-vehicle --vehicle-name vehicle-name ``` **Nota** Questa operazione è [consistente finale](https://web.stanford.edu/class/cs345d-01/rl/eventually-consistent.pdf). In altre parole, le modifiche al veicolo potrebbero non riflettersi immediatamente. È possibile utilizzare l'operazione [GetVehicleStatus](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetVehicleStatus.html)API per recuperare lo stato delle risorse associate a un veicolo. Gli esempi seguenti utilizzano AWS CLI. Per recuperare lo stato delle risorse associate a un veicolo, esegui il comando seguente. + Sostituiscilo *vehicle-name* con l'ID del veicolo a cui sono associate le risorse. + Sostituisci *type* con il tipo di risorsa di cui desideri recuperare lo stato. I valori validi di `type` sono `CAMPAIGN`, `STATE_TEMPLATE` ed `DECODER`. ``` aws iotfleetwise get-vehicle-status --vehicle-name vehicle-name --type type ``` 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 le operazioni `GetVehicle` o l'`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" ] } ] } ``` ------