Elasticsearch - AWS IoT Core
VoraussetzungenParameterBeispieleWeitere Informationen finden Sie auch unter

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Elasticsearch

Die Elasticsearch (elasticsearch) -Aktion schreibt Daten aus MQTT-Nachrichten in eine Amazon OpenSearch Service-Domain. Sie können dann Tools wie OpenSearch Dashboards verwenden, um Daten in Service abzufragen und zu visualisieren. OpenSearch

Warnung

Die Elasticsearch Aktion kann nur von vorhandenen Regelaktion verwendet werden. Um eine neue Regelaktion zu erstellen oder eine vorhandene Regelaktion zu aktualisieren, verwenden Sie stattdessen die OpenSearch Regelaktion. Weitere Informationen finden Sie unter OpenSearch.

Voraussetzungen

Diese Regelaktion hat die folgenden Anforderungen:

  • Eine IAM-Rolle, die die Ausführung des es:ESHttpPut Vorgangs übernehmen AWS IoT kann. Weitere Informationen finden Sie unter Gewähren Sie einer AWS IoT Regel den Zugriff, den sie benötigt.

    In der AWS IoT Konsole können Sie eine Rolle auswählen oder erstellen, um die Ausführung dieser Regelaktion AWS IoT zu ermöglichen.

  • Wenn Sie einen vom Kunden verwalteten AWS KMS key (KMS-Schlüssel) verwenden, um gespeicherte Daten zu verschlüsseln OpenSearch, muss der Dienst die Erlaubnis haben, den KMS-Schlüssel im Namen des Anrufers zu verwenden. Weitere Informationen finden Sie unter Verschlüsselung ruhender Daten für Amazon OpenSearch Service im Amazon OpenSearch Service Developer Guide.

Parameter

Wenn Sie eine AWS IoT Regel mit dieser Aktion erstellen, müssen Sie die folgenden Informationen angeben:

endpoint

Der Endpunkt Ihrer Service-Domain

Unterstützt Ersatzvorlagen: API und nur AWS CLI

index

Der Index, in dem Sie die Daten speichern möchten

Unterstützt Ersatzvorlagen: Ja

type

Der Typ des Dokuments, das Sie speichern

Unterstützt Ersatzvorlagen: Ja

id

Der eindeutige Bezeichner für jedes Dokument

Unterstützt Ersatzvorlagen: Ja

roleARN

Die IAM-Rolle, die den Zugriff auf die OpenSearch Service-Domain ermöglicht. Weitere Informationen finden Sie unter Voraussetzungen.

Unterstützt Ersatzvorlagen: Nein

Beispiele

Das folgende JSON-Beispiel definiert eine Elasticsearch-Aktion in einer AWS IoT Regel und zeigt, wie Sie die Felder für die elasticsearch Aktion angeben können. Weitere Informationen finden Sie unter ElasticsearchAction.

{
    "topicRulePayload": {
        "sql": "SELECT *, timestamp() as timestamp FROM 'iot/test'",
        "ruleDisabled": false,
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "elasticsearch": {
                    "endpoint": "https://my-endpoint",
                    "index": "my-index",
                    "type": "my-type",
                    "id": "${newuuid()}",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_es"
                }
            }
        ]
    }
}

Das folgende JSON-Beispiel definiert eine Elasticsearch-Aktion mit Ersatzvorlagen in einer AWS IoT Regel.

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'",
        "ruleDisabled": false,
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "elasticsearch": {
                    "endpoint": "https://my-endpoint",
                    "index": "${topic()}",
                    "type": "${type}",
                    "id": "${newuuid()}",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_es"
                }
            }
        ]
    }
}

Weitere Informationen finden Sie auch unter