As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
A ação OpenSearch (openSearch) grava dados de MQTT mensagens em um domínio da Amazon OpenSearch Service. Em seguida, você pode usar ferramentas como OpenSearch painéis para consultar e visualizar dados no OpenSearch Service.
Requisitos
Esta ação de regra tem os seguintes requisitos:
-
Uma IAM função que AWS IoT pode ser assumida para realizar a
es:ESHttpPutoperação. Para obter mais informações, consulte Conceder a uma AWS IoT regra o acesso que ela exige.No AWS IoT console, você pode escolher ou criar uma função para permitir AWS IoT a execução dessa ação de regra.
-
Se você usa um cliente gerenciado AWS KMS key para criptografar dados em repouso no OpenSearch Service, o serviço deve ter permissão para usar a KMS chave em nome do chamador. Para obter mais informações, consulte Criptografia de dados em repouso para o Amazon OpenSearch Service no Amazon OpenSearch Service Developer Guide.
Parâmetros
Ao criar uma AWS IoT regra com essa ação, você deve especificar as seguintes informações:
endpoint-
O endpoint do seu domínio do Amazon OpenSearch Service.
Suporta modelos de substituição: API e somente AWS CLI
index-
O OpenSearch índice em que você deseja armazenar seus dados.
Compatível com modelos de substituição: Sim
type-
O tipo de documento que você está armazenando.
nota
Para OpenSearch versões posteriores à 1.0, o valor do
typeparâmetro deve ser_doc. Para obter mais informações, consulte a documentação do OpenSearch. Compatível com modelos de substituição: Sim
id-
O identificador exclusivo de cada documento.
Compatível com modelos de substituição: Sim
roleARN-
A IAM função que permite o acesso ao domínio do OpenSearch Serviço. Para obter mais informações, consulte Requisitos.
Compatível com modelos de substituição: Não
Limitações
A ação OpenSearch (openSearch) não pode ser usada para entregar dados aos clusters do VPC Elasticsearch.
Exemplos
O JSON exemplo a seguir define uma OpenSearch ação em uma AWS IoT regra e como você pode especificar os campos para a OpenSearch ação. Para obter mais informações, consulte 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"
}
}
]
}
}O JSON exemplo a seguir define uma OpenSearch ação com modelos de substituição em uma AWS IoT regra.
{ "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" } } ] } }
nota
O type campo substituído funciona para a OpenSearch versão 1.0. Para qualquer versão posterior à 1.0, o valor de type deve ser _doc.
Consulte também
O que é o Amazon OpenSearch Service? no Amazon OpenSearch Service Developer Guide
