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

# OpenSearch
<a name="opensearch-rule-action"></a>

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

## Persyaratan
<a name="opensearch-rule-action-requirements"></a>

Tindakan aturan ini memiliki persyaratan sebagai berikut:
+ Peran IAM yang AWS IoT dapat diasumsikan untuk melakukan `es:ESHttpPut` operasi. Untuk informasi selengkapnya, lihat [Memberikan AWS IoT aturan akses yang dibutuhkannya](iot-create-role.md).

  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 kunci KMS atas nama pemanggil. Untuk informasi selengkapnya, lihat [Enkripsi data saat istirahat untuk OpenSearch Layanan Amazon](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/encryption-at-rest.html) *di Panduan Pengembang OpenSearch Layanan Amazon*.

## Parameter
<a name="opensearch-rule-action-parameters"></a>

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](iot-substitution-templates.md): API dan hanya AWS CLI 

`index`  
 OpenSearch Indeks tempat Anda ingin menyimpan data Anda.  
Mendukung [template substitusi](iot-substitution-templates.md): Ya

`type`  
Jenis dokumen yang Anda simpan.   
Untuk OpenSearch versi yang lebih lambat dari 1.0, nilai `type` parameter harus`_doc`. Lihat informasi yang lebih lengkap dalam [dokumentasi OpenSearch ](https://opensearch.org/docs/1.0/opensearch/rest-api/document-apis/index-document/#response-body-fields).
Mendukung [template substitusi](iot-substitution-templates.md): Ya

`id`  
Pengidentifikasi unik untuk setiap dokumen.  
Mendukung [template substitusi](iot-substitution-templates.md): Ya

`roleARN`  
Peran IAM yang memungkinkan akses ke domain OpenSearch Layanan. Untuk informasi selengkapnya, lihat [Persyaratan](#opensearch-rule-action-requirements).  
Mendukung [template substitusi](iot-substitution-templates.md): Tidak

## Batasan
<a name="opensearch-rule-action-limitations"></a>

Tindakan OpenSearch (`openSearch`) tidak dapat digunakan untuk mengirimkan data ke klaster VPC Elasticsearch.

## Contoh
<a name="opensearch-rule-action-examples"></a>

Contoh JSON berikut mendefinisikan OpenSearch tindakan dalam AWS IoT aturan dan bagaimana Anda dapat menentukan bidang untuk tindakan. `OpenSearch` Untuk informasi selengkapnya, lihat [OpenSearchAction](https://docs.aws.amazon.com/iot/latest/apireference/API_OpenSearchAction.html).

```
{
    "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 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**  
`type`Bidang yang diganti berfungsi untuk OpenSearch versi 1.0. Untuk versi apa pun yang lebih lambat dari 1.0, nilai `type` harus`_doc`.

## Lihat juga
<a name="opensearch-rule-action-see-also"></a>

[Apa itu OpenSearch Layanan Amazon?](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/) di *Panduan Pengembang OpenSearch Layanan Amazon*