Crea una campagna () AWS CLI

Puoi utilizzare l'operazione CreateCampaignAPI per creare una campagna. Gli esempi seguenti utilizzano AWS CLI.

Quando crei una campagna, i dati raccolti dai veicoli possono essere archiviati in Amazon S3 (S3) o Amazon Timestream. Scegli Timestream per un database di serie temporali veloce, scalabile e senza server, ad esempio per archiviare dati che richiedono un'elaborazione quasi in tempo reale. Scegli S3 per uno storage di oggetti con scalabilità, disponibilità dei dati, sicurezza e prestazioni leader del settore.

Importante

Puoi trasferire i dati del veicolo solo se l'AWSIoT FleetWise dispone delle autorizzazioni per scrivere dati in S3 o Timestream. Per ulteriori informazioni sulla concessione dell'accesso, consulta Controllare l'accesso con AWS IoT FleetWise.

Crea una campagna

Importante

• È necessario disporre di un catalogo di segnali e di un veicolo o di una flotta prima di creare una campagna. Per ulteriori informazioni, consulta Crea e gestisci cataloghi di segnali, Crea, fornisci e gestisci veicoli e Crea e gestisci flotte.

• Dopo aver creato una campagna, devi utilizzare l'operazione UpdateCampaign API per approvarla. Per ulteriori informazioni, consultare Aggiorna una campagna (AWS CLI)

Per creare una campagna, esegui il comando seguente.

Sostituisci file-name con il nome del file JSON che contiene la configurazione della campagna.

aws iotfleetwise create-campaign --cli-input-json file://file-name.json

File di configurazione di esempio per S3

• Sostituisci il nome della campagna con il nome della campagna che stai creando.

• Sostituisci signal-catalog-arncon l'Amazon Resource Name (ARN) del catalogo dei segnali.

• Sostituisci target-arn con l'ARN di una flotta o di un veicolo che hai creato.

• Sostituisci bucket-arn con l'ARN del bucket S3.

{
    "name": "campaign-name",
    "targetArn": "target-arn", 
    "signalCatalogArn": "signal-catalog-arn", 
    "collectionScheme": {
        "conditionBasedCollectionScheme": {
            "conditionLanguageVersion": 1,
            "expression": "$variable.`Vehicle.DemoBrakePedalPressure` > 7000",
            "minimumTriggerIntervalMs": 1000,
            "triggerMode": "ALWAYS"
        }
    },
    "compression": "SNAPPY",
    "diagnosticsMode": "OFF",
    "postTriggerCollectionDuration": 1000,
    "priority": 0,
    "signalsToCollect": [
        {
         "maxSampleCount": 100,
         "minimumSamplingIntervalMs": 0,
         "name": "Vehicle.DemoEngineTorque"
        },
        {
         "maxSampleCount": 100,
         "minimumSamplingIntervalMs": 0,
         "name": "Vehicle.DemoBrakePedalPressure"
        }
    ],
    "spoolingMode": "TO_DISK",
    "dataDestinationConfigs": [
        {
         "s3Config": { 
             "bucketArn": "bucket-arn",
             "dataFormat": "PARQUET",
             "prefix": "campaign-name",
              "storageCompressionFormat": "GZIP"
      }
    }
  ]
}

File di configurazione di esempio per Timestream

• Sostituisci il nome della campagna con il nome della campagna che stai creando.

• Sostituisci signal-catalog-arncon l'Amazon Resource Name (ARN) del catalogo dei segnali.

• Sostituisci target-arn con l'ARN di una flotta o di un veicolo che hai creato.

• Sostituisci role-arn con l'ARN del ruolo di esecuzione dell'attività che concede l' FleetWise autorizzazione AWS IoT a fornire dati alla tabella Timestream.

• Sostituisci table-arn con l'ARN della tabella Timestream.

{
  "name": "campaign-name",
  "targetArn": "target-arn",
  "signalCatalogArn": "signal-catalog-arn",
  "collectionScheme": {
    "conditionBasedCollectionScheme": {
      "conditionLanguageVersion": 1,
      "expression": "$variable.`Vehicle.DemoBrakePedalPressure` > 7000",
      "minimumTriggerIntervalMs": 1000,
      "triggerMode": "ALWAYS"
    }
  },
  "compression": "SNAPPY",
  "diagnosticsMode": "OFF",
  "postTriggerCollectionDuration": 1000,
  "priority": 0,
  "signalsToCollect": [
    {
      "maxSampleCount": 100,
      "minimumSamplingIntervalMs": 0,
      "name": "Vehicle.DemoEngineTorque"
    },
    {
      "maxSampleCount": 100,
      "minimumSamplingIntervalMs": 0,
      "name": "Vehicle.DemoBrakePedalPressure"
    }
  ],
  "spoolingMode": "TO_DISK",
  "dataDestinationConfigs": [
    {
      "timestreamConfig": {
        "executionRoleArn": "role-arn",
        "timestreamTableArn": "table-arn"
      }
    }
  ]
}