Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Tindakan OpenSearch (openSearch) menulis data dari MQTT pesan 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:
-
IAMPeran yang AWS IoT dapat diasumsikan untuk melakukan
es:ESHttpPutoperasi. Untuk informasi selengkapnya, lihat Memberikan AWS IoT aturan akses yang dibutuhkannya.Di AWS IoT konsol, Anda dapat memilih atau membuat peran untuk memungkinkan AWS IoT untuk melakukan tindakan aturan ini.
-
Jika Anda menggunakan pelanggan yang AWS KMS key berhasil mengenkripsi data saat istirahat di OpenSearch Layanan, layanan harus memiliki izin untuk menggunakan KMS kunci atas nama pemanggil. Untuk informasi selengkapnya, lihat Enkripsi data saat istirahat 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.
Mendukung template substitusi: API dan hanya AWS CLI
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
typeparameter harus_doc. Untuk informasi lebih lanjut, lihat dokumentasi OpenSearch. Mendukung template substitusi: Ya
id-
Pengidentifikasi unik untuk setiap dokumen.
Mendukung template substitusi: Ya
roleARN-
IAMPeran yang memungkinkan akses ke domain OpenSearch Layanan. Untuk informasi selengkapnya, lihat Persyaratan.
Mendukung template substitusi: Tidak
Batasan
Tindakan OpenSearch (openSearch) tidak dapat digunakan untuk mengirimkan data ke cluster VPC Elasticsearch.
Contoh
JSONContoh 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"
}
}
]
}
}JSONContoh berikut mendefinisikan OpenSearch tindakan dengan template substitusi dalam aturan. AWS IoT
{ "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
typeBidang yang diganti berfungsi untuk OpenSearch versi 1.0. Untuk versi apa pun yang lebih lambat dari 1.0, nilai type harus_doc.
Lihat juga
Apa itu OpenSearch Layanan Amazon? di Panduan Pengembang OpenSearch Layanan Amazon
