View a markdown version of this page

Elasticsearch - AWS IoT Core
RequisitiParametersEsempiConsulta anche

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Elasticsearch

L'azione Elasticsearch (elasticsearch) scrive i dati dai messaggi MQTT su un dominio Amazon Service. OpenSearch Puoi quindi utilizzare strumenti come OpenSearch Dashboards per interrogare e visualizzare i dati nel Servizio. OpenSearch

avvertimento

L'operazione Elasticsearch può essere utilizzata solo da operazioni regola esistenti. Per creare una nuova operazione regola o per aggiornarne una esistente, utilizzare invece l'operazione regola OpenSearch. Per ulteriori informazioni, consulta OpenSearch.

Requisiti

Questa operazione della regola presenta i seguenti requisiti:

  • Un ruolo IAM che AWS IoT può assumere per eseguire l'es:ESHttpPutoperazione. Per ulteriori informazioni, consulta Concessione di un AWS IoT regola l'accesso che richiede.

    Nella AWS IoT console, puoi scegliere o creare un ruolo per consentire l'esecuzione AWS IoT di questa azione basata sulla regola.

  • Se utilizzi una chiave KMS gestita AWS KMS key dal cliente per crittografare i dati inattivi OpenSearch, il servizio deve disporre dell'autorizzazione per utilizzare la chiave KMS per conto del chiamante. Per ulteriori informazioni, consulta Encryption of data at rest for Amazon OpenSearch Service nella Amazon Service Developer Guide. OpenSearch

Parameters

Quando crei una AWS IoT regola con questa azione, devi specificare le seguenti informazioni:

endpoint

Endpoint del dominio del tuo servizio.

Supporta i modelli di sostituzione: API e solo AWS CLI

index

Indice in cui archiviare i dati.

Supporta modelli di sostituzione: sì

type

Tipo di documento che stai archiviando.

Supporta modelli di sostituzione: sì

id

Identificatore univoco per ogni documento.

Supporta modelli di sostituzione: sì

roleARN

Il ruolo IAM che consente l'accesso al dominio del OpenSearch servizio. Per ulteriori informazioni, consulta Requisiti.

Supporta modelli di sostituzione: no

Esempi

Il seguente esempio JSON definisce un'azione Elasticsearch in una AWS IoT regola e come specificare i campi per l'azione. elasticsearch Per ulteriori informazioni, consulta 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"
                }
            }
        ]
    }
}

Il seguente esempio JSON definisce un'azione Elasticsearch con modelli di sostituzione in una regola. AWS IoT 

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

Consulta anche