View a markdown version of this page

OpenSearch - AWS IoT Core
PersyaratanParameterBatasanContohLihat juga

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

OpenSearch

Tind openSearch akan OpenSearch () menulis data dari pesan MQTT ke domain OpenSearch Layanan Amazon. Anda kemudian dapat menggunakan alat seperti OpenSearch Dasbor untuk menanyakan dan memvisualisasikan data di OpenSearch Layanan.

Persyaratan

Tindakan aturan ini memiliki persyaratan sebagai berikut:

  • Peran IAM yang AWS IoT dapat diasumsikan untuk melakukan es:ESHttpPut operasi. Untuk informasi selengkapnya, lihat Pemberian AWS IoT mengatur akses yang dibutuhkannya.

    Di AWS IoT konsol, Anda dapat memilih atau membuat peran AWS IoT untuk memungkinkan melakukan tindakan aturan ini.

  • Jika Anda menggunakan pelanggan yang AWS KMS key berhasil mengenkripsi data saat diam di OpenSearch Layanan, layanan harus memiliki izin untuk menggunakan kunci KMS atas nama penelepon. Untuk informasi selengkapnya, lihat Enkripsi data diam untuk OpenSearch Layanan Amazon di Panduan Pengembang OpenSearch Layanan Amazon.

Parameter

Saat Anda membuat AWS IoT aturan dengan tindakan ini, Anda harus menentukan informasi berikut:

endpoint

Titik akhir domain OpenSearch Layanan Amazon Anda.

Men dukung template substitusi: API dan AWS CLI hanya

index

OpenSearch Indeks tempat Anda ingin menyimpan data Anda.

Mendukung template substitusi: Ya

type

Jenis dokumen yang Anda simpan.

catatan

Untuk OpenSearch versi yang lebih lambat dari 1.0, nilai type parameter harus_doc. Lihat informasi yang lebih lengkap dalam dokumentasi OpenSearch .

Mendukung template substitusi: Ya

id

Pengidentifikasi unik untuk setiap dokumen.

Mendukung template substitusi: Ya

roleARN

Peran IAM yang memungkinkan akses ke domain OpenSearch Layanan. Untuk informasi selengkapnya, lihat Persyaratan.

Mendukung template substitusi: Tidak

Batasan

Tind OpenSearch akan (openSearch) tidak dapat digunakan untuk mengirimkan data ke cluster VPC Elasticsearch.

Contoh

Contoh JSON berikut mendefinisikan OpenSearch tindakan dalam AWS IoT aturan dan bagaimana Anda dapat menentukan bidang untuk OpenSearch tindakan tersebut. Untuk informasi selengkapnya, lihat OpenSearchAction.

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

Contoh JSON berikut mendefinisikan OpenSearch tindakan dengan template substitusi dalam AWS IoT aturan.

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

Bidang sub type stitusi berfungsi untuk OpenSearch versi 1.0. Untuk versi apa pun yang lebih lambat dari 1.0, nil type ainya harus_doc.

Lihat juga

Apa itu OpenSearch Layanan Amazon? dalam Panduan Pengembang OpenSearch Layanan Amazon