AWS IoT Analytics-Beispiele unter Verwendung der AWS CLI
Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie die 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 Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.
Themen
Aktionen
Das folgende Codebeispiel zeigt, wie batch-put-message verwendet wird.
- AWS CLI
-
So senden Sie eine Nachricht an einen Kanal
Im folgenden
batch-put-message-Beispiel wird eine Nachricht an den angegebenen Kanal gesendet.aws iotanalytics batch-put-message \ --cli-binary-formatraw-in-base64-out\ --cli-input-jsonfile://batch-put-message.jsonInhalt 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.
-
API-Details finden Sie unter BatchPutMessage
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie cancel-pipeline-reprocessing verwendet wird.
- AWS CLI
-
So brechen Sie die erneute Verarbeitung von Daten über eine Pipeline ab
Im folgenden
cancel-pipeline-reprocessing-Beispiel wird die erneute Verarbeitung von Daten über die angegebene Pipeline abgebrochen.aws iotanalytics cancel-pipeline-reprocessing \ --pipeline-namemypipeline\ --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.
-
API-Details finden Sie unter CancelPipelineReprocessing
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie create-channel verwendet wird.
- AWS CLI
-
So erstellen Sie einen Channel
Im folgenden
create-channel-Beispiel 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-jsonfile://create-channel.jsonInhalt 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.
-
API-Details finden Sie unter CreateChannel
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie create-dataset-content verwendet wird.
- AWS CLI
-
So erstellen Sie den Inhalt eines Datensatzes
Im folgenden
create-dataset-content-Beispiel 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-namemydatasetAusgabe:
{ "versionId": "d494b416-9850-4670-b885-ca22f1e89d62" }Weitere Informationen finden Sie unter CreateDatasetContent in der API-Referenz zu AWS IoT Analytics.
-
API-Details finden Sie unter CreateDatasetContent
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie create-dataset verwendet wird.
- AWS CLI
-
So erstellen Sie einen Datensatz
Im folgenden
create-dataset-Beispiel 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 vonCreateDatasetContentauffüllen, oder automatisch nach einem von Ihnen festgelegtentriggerauffüllen lassen.aws iotanalytics create-dataset \ --cli-input-jsonfile://create-dataset.jsonInhalt 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.
-
API-Details finden Sie unter CreateDataset
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie create-datastore verwendet wird.
- AWS CLI
-
So erstellen Sie einen Datenspeicher
Im folgenden
create-datastore-Beispiel wird ein Datenspeicher erstellt, wobei es sich um ein Repository für Nachrichten handelt.aws iotanalytics create-datastore \ --cli-input-jsonfile://create-datastore.jsonInhalt 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.
-
API-Details finden Sie unter CreateDatastore
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie create-pipeline verwendet wird.
- AWS CLI
-
Erstellen einer IoT-Analytics-Pipeline
Im folgenden
create-pipeline-Beispiel 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 impipelineActivities-Array angeben.aws iotanalytics create-pipeline \ --cli-input-jsonfile://create-pipeline.jsonInhalt 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.
-
API-Details finden Sie in der AWS CLI-Befehlsreferenz unter CreatePipeline
.
-
Das folgende Codebeispiel zeigt, wie delete-channel verwendet wird.
- AWS CLI
-
So löschen Sie einen IoT-Analytics-Kanal
Das folgende
delete-channel-Beispiel löscht den angegebenen Kanal.aws iotanalytics delete-channel \ --channel-namemychannelMit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter DeleteChannel in der API-Referenz zu AWS IoT Analytics.
-
API-Details finden Sie unter DeleteChannel
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie delete-dataset-content verwendet wird.
- AWS CLI
-
So löschen Sie den Inhalt eines Datensatzes
Im folgenden
delete-dataset-content-Beispiel wird der Inhalt des angegebenen Datasets gelöscht.aws iotanalytics delete-dataset-content \ --dataset-namemydatasetMit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter DeleteDatasetContent in der API-Referenz zu AWS IoT Analytics.
-
API-Details finden Sie unter DeleteDatasetContent
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie delete-dataset verwendet wird.
- AWS CLI
-
So löschen Sie einen Datensatz
Im folgenden
delete-dataset-Beispiel 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-namemydatasetMit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter DeleteDataset in der API-Referenz zu AWS IoT Analytics.
-
API-Details finden Sie unter DeleteDataset
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie delete-datastore verwendet wird.
- AWS CLI
-
So löschen Sie einen Datenspeicher
Im folgenden
delete-datastore-Beispiel wird der angegebene Datenspeicher gelöscht.aws iotanalytics delete-datastore \ --datastore-namemydatastoreMit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter DeleteDatastore in der API-Referenz zu AWS IoT Analytics.
-
API-Details finden Sie unter DeleteDatastore
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie delete-pipeline verwendet wird.
- AWS CLI
-
So löschen Sie eine Pipeline
Im folgenden
delete-pipeline-Beispiel wird die angegebene Pipeline gelöscht.aws iotanalytics delete-pipeline \ --pipeline-namemypipelineMit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter DeletePipeline in der API-Referenz zu AWS IoT Analytics.
-
API-Details finden Sie unter DeletePipeline
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie describe-channel verwendet wird.
- AWS CLI
-
So rufen Sie Informationen über einen Kanal ab
Im folgenden
describe-channel-Beispiel werden Details, einschließlich Statistiken, für den angegebenen Kanal angezeigt.aws iotanalytics describe-channel \ --channel-namemychannel\ --include-statisticsAusgabe:
{ "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.
-
API-Details finden Sie unter DescribeChannel
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie describe-dataset verwendet wird.
- AWS CLI
-
So rufen Sie Informationen über einen Datensatz ab
Im folgenden
describe-dataset-Beispiel werden Details für den festgelegten Datensatz angezeigt.aws iotanalytics describe-dataset \ --dataset-namemydatasetAusgabe:
{ "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.
-
API-Details finden Sie unter DescribeDataset
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie describe-datastore verwendet wird.
- AWS CLI
-
So rufen Sie Informationen über einen Datenspeicher ab
Im folgenden
describe-datastore-Beispiel werden Details, einschließlich Statistiken, für den angegebenen Datenspeicher angezeigt.aws iotanalytics describe-datastore \ --datastore-namemydatastore\ --include-statisticsAusgabe:
{ "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.
-
API-Details finden Sie unter DescribeDatastore
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie describe-logging-options verwendet wird.
- AWS CLI
-
So rufen Sie die aktuellen Protokollierungsoptionen ab
Das folgende
describe-logging-options-Beispiel zeigt die aktuellen Protokollierungsoptionen für AWS IoT Analytics.aws iotanalytics describe-logging-optionsMit 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.
-
API-Details finden Sie unter DescribeLoggingOptions
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie describe-pipeline verwendet wird.
- AWS CLI
-
So rufen Sie Informationen zu einer Pipeline ab
Im folgenden
describe-pipeline-Beispiel werden Details für die festgelegte Pipeline angezeigt.aws iotanalytics describe-pipeline \ --pipeline-namemypipelineAusgabe:
{ "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.
-
API-Details finden Sie unter DescribePipeline
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie get-dataset-content verwendet wird.
- AWS CLI
-
So rufen Sie den Inhalt eines Datensatzes ab
Im folgenden
get-dataset-content-Beispiel wird der Inhalt eines Datensatzes als URIs mit Vorzeichen abgerufen.aws iotanalytics get-dataset-content --dataset-namemydatasetAusgabe:
{ "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.
-
API-Details finden Sie unter GetDatasetContent
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie list-channels verwendet wird.
- AWS CLI
-
So rufen Sie eine Liste der Kanäle ab
Im folgenden
list-channels-Beispiel werden zusammenfassende Informationen für die verfügbaren Kanäle angezeigt.aws iotanalytics list-channelsAusgabe:
{ "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.
-
API-Details finden Sie unter ListChannels
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie list-dataset-contents verwendet wird.
- AWS CLI
-
So listen Sie Informationen zu Datensatzinhalten auf
Im folgenden
list-dataset-contents-Beispiel werden Informationen zu Datensatzinhalten aufgelistet, die erstellt wurden.aws iotanalytics list-dataset-contents \ --dataset-namemydatasetAusgabe:
{ "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.
-
API-Details finden Sie unter ListDatasetContents
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie list-datasets verwendet wird.
- AWS CLI
-
So rufen Sie Informationen über Datensätze ab
Im folgenden
list-datasets-Beispiel werden zusammenfassende Informationen zu verfügbaren Datensätzen aufgelistet.aws iotanalytics list-datasetsAusgabe:
{ "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.
-
API-Details finden Sie unter ListDatasets
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie list-datastores verwendet wird.
- AWS CLI
-
So rufen Sie eine Liste von Datenspeichern ab
Im folgenden
list-datastores-Beispiel werden zusammenfassende Informationen zu verfügbaren Datenspeichern angezeigt.aws iotanalytics list-datastoresAusgabe:
{ "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.
-
API-Details finden Sie unter ListDatastores
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie list-pipelines verwendet wird.
- AWS CLI
-
So rufen Sie eine Liste von Pipelines ab
Im folgenden
list-pipelines-Beispiel wird eine Liste der verfügbaren Pipelines angezeigt.aws iotanalytics list-pipelinesAusgabe:
{ "pipelineSummaries": [ { "pipelineName": "mypipeline", "creationTime": 1557859124.432, "lastUpdateTime": 1557859124.432, "reprocessingSummaries": [] } ] }Weitere Informationen finden Sie unter ListPipelines in der API-Referenz zu AWS IoT Analytics.
-
API-Details finden Sie unter ListPipelines
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie list-tags-for-resource verwendet wird.
- AWS CLI
-
So listen Sie Tags für eine Ressource auf
Im folgenden
list-tags-for-resource-Beispiel 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.
-
API-Details finden Sie unter ListTagsForResource
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie put-logging-options verwendet wird.
- AWS CLI
-
So legen Sie Protokollierungsoptionen fest oder aktualisieren sie
Im folgenden
put-logging-options-Beispiel werden die Protokollierungsoptionen für AWS IoT Analytics festgelegt oder aktualisiert. Wenn Sie den Wert einesloggingOptions-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-jsonfile://put-logging-options.jsonInhalt 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 API-Referenz zu AWS IoT Analytics.
-
API-Details finden Sie unter PutLoggingOptions
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie run-pipeline-activity verwendet wird.
- AWS CLI
-
So simulieren Sie eine Pipeline-Aktivität
Im folgenden
run-pipeline-activity-Beispiel werden die Ergebnisse der Ausführung einer Pipeline-Aktivität für Nachrichtennutzdaten simuliert.aws iotanalytics run-pipeline-activity \ --pipeline-activityfile://maths.json\ --payloadsfile://payloads.jsonInhalt 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.
-
API-Details finden Sie unter RunPipelineActivity
in AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie sample-channel-data verwendet wird.
- AWS CLI
-
So rufen Sie Beispielnachrichten aus einem Kanal ab
Im folgenden
sample-channel-data-Beispiel 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-namemychannelAusgabe:
{ "payloads": [ "eyAidGVtcGVyYXR1cmUiOiAyMCB9", "eyAiZm9vIjogImJhciIgfQ==" ] }Weitere Informationen finden Sie unter SampleChannelData in der API-Referenz zu AWS IoT Analytics.
-
API-Details finden Sie unter SampleChannelData
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie start-pipeline-reprocessing verwendet wird.
- AWS CLI
-
So starten Sie die erneute Verarbeitung der Pipeline
Im folgenden
start-pipeline-reprocessing-Beispiel wird die erneute Verarbeitung von Rohnachrichtendaten über die angegebene Pipeline gestartet.aws iotanalytics start-pipeline-reprocessing \ --pipeline-namemypipelineAusgabe:
{ "reprocessingId": "6ad2764f-fb13-4de3-b101-4e74af03b043" }Weitere Informationen finden Sie unter StartPipelineReprocessing in der API-Referenz zu AWS IoT Analytics.
-
API-Details finden Sie unter StartPipelineReprocessing
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie tag-resource verwendet wird.
- AWS CLI
-
So fügen Sie Tags für eine Ressource hinzu oder ändern sie
Im folgenden
tag-resource-Beispiel 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.
-
API-Details finden Sie unter TagResource
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie untag-resource verwendet wird.
- AWS CLI
-
So entfernen Sie Tags von einer Ressource
Im folgenden
untag-resource-Beispiel 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.
-
API-Details finden Sie unter UntagResource
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie update-channel verwendet wird.
- AWS CLI
-
So ändern Sie einen Kanal
Im folgenden
update-channel-Beispiel werden die Einstellungen für den angegebenen Kanal geändert.aws iotanalytics update-channel \ --cli-input-jsonfile://update-channel.jsonInhalt 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.
-
API-Details finden Sie unter UpdateChannel
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie update-dataset verwendet wird.
- AWS CLI
-
So aktualisieren Sie einen Datensatz
Im folgenden
update-dataset-Beispiel werden die Einstellungen des angegebenen Datensatzes geändert.aws iotanalytics update-dataset \ --cli-input-jsonfile://update-dataset.jsonInhalt 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.
-
API-Details finden Sie unter UpdateDataset
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie update-datastore verwendet wird.
- AWS CLI
-
So aktualisieren Sie einen Datenspeicher
Im folgenden
update-datastore-Beispiel werden die Einstellungen des angegebenen Datenspeichers geändert.aws iotanalytics update-datastore \ --cli-input-jsonfile://update-datastore.jsonInhalt 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.
-
API-Details finden Sie unter UpdateDatastore
in der AWS CLI-Befehlsreferenz.
-
Das folgende Codebeispiel zeigt, wie update-pipeline verwendet wird.
- AWS CLI
-
So aktualisieren Sie eine Pipeline
Im folgenden
update-pipeline-Beispiel 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 impipelineActivities-Array angeben.aws iotanalytics update-pipeline \ --cli-input-jsonfile://update-pipeline.jsonInhalt 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.
-
API-Details finden Sie unter UpdatePipeline
in der AWS CLI-Befehlsreferenz.
-