Erstelle eine Kampagne (AWS CLI)

Sie können den CreateCampaignAPI-Vorgang verwenden, um eine Kampagne zu erstellen. Das folgende Beispiel verwendet die AWS CLI.

Wenn Sie eine Kampagne erstellen, können von Fahrzeugen gesammelte Daten entweder in Amazon S3 (S3) oder Amazon Timestream gespeichert werden. Wählen Sie Timestream für eine schnelle, skalierbare und serverlose Zeitreihendatenbank, z. B. zum Speichern von Daten, die nahezu in Echtzeit verarbeitet werden müssen. Wählen Sie S3 als Objektspeicher mit branchenführender Skalierbarkeit, Datenverfügbarkeit, Sicherheit und Leistung.

Wichtig

Sie können Fahrzeugdaten nur übertragen, wenn AWS IoT berechtigt FleetWise ist, Daten in S3 oder Timestream zu schreiben. Weitere Informationen zur Zugriffsgewährung finden Sie unter Zugriffskontrolle mit AWS IoT FleetWise.

Kampagne erstellen

Wichtig

• Sie benötigen einen Signalkatalog und ein Fahrzeug oder eine Flotte, bevor Sie eine Kampagne erstellen können. Weitere Informationen finden Sie unter Signalkataloge erstellen und verwalten, Fahrzeuge erstellen, bereitstellen und verwalten und Flotten erstellen und verwalten.

• Nachdem eine Kampagne erstellt wurde, müssen Sie den UpdateCampaign API-Vorgang verwenden, um die Kampagne zu genehmigen. Weitere Informationen finden Sie unter Aktualisieren Sie eine Kampagne (AWS CLI)

Führen Sie den folgenden Befehl aus, um eine Kampagne zu erstellen.

Ersetzen Sie file-name durch den Namen der JSON-Datei, die die Kampagnenkonfiguration enthält.

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

Beispielkonfigurationsdatei für S3

• Ersetzen Sie kampagnenname durch den Namen der Kampagne, die Sie erstellen.

• signal-catalog-arnErsetzen Sie durch den Amazon-Ressourcennamen (ARN) des Signalkatalogs.

• Ersetzen Sie target-arn durch den ARN einer Flotte oder eines Fahrzeugs, das Sie erstellt haben.

• Ersetzen Sie bucket-arn durch den ARN des S3-Buckets.

{
    "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"
      }
    }
  ]
}

Beispielkonfigurationsdatei für Timestream

• Ersetzen Sie kampagnenname durch den Namen der Kampagne, die Sie erstellen.

• signal-catalog-arnErsetzen Sie durch den Amazon-Ressourcennamen (ARN) des Signalkatalogs.

• Ersetzen Sie target-arn durch den ARN einer Flotte oder eines Fahrzeugs, das Sie erstellt haben.

• Ersetzen Sie role-arn durch den ARN der Aufgabenausführungsrolle, die AWS FleetWise IoT-Berechtigungen zur Übermittlung von Daten an die Timestream-Tabelle erteilt.

• Ersetzen Sie table-arn durch den ARN der Timestream-Tabelle.

{
  "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"
      }
    }
  ]
}