AWS IoT Analytics-Beispiele unter Verwendung von AWS CLI - AWS-SDK-Codebeispiele
Aktionen

Weitere AWS-SDK-Beispiele sind im GitHub-Repository Beispiele für AWS Doc SDKs verfügbar.

AWS IoT Analytics-Beispiele unter Verwendung von AWS CLI

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie AWS Command Line Interface mit AWS IoT Analytics nutzen.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Servicefunktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.

Themen

Aktionen

Die folgenden Codebeispiele zeigen, wie batch-put-message verwendet wird.

AWS CLI

So senden Sie eine Nachricht an einen Kanal

Im folgenden Beispiel für batch-put-message wird eine Nachricht an den angegebenen Kanal gesendet.

aws iotanalytics batch-put-message \
    --cli-binary-format raw-in-base64-out \
    --cli-input-json file://batch-put-message.json

Inhalt von batch-put-message.json:

{
    "channelName": "mychannel",
    "messages": [
        {
            "messageId": "0001",
            "payload": "eyAidGVtcGVyYXR1cmUiOiAyMCB9"
        }
    ]
}

Ausgabe:

{
    "batchPutMessageErrorEntries": []
}

Weitere Informationen finden Sie unter BatchPutMessage in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter BatchPutMessage in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie cancel-pipeline-reprocessing verwendet wird.

AWS CLI

So brechen Sie die erneute Verarbeitung von Daten über eine Pipeline ab

Im folgenden Beispiel für cancel-pipeline-reprocessing wird die erneute Verarbeitung von Daten über die angegebene Pipeline abgebrochen.

aws iotanalytics cancel-pipeline-reprocessing \
    --pipeline-name mypipeline \
    --reprocessing-id "6ad2764f-fb13-4de3-b101-4e74af03b043"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter CancelPipelineReprocessing in der API-Referenz zu AWS IoT Analytics.

Die folgenden Codebeispiele zeigen, wie create-channel verwendet wird.

AWS CLI

So erstellen Sie einen Channel

Im folgenden Beispiel für create-channel wird ein Kanal mit der angegebenen Konfiguration erstellt. Ein Channel erfasst Daten aus einem MQTT-Thema und archiviert die unformatierten, nicht verarbeiteten Nachrichten vor der Veröffentlichung der Daten in einer Pipeline.

aws iotanalytics create-channel \
    --cli-input-json file://create-channel.json

Inhalt von create-channel.json:

{
    "channelName": "mychannel",
    "retentionPeriod": {
        "unlimited": true
    },
    "tags": [
        {
            "key": "Environment",
            "value": "Production"
        }
    ]
}

Ausgabe:

{
    "channelArn": "arn:aws:iotanalytics:us-west-2:123456789012:channel/mychannel",
    "channelName": "mychannel",
    "retentionPeriod": {
        "unlimited": true
    }
}

Weitere Informationen finden Sie unter CreateChannel in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter CreateChannel in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie create-dataset-content verwendet wird.

AWS CLI

So erstellen Sie den Inhalt eines Datensatzes

Im folgenden Beispiel für create-dataset-content wird der Inhalt des angegebenen Datensatzes erstellt, indem eine SQL-Abfrage (queryAction) oder eine containerisierte Anwendung (containerAction) ausgeführt wird.

aws iotanalytics create-dataset-content \
    --dataset-name mydataset

Ausgabe:

{
    "versionId": "d494b416-9850-4670-b885-ca22f1e89d62"
}

Weitere Informationen finden Sie unter CreateDatasetContent in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter CreateDatasetContent in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie create-dataset verwendet wird.

AWS CLI

So erstellen Sie einen Datensatz

Im folgenden Beispiel für create-dataset wird ein Datensatz erstellt. Ein Datensatz speichert Daten aus einem Datenspeicher, indem eine SQL-Abfrage (queryAction) oder eine containerisierte Anwendung (containerAction) ausgeführt wird. Diese Operation erstellt das Skelett eines Datensatzes. Sie können den Datensatz manuell durch Aufrufen von CreateDatasetContent auffüllen, oder automatisch nach einem von Ihnen festgelegten trigger auffüllen lassen.

aws iotanalytics create-dataset \
    --cli-input-json file://create-dataset.json

Inhalt von create-dataset.json:

{
    "datasetName": "mydataset",
    "actions": [
        {
            "actionName": "myDatasetAction",
            "queryAction": {
                "sqlQuery": "SELECT * FROM mydatastore"
            }
        }
    ],
    "retentionPeriod": {
        "unlimited": true
    },
    "tags": [
        {
            "key": "Environment",
            "value": "Production"
        }
    ]
}

Ausgabe:

{
    "datasetName": "mydataset",
    "retentionPeriod": {
        "unlimited": true
    },
    "datasetArn": "arn:aws:iotanalytics:us-west-2:123456789012:dataset/mydataset"
}

Weitere Informationen finden Sie unter CreateDataset in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter CreateDataset in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie create-datastore verwendet wird.

AWS CLI

So erstellen Sie einen Datenspeicher

Im folgenden Beispiel für create-datastore wird ein Datenspeicher erstellt, wobei es sich um ein Repository für Nachrichten handelt.

aws iotanalytics create-datastore \
    --cli-input-json file://create-datastore.json

Inhalt von create-datastore.json:

{
    "datastoreName": "mydatastore",
    "retentionPeriod": {
        "numberOfDays": 90
    },
    "tags": [
        {
            "key": "Environment",
            "value": "Production"
        }
    ]
}

Ausgabe:

{
    "datastoreName": "mydatastore",
    "datastoreArn": "arn:aws:iotanalytics:us-west-2:123456789012:datastore/mydatastore",
    "retentionPeriod": {
        "numberOfDays": 90,
        "unlimited": false
    }
}

Weitere Informationen finden Sie unter CreateDatastore in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter CreateDatastore in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie create-pipeline verwendet wird.

AWS CLI

Erstellen einer IoT-Analytics-Pipeline

Im folgenden Beispiel für create-pipeline wird eine Pipeline erstellt. Eine Pipeline nimmt Nachrichten aus einem Kanal auf und ermöglicht Ihnen, die Nachrichten vor dem Speichern in einem Datenspeicher zu verarbeiten. Sie müssen sowohl eine Kanal- als auch eine Datenspeicher-Aktivität festlegen und können bis zu 23 zusätzliche Aktivitäten im pipelineActivities-Array angeben.

aws iotanalytics create-pipeline \
    --cli-input-json file://create-pipeline.json

Inhalt von create-pipeline.json:

{
    "pipelineName": "mypipeline",
    "pipelineActivities": [
        {
            "channel": {
                "name": "myChannelActivity",
                "channelName": "mychannel",
                "next": "myMathActivity"
            }
        },
        {
            "datastore": {
                "name": "myDatastoreActivity",
                "datastoreName": "mydatastore"
            }
        },
        {
            "math": {
                "name": "myMathActivity",
                "math": "((temp - 32) * 5.0) / 9.0",
                "attribute": "tempC",
                "next": "myDatastoreActivity"
            }
        }
    ],
    "tags": [
        {
            "key": "Environment",
            "value": "Beta"
        }
    ]
}

Ausgabe:

{
    "pipelineArn": "arn:aws:iotanalytics:us-west-2:123456789012:pipeline/mypipeline",
    "pipelineName": "mypipeline"
}

Weitere Informationen finden Sie unter CreatePipeline in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter CreatePipeline in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie delete-channel verwendet wird.

AWS CLI

So löschen Sie einen IoT-Analytics-Kanal

Im folgenden Beispiel für delete-channel wird der angegebene Kanal gelöscht.

aws iotanalytics delete-channel \
    --channel-name mychannel

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter DeleteChannel in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter DeleteChannel in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie delete-dataset-content verwendet wird.

AWS CLI

So löschen Sie den Inhalt eines Datensatzes

Im folgenden Beispiel für delete-dataset-content wird der Inhalt des angegebenen Datasets gelöscht.

aws iotanalytics delete-dataset-content \
    --dataset-name mydataset

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter DeleteDatasetContent in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter DeleteDatasetContent in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie delete-dataset verwendet wird.

AWS CLI

So löschen Sie einen Datensatz

Im folgenden Beispiel für delete-dataset wird der angegebene Datensatz gelöscht. Sie müssen den Inhalt des Datensatzes nicht löschen, bevor Sie diese Operation ausführen.

aws iotanalytics delete-dataset \
    --dataset-name mydataset

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter DeleteDataset in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter DeleteDataset in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie delete-datastore verwendet wird.

AWS CLI

So löschen Sie einen Datenspeicher

Im folgenden Beispiel für delete-datastore wird der angegebene Datenspeicher gelöscht.

aws iotanalytics delete-datastore \
    --datastore-name mydatastore

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter DeleteDatastore in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter DeleteDatastore in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie delete-pipeline verwendet wird.

AWS CLI

So löschen Sie eine Pipeline

Im folgenden Beispiel für delete-pipeline wird die angegebene Pipeline gelöscht.

aws iotanalytics delete-pipeline \
    --pipeline-name mypipeline

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter DeletePipeline in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter DeletePipeline in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie describe-channel verwendet wird.

AWS CLI

So rufen Sie Informationen über einen Kanal ab

Im folgenden Beispiel für describe-channel werden Details, einschließlich Statistiken, für den angegebenen Kanal angezeigt.

aws iotanalytics describe-channel \
    --channel-name mychannel \
    --include-statistics

Ausgabe:

{
    "statistics": {
        "size": {
            "estimatedSizeInBytes": 402.0,
            "estimatedOn": 1561504380.0
        }
    },
    "channel": {
        "status": "ACTIVE",
        "name": "mychannel",
        "lastUpdateTime": 1557860351.001,
        "creationTime": 1557860351.001,
        "retentionPeriod": {
            "unlimited": true
        },
        "arn": "arn:aws:iotanalytics:us-west-2:123456789012:channel/mychannel"
    }
}

Weitere Informationen finden Sie unter DescribeChannel in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter DescribeChannels in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie describe-dataset verwendet wird.

AWS CLI

So rufen Sie Informationen über einen Datensatz ab

Im folgenden Beispiel für describe-dataset werden Details für den festgelegten Datensatz angezeigt.

aws iotanalytics describe-dataset \
    --dataset-name mydataset

Ausgabe:

{
    "dataset": {
        "status": "ACTIVE",
        "contentDeliveryRules": [],
        "name": "mydataset",
        "lastUpdateTime": 1557859240.658,
        "triggers": [],
        "creationTime": 1557859240.658,
        "actions": [
            {
                "actionName": "query_32",
                "queryAction": {
                    "sqlQuery": "SELECT * FROM mydatastore",
                    "filters": []
                }
            }
        ],
        "retentionPeriod": {
            "numberOfDays": 90,
            "unlimited": false
        },
        "arn": "arn:aws:iotanalytics:us-west-2:123456789012:dataset/mydataset"
    }
}

Weitere Informationen finden Sie unter DescribeDataset in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter DescribeDataset in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie describe-datastore verwendet wird.

AWS CLI

So rufen Sie Informationen über einen Datenspeicher ab

Im folgenden Beispiel für describe-datastore werden Details, einschließlich Statistiken, für den angegebenen Datenspeicher angezeigt.

aws iotanalytics describe-datastore \
    --datastore-name mydatastore \
    --include-statistics

Ausgabe:

{
    "datastore": {
        "status": "ACTIVE",
        "name": "mydatastore",
        "lastUpdateTime": 1557858971.02,
        "creationTime": 1557858971.02,
        "retentionPeriod": {
            "unlimited": true
        },
        "arn": "arn:aws:iotanalytics:us-west-2:123456789012:datastore/mydatastore"
    },
    "statistics": {
        "size": {
            "estimatedSizeInBytes": 397.0,
            "estimatedOn": 1561592040.0
        }
    }
}

Weitere Informationen finden Sie unter DescribeDatastore in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter DescribeDatastore in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie describe-logging-options verwendet wird.

AWS CLI

So rufen Sie die aktuellen Protokollierungsoptionen ab

Das folgende Beispiel für describe-logging-options zeigt die aktuellen Protokollierungsoptionen für AWS IoT Analytics.

aws iotanalytics describe-logging-options

Mit diesem Befehl wird keine Ausgabe zurückgegeben. Ausgabe:

{
    "loggingOptions": {
        "roleArn": "arn:aws:iam::123456789012:role/service-role/myIoTAnalyticsRole",
        "enabled": true,
        "level": "ERROR"
    }
}

Weitere Informationen finden Sie unter DescribeLoggingOptions in der API-Referenz zu AWS IoT Analytics.

Die folgenden Codebeispiele zeigen, wie describe-pipeline verwendet wird.

AWS CLI

So rufen Sie Informationen zu einer Pipeline ab

Im folgenden Beispiel für describe-pipeline werden Details für die festgelegte Pipeline angezeigt.

aws iotanalytics describe-pipeline \
    --pipeline-name mypipeline

Ausgabe:

{
    "pipeline": {
        "activities": [
            {
                "channel": {
                    "channelName": "mychannel",
                    "name": "mychannel_28",
                    "next": "mydatastore_29"
                }
            },
            {
                "datastore": {
                    "datastoreName": "mydatastore",
                    "name": "mydatastore_29"
                }
            }
        ],
        "name": "mypipeline",
        "lastUpdateTime": 1561676362.515,
        "creationTime": 1557859124.432,
        "reprocessingSummaries": [
            {
                "status": "SUCCEEDED",
                "creationTime": 1561676362.189,
                "id": "6ad2764f-fb13-4de3-b101-4e74af03b043"
            }
        ],
        "arn": "arn:aws:iotanalytics:us-west-2:123456789012:pipeline/mypipeline"
    }
}

Weitere Informationen finden Sie unter DescribePipeline in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter DescribePipeline in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie get-dataset-content verwendet wird.

AWS CLI

So rufen Sie den Inhalt eines Datensatzes ab

Im folgenden Beispiel für get-dataset-content wird der Inhalt eines Datensatzes als URIs mit Vorzeichen abgerufen.

aws iotanalytics get-dataset-content --dataset-name mydataset

Ausgabe:

{
    "status": {
        "state": "SUCCEEDED"
    },
    "timestamp": 1557863215.995,
    "entries": [
        {
            "dataURI": "https://aws-radiant-dataset-12345678-1234-1234-1234-123456789012.s3.us-west-2.amazonaws.com/results/12345678-e8b3-46ba-b2dd-efe8d86cf385.csv?X-Amz-Security-Token=...-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20190628T173437Z&X-Amz-SignedHeaders=host&X-Amz-Expires=7200&X-Amz-Credential=...F20190628%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Signature=..."
        }
    ]
}

Weitere Informationen finden Sie unter GetDatasetContent im Handbuch.

  • Weitere API-Informationen finden Sie unter GetDatasetContent in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie list-channels verwendet wird.

AWS CLI

So rufen Sie eine Liste der Kanäle ab

Im folgenden Beispiel für list-channels werden zusammenfassende Informationen für die verfügbaren Kanäle angezeigt.

aws iotanalytics list-channels

Ausgabe:

{
    "channelSummaries": [
        {
            "status": "ACTIVE",
            "channelName": "mychannel",
            "creationTime": 1557860351.001,
            "lastUpdateTime": 1557860351.001
        }
    ]
}

Weitere Informationen finden Sie unter ListChannels in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter ListChannels in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie list-dataset-contents verwendet wird.

AWS CLI

So listen Sie Informationen zu Datensatzinhalten auf

Im folgenden Beispiel für list-dataset-contents werden Informationen zu Datensatzinhalten aufgelistet, die erstellt wurden.

aws iotanalytics list-dataset-contents \
    --dataset-name mydataset

Ausgabe:

{
    "datasetContentSummaries": [
        {
            "status": {
                "state": "SUCCEEDED"
            },
            "scheduleTime": 1557863215.995,
            "version": "b10ea2a9-66c1-4d99-8d1f-518113b738d0",
            "creationTime": 1557863215.995
        }
    ]
}

Weitere Informationen finden Sie unter ListDatasetContents in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter ListDatasetContents in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie list-datasets verwendet wird.

AWS CLI

So rufen Sie Informationen über Datensätze ab

Im folgenden Beispiel für list-datasets werden zusammenfassende Informationen zu verfügbaren Datensätzen aufgelistet.

aws iotanalytics list-datasets

Ausgabe:

{
    "datasetSummaries": [
        {
            "status": "ACTIVE",
            "datasetName": "mydataset",
            "lastUpdateTime": 1557859240.658,
            "triggers": [],
            "creationTime": 1557859240.658,
            "actions": [
                {
                    "actionName": "query_32",
                    "actionType": "QUERY"
                }
            ]
        }
    ]
}

Weitere Informationen finden Sie unter ListDatasets in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter ListDatasets in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie list-datastores verwendet wird.

AWS CLI

So rufen Sie eine Liste von Datenspeichern ab

Im folgenden Beispiel für list-datastores werden zusammenfassende Informationen zu verfügbaren Datenspeichern angezeigt.

aws iotanalytics list-datastores

Ausgabe:

{
    "datastoreSummaries": [
        {
            "status": "ACTIVE",
            "datastoreName": "mydatastore",
            "creationTime": 1557858971.02,
            "lastUpdateTime": 1557858971.02
        }
    ]
}

Weitere Informationen finden Sie unter ListDatastores in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter ListDatastores in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie list-pipelines verwendet wird.

AWS CLI

So rufen Sie eine Liste von Pipelines ab

Im folgenden Beispiel für list-pipelines wird eine Liste der verfügbaren Pipelines angezeigt.

aws iotanalytics list-pipelines

Ausgabe:

{
    "pipelineSummaries": [
        {
            "pipelineName": "mypipeline",
            "creationTime": 1557859124.432,
            "lastUpdateTime": 1557859124.432,
            "reprocessingSummaries": []
        }
    ]
}

Weitere Informationen finden Sie unter ListPipelines in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter ListPipelines in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie list-tags-for-resource verwendet wird.

AWS CLI

So listen Sie Tags für eine Ressource auf

Im folgenden Beispiel für list-tags-for-resource werden die Tags aufgeführt, die Sie an die angegebene Ressource angehängt haben.

aws iotanalytics list-tags-for-resource \
    --resource-arn "arn:aws:iotanalytics:us-west-2:123456789012:channel/mychannel"

Ausgabe:

{
    "tags": [
        {
            "value": "bar",
            "key": "foo"
        }
    ]
}

Weitere Informationen finden Sie unter ListTagsForResource in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter ListTagsForResource in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie put-logging-options verwendet wird.

AWS CLI

So legen Sie Protokollierungsoptionen fest oder aktualisieren sie

Im folgenden Beispiel für put-logging-options werden die Protokollierungsoptionen für AWS IoT Analytics festgelegt oder aktualisiert. Wenn Sie den Wert eines loggingOptions-Felds aktualisieren, kann es bis zu einer Minute dauern, bis die Änderung wirksam wird. Außerdem gilt: Wenn Sie die an die Rolle angefügte Richtlinie ändern, die Sie im Feld „roleArn“ angegeben haben (z. B. zur Korrektur einer ungültigen Richtlinie), kann es bis zu fünf Minuten dauern, bis die Änderung wirksam wird.

aws iotanalytics put-logging-options \
    --cli-input-json file://put-logging-options.json

Inhalt von put-logging-options.json:

{
    "loggingOptions": {
        "roleArn": "arn:aws:iam::123456789012:role/service-role/myIoTAnalyticsRole",
        "level": "ERROR",
        "enabled": true
    }
}

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter PutLoggingOptions in der AWS-IoT-API-Referenz.

  • Weitere API-Informationen finden Sie unter PutLoggingOptions in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie run-pipeline-activity verwendet wird.

AWS CLI

So simulieren Sie eine Pipeline-Aktivität

Im folgenden Beispiel für run-pipeline-activity werden die Ergebnisse der Ausführung einer Pipeline-Aktivität für Nachrichtennutzdaten simuliert.

aws iotanalytics run-pipeline-activity \
    --pipeline-activity file://maths.json \
    --payloads file://payloads.json

Inhalt von maths.json:

{
    "math": {
        "name": "MyMathActivity",
        "math": "((temp - 32) * 5.0) / 9.0",
        "attribute": "tempC"
    }
}

Inhalt von payloads.json:

[
    "{\"humidity\": 52, \"temp\": 68 }",
    "{\"humidity\": 52, \"temp\": 32 }"
]

Ausgabe:

{
    "logResult": "",
    "payloads": [
        "eyJodW1pZGl0eSI6NTIsInRlbXAiOjY4LCJ0ZW1wQyI6MjB9",
        "eyJodW1pZGl0eSI6NTIsInRlbXAiOjMyLCJ0ZW1wQyI6MH0="
    ]
}

Weitere Informationen finden Sie unter RunPipelineActivity in der API-Referenz zu AWS IoT Analytics.

Die folgenden Codebeispiele zeigen, wie sample-channel-data verwendet wird.

AWS CLI

So rufen Sie Beispielnachrichten aus einem Kanal ab

Im folgenden Beispiel für sample-channel-data werden Beispielnachrichten aus dem angegebenen Kanal abgerufen, die während des festgelegten Zeitrahmens übernommen wurden. Sie können bis zu 10 Nachrichten abrufen.

aws iotanalytics sample-channel-data \
    --channel-name mychannel

Ausgabe:

{
    "payloads": [
        "eyAidGVtcGVyYXR1cmUiOiAyMCB9",
        "eyAiZm9vIjogImJhciIgfQ=="
    ]
}

Weitere Informationen finden Sie unter SampleChannelData in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter SampleChannelData in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie start-pipeline-reprocessing verwendet wird.

AWS CLI

So starten Sie die erneute Verarbeitung der Pipeline

Im folgenden Beispiel für start-pipeline-reprocessing wird die erneute Verarbeitung von Rohnachrichtendaten über die angegebene Pipeline gestartet.

aws iotanalytics start-pipeline-reprocessing \
    --pipeline-name mypipeline

Ausgabe:

{
    "reprocessingId": "6ad2764f-fb13-4de3-b101-4e74af03b043"
}

Weitere Informationen finden Sie unter StartPipelineReprocessing in der API-Referenz zu AWS IoT Analytics.

Die folgenden Codebeispiele zeigen, wie tag-resource verwendet wird.

AWS CLI

So fügen Sie Tags für eine Ressource hinzu oder ändern sie

Im folgenden Beispiel für tag-resource werden Tags, die an die angegebene Ressource angehängt sind, hinzugefügt oder geändert.

aws iotanalytics tag-resource \
    --resource-arn "arn:aws:iotanalytics:us-west-2:123456789012:channel/mychannel" \
    --tags "[{\"key\": \"Environment\", \"value\": \"Production\"}]"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter TagResource in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter TagResource in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie untag-resource verwendet wird.

AWS CLI

So entfernen Sie Tags von einer Ressource

Im folgenden Beispiel für untag-resource werden die Tags mit den angegebenen Schlüsselnamen aus der angegebenen Ressource entfernt.

aws iotanalytics untag-resource \
    --resource-arn "arn:aws:iotanalytics:us-west-2:123456789012:channel/mychannel" \
    --tag-keys "[\"Environment\"]"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter „UntagResource“ <https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_UntagResource.html> in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter UntagResource in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie update-channel verwendet wird.

AWS CLI

So ändern Sie einen Kanal

Im folgenden Beispiel für update-channel werden die Einstellungen für den angegebenen Kanal geändert.

aws iotanalytics update-channel \
    --cli-input-json file://update-channel.json

Inhalt von update-channel.json:

{
    "channelName": "mychannel",
    "retentionPeriod": {
        "numberOfDays": 92
    }
}

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter UpdateChannel in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter UpdateChannel in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie update-dataset verwendet wird.

AWS CLI

So aktualisieren Sie einen Datensatz

Im folgenden Beispiel für update-dataset werden die Einstellungen des angegebenen Datensatzes geändert.

aws iotanalytics update-dataset \
    --cli-input-json file://update-dataset.json

Inhalt von update-dataset.json:

{
    "datasetName": "mydataset",
    "actions": [
        {
            "actionName": "myDatasetUpdateAction",
            "queryAction": {
                "sqlQuery": "SELECT * FROM mydatastore"
            }
        }
    ],
    "retentionPeriod": {
        "numberOfDays": 92
    }
}

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter „UpdateDataset“ <https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_UpdateDataset.html> in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter UpdateDataset in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie update-datastore verwendet wird.

AWS CLI

So aktualisieren Sie einen Datenspeicher

Im folgenden Beispiel für update-datastore werden die Einstellungen des angegebenen Datenspeichers geändert.

aws iotanalytics update-datastore \
    --cli-input-json file://update-datastore.json

Inhalt von update-datastore.json:

{
    "datastoreName": "mydatastore",
    "retentionPeriod": {
        "numberOfDays": 93
    }
}

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter UpdateDatastore in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter UpdateDatastore in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie update-pipeline verwendet wird.

AWS CLI

So aktualisieren Sie eine Pipeline

Im folgenden Beispiel für update-pipeline werden die Einstellungen der angegebenen Pipeline geändert. Sie müssen sowohl eine Kanal- als auch eine Datenspeicher-Aktivität festlegen und können bis zu 23 zusätzliche Aktivitäten im pipelineActivities-Array angeben.

aws iotanalytics update-pipeline \
    --cli-input-json file://update-pipeline.json

Inhalt von update-pipeline.json:

{
    "pipelineName": "mypipeline",
    "pipelineActivities": [
        {
            "channel": {
                "name": "myChannelActivity",
                "channelName": "mychannel",
                "next": "myMathActivity"
            }
        },
        {
            "datastore": {
                "name": "myDatastoreActivity",
                "datastoreName": "mydatastore"
            }
        },
        {
            "math": {
                "name": "myMathActivity",
                "math": "(((temp - 32) * 5.0) / 9.0) + 273.15",
                "attribute": "tempK",
                "next": "myDatastoreActivity"
            }
        }
    ]
}

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter UpdatePipeline in der API-Referenz zu AWS IoT Analytics.

  • Weitere API-Informationen finden Sie unter UpdatePipeline in der AWS CLI-Befehlsreferenz.