Elasticsearch - AWS IoT Core
PrérequisParamètresExemplesConsultez aussi

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Elasticsearch

L'action Elasticsearch (elasticsearch) écrit les données des MQTT messages dans un domaine Amazon OpenSearch Service. Vous pouvez ensuite utiliser des outils tels que OpenSearch les tableaux de bord pour interroger et visualiser les données dans OpenSearch Service.

Avertissement

L'action Elasticsearch ne peut être utilisée que par les actions de règle existantes. Pour créer une nouvelle action de règle ou pour mettre à jour une action de règle existante, utilisez l'action de règle OpenSearch à la place. Pour de plus amples informations, veuillez consulter OpenSearch.

Prérequis

Cette action réglementaire est assortie des exigences suivantes :

  • IAMRôle qui AWS IoT peut assumer la réalisation de l'es:ESHttpPutopération. Pour de plus amples informations, veuillez consulter Accorder à une AWS IoT règle l'accès dont elle a besoin.

    Dans la AWS IoT console, vous pouvez choisir ou créer un rôle pour autoriser l'exécution AWS IoT de cette action de règle.

  • Si vous utilisez une KMS clé gérée par AWS KMS key le client pour chiffrer les données stockées OpenSearch, le service doit être autorisé à utiliser la KMS clé au nom de l'appelant. Pour plus d'informations, consultez la section Chiffrement des données au repos pour Amazon OpenSearch Service dans le manuel Amazon OpenSearch Service Developer Guide.

Paramètres

Lorsque vous créez une AWS IoT règle avec cette action, vous devez spécifier les informations suivantes :

endpoint

Point de terminaison de votre domaine de service.

Supporte les modèles de substitution : API et AWS CLI uniquement

index

Index dans lequel vous souhaitez stocker vos données.

Prend en charge les modèles de substitution : Oui

type

Type de document que vous stockez.

Prend en charge les modèles de substitution : Oui

id

Identifiant unique de chaque document.

Prend en charge les modèles de substitution : Oui

roleARN

IAMRôle qui autorise l'accès au domaine OpenSearch de service. Pour de plus amples informations, veuillez consulter Prérequis.

Prend en charge les modèles de substitution : Non

Exemples

L'JSONexemple suivant définit une action Elasticsearch dans une AWS IoT règle et explique comment vous pouvez spécifier les champs de cette action. elasticsearch Pour plus d'informations, consultez 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"
                }
            }
        ]
    }
}

L'JSONexemple suivant définit une action Elasticsearch avec des modèles de substitution dans une AWS IoT règle.

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

Consultez aussi