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á.
# Renomeação do Amazon OpenSearch Service - Resumo das alterações
Em 8 de setembro de 2021, nosso pacote de pesquisa e análise foi renomeado para Amazon OpenSearch Service. OpenSearch Suporte de serviço OpenSearch , bem como OSS legado do Elasticsearch. As seções a seguir descrevem as diferentes partes do serviço que foram alteradas com a renomeação do serviço e quais ações você precisa adotar para garantir que seus domínios continuem a funcionar corretamente.
Algumas dessas mudanças só se aplicam quando você atualiza seus domínios do Elasticsearch para o. OpenSearch Em outros casos, como no console de Billing and Cost Management, a experiência muda imediatamente.
Essa lista não é exaustiva. Ao mesmo tempo que outras partes do produto também mudaram, essas atualizações são as mais relevantes.
## Nova versão de API
A nova versão da API de configuração do OpenSearch Service (01/01/2021) funciona com o Elasticsearch OpenSearch OSS legado. 21 operações de API foram substituídas por nomes mais concisos e independentes do mecanismo (por exemplo, `CreateElasticsearchDomain` alterados para`CreateDomain`), mas o OpenSearch Service continua oferecendo suporte às duas versões da API.
Recomendamos utilizar as novas operações de API para criar e gerenciar domínios no futuro. Observe que, ao usar as novas operações de API para criar um domínio, você precisará especificar o parâmetro `EngineVersion` no formato `Elasticsearch_X.Y` ou `OpenSearch_X.Y`, em vez de apenas o número da versão. Se você não especificar uma versão, o padrão será a versão mais recente do. OpenSearch
Atualize seu AWS CLI para a versão 1.20.40 ou posterior para usá-lo `aws opensearch ...` para criar e gerenciar seus domínios. [Para o novo formato da CLI, consulte a referência da CLIOpenSearch .](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/opensearch/index.html)
## Tipos de instâncias renomeados
Os tipos de instância no Amazon OpenSearch Service agora estão no formato `..search` — por exemplo, `m6g.large.search` em vez de`m6g.large.elasticsearch`. Medida a ser tomada Os domínios existentes começarão a se referir automaticamente aos novos tipos de instâncias dentro da API e no console do Billing and Cost Management.
Se você tiver instâncias reservadas (RIs), seu contrato não será afetado pela alteração. A versão antiga da API de configuração ainda é compatível com o formato de nomenclatura antigo, mas se desejar usar a nova versão da API, você precisará usar o novo formato.
## Alterações na política de acesso
As seções a seguir descrevem quais ações você precisará executar para atualizar suas políticas de acesso.
### Políticas do IAM
Recomendamos atualizar suas [políticas do IAM](ac.md) para usar as operações de API renomeadas. No entanto, o OpenSearch Serviço continuará a respeitar as políticas existentes ao replicar internamente as permissões antigas da API. Por exemplo, se você tiver permissão para executar a operação `CreateElasticsearchDomain`, agora você poderá fazer chamadas tanto para `CreateElasticsearchDomain` (operação da API antiga) quanto `CreateDomain` (operação da API nova). O mesmo se aplica às negações explícitas. Para obter uma lista das operações de API atualizadas, consulte a [referência de elementos das políticas](ac.md#ac-reference).
### Políticas de SCP
[As políticas de controle de serviço (SCPs)](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scps.html) introduzem uma camada adicional de complexidade em comparação com o IAM padrão. Para evitar que suas políticas de SCP falhem, você deverá adicionar as operações de API antigas *e* novas a cada uma de suas políticas de SCP. Por exemplo, se um usuário tem permissões para `CreateElasticsearchDomain`, você também precisa conceder a eles permissões para `CreateDomain` para que eles possam manter a capacidade de criar domínios. O mesmo se aplica às negações explícitas.
Por exemplo:
```
"Statement": [
{
"Effect": "Allow",
"Action": [
"es:CreateElasticsearchDomain",
"es:CreateDomain"
...
],
},
"Effect": "Deny",
"Action:" [
"es:DeleteElasticsearchDomain",
"es:DeleteDomain"
...
```
## Novos tipos de recursos
OpenSearch O serviço apresenta os seguintes novos tipos de recursos:
| Recurso | Description |
| --- | --- |
| `AWS::OpenSearchService::Domain` | Representa um domínio OpenSearch do Amazon Service. Esse recurso existe no nível de serviço e não é específico do software em execução no domínio. Aplica-se a serviços como [CloudFormation](https://aws.amazon.com/cloudformation/) e [AWS Resource Groups](https://docs.aws.amazon.com/ARG/latest/userguide/welcome.html) (Grupos de recursos) nos quais você cria e gerencia recursos para o serviço como um todo.
Para obter instruções sobre como atualizar domínios definidos no CloudFormation Elasticsearch para OpenSearch, consulte [Comentários no Guia](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-opensearchservice-domain.html#aws-resource-opensearchservice-domain--remarks) do Usuário. CloudFormation |
| `AWS::OpenSearch::Domain` | Representa o OpenSearch/Elasticsearch software executado em um domínio. Esse recurso se aplica a serviços como [AWS CloudTrail](https://aws.amazon.com/documentation/cloudtrail/)e [AWS Config](https://aws.amazon.com/config/), que fazem referência ao software executado no domínio e não ao OpenSearch Serviço como um todo. Esses serviços agora contêm tipos de recursos separados para domínios que executam Elasticsearch (AWS::Elasticsearch::Domain) versus domínios executando (). OpenSearch AWS::OpenSearch::Domain |
**nota**
Em [AWS Config](https://aws.amazon.com/config/), você continuará vendo seus dados sob o tipo de `AWS::Elasticsearch::Domain` recurso existente por várias semanas, mesmo se atualizar um ou mais domínios para o. OpenSearch
## Kibana renomeado para Painéis OpenSearch
[OpenSearch Os painéis](dashboards.md), a AWS alternativa ao Kibana, são uma ferramenta de visualização de código aberto projetada para trabalhar com eles. OpenSearch Depois de atualizar um domínio do Elasticsearch para OpenSearch, o `/_plugin/kibana` endpoint muda para. `/_dashboards` OpenSearch O serviço redirecionará todas as solicitações para o novo endpoint, mas se você usar o endpoint Kibana em qualquer uma das suas políticas do IAM, atualize essas políticas para incluir também o novo endpoint. `/_dashboards`
Se você estiver usando[Autenticação SAML para painéis OpenSearch](saml.md), antes de atualizar seu domínio para OpenSearch, você precisa alterar todo o Kibana URLs configurado em seu provedor de identidade (IdP) de para. `/_plugin/kibana` `/_dashboards` Os mais comuns URLs são assertion consumer service (ACS) URLs e destinatário. URLs
A `kibana_read_only` função padrão dos OpenSearch Painéis foi renomeada para`opensearch_dashboards_read_only`, e a `kibana_user` função foi renomeada para. `opensearch_dashboards_user` A alteração se aplica a todos os *recém-criados 1* OpenSearch . domínios *x* executando o software de serviço R20211203 ou posterior. Se você atualizar um domínio existente para o software de serviço R20211203, os nomes de funções permanecem os mesmos.
## Métricas renomeadas CloudWatch
Várias CloudWatch métricas mudam nos domínios em execução OpenSearch. Quando você atualiza um domínio para OpenSearch, as métricas mudam automaticamente e seus CloudWatch alarmes atuais são interrompidos. Antes de atualizar seu cluster de uma versão do Elasticsearch para uma OpenSearch versão, certifique-se de atualizar seus CloudWatch alarmes para usar as novas métricas.
As seguintes métricas foram alteradas:
| Nome da métrica original | Novo nome |
| --- | --- |
| `KibanaHealthyNodes` | `OpenSearchDashboardsHealthyNodes` |
| `KibanaConcurrentConnections` | `OpenSearchDashboardsConcurrentConnections` |
| `KibanaHeapTotal` | `OpenSearchDashboardsHeapTotal` |
| `KibanaHeapUsed` | `OpenSearchDashboardsHeapUsed` |
| `KibanaHeapUtilization` | `OpenSearchDashboardsHeapUtilization` |
| `KibanaOS1MinuteLoad` | `OpenSearchDashboardsOS1MinuteLoad` |
| `KibanaRequestTotal` | `OpenSearchDashboardsRequestTotal` |
| `KibanaResponseTimesMaxInMillis` | `OpenSearchDashboardsResponseTimesMaxInMillis` |
| `ESReportingFailedRequestSysErrCount` | `KibanaReportingFailedRequestSysErrCount` |
| `ESReportingRequestCount` | `KibanaReportingRequestCount` |
| `ESReportingFailedRequestUserErrCount` | `KibanaReportingFailedRequestUserErrCount` |
| `ESReportingSuccessCount` | `KibanaReportingSuccessCount` |
| `ElasticsearchRequests` | `OpenSearchRequests` |
Para obter uma lista completa das métricas que o OpenSearch Serviço envia para a Amazon CloudWatch, consulte[Monitorando métricas de OpenSearch cluster com a Amazon CloudWatch](managedomains-cloudwatchmetrics.md).
## Abra o console do Billing and Cost Management.
Os dados históricos no console do [Billing and Cost](https://console.aws.amazon.com/billing/home) Management e [nos relatórios de custos e uso](https://aws.amazon.com/aws-cost-management/aws-cost-and-usage-reporting/) continuarão usando o nome antigo do serviço, então você precisa começar a usar filtros tanto para o ** OpenSearch Amazon** Service quanto para o nome antigo do Elasticsearch ao pesquisar dados. Se você já tiver relatórios salvos, atualize os filtros para garantir que eles também incluam OpenSearch Serviço. Inicialmente, você pode receber um alerta quando seu uso do Elasticsearch diminui e aumenta OpenSearch, mas ele desaparece em alguns dias.
Além do nome do serviço, os campos a seguir serão alterados para todos os relatórios, listas e operações de API de lista de preços:
| Campo | Formato antigo | Formato de linha |
| --- | --- | --- |
| Tipo de instância | `m5.large.elasticsearch` | `m5.large.search` |
| Família de produtos | Instância do Elasticsearch
Volume do Elasticsearch | Instância OpenSearch de serviço da Amazon
Volume OpenSearch de serviços da Amazon |
| Descrição dos preços | 5,098 USD por hora de instância c5.18xlarge.elasticsearch (ou hora parcial), UE | 5,098 USD por hora de instância c5.18xlarge.search (ou hora parcial), UE |
| Família de instâncias | `ultrawarm.elasticsearch` | `ultrawarm.search` |
## Novo formato dos eventos
O formato dos eventos que o OpenSearch Serviço envia para a Amazon EventBridge e a Amazon CloudWatch mudou, especificamente o `detail-type` campo. O campo de origem (`aws.es`) permanece o mesmo. Para obter o formato completo de cada tipo de evento, consulte [Eventos do OpenSearch Serviço de Monitoramento com a Amazon EventBridge](monitoring-events.md). Se você tiver regras de evento existentes que dependem do formato antigo, atualize-as para que estejam em conformidade com o novo formato.
## O que não mudou?
Os seguintes recursos e funcionalidades, entre outros não listados, permanecerão os mesmos:
+ Entidade principal do serviço (`es.amazonaws.com`)
+ Código do fornecedor
+ Domínio ARNs
+ Endpoints de domínio
## Comece: atualize seus domínios para 1.x OpenSearch
OpenSearch 1. *x* suporta atualizações das versões 6.8 e 7 do Elasticsearch. *x.* Para obter instruções sobre como atualizar seu domínio, consulte [Atualizar um domínio (console)](starting-upgrades.md). Se você estiver usando a API de configuração AWS CLI ou para atualizar seu domínio, precisará especificar `TargetVersion` as`OpenSearch_1.x`.
OpenSearch 1. *x* introduz uma configuração de domínio adicional chamada **Ativar modo de compatibilidade.** Como certos clientes e plug-ins do Elasticsearch OSS verificam a versão do cluster antes de se conectarem, o modo de compatibilidade é configurado OpenSearch para relatar sua versão como 7.10 para que esses clientes continuem trabalhando.
Você pode ativar o modo de compatibilidade ao criar OpenSearch domínios pela primeira vez ou ao fazer o upgrade para uma versão OpenSearch do Elasticsearch. Se não estiver definido, o parâmetro assumirá como padrão o valor `false` quando você criar um domínio e `true` quando você atualizar um domínio.
Para habilitar o modo de compatibilidade usando a [API de configuração](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_UpgradeDomain.html), defina `override_main_response_version` como `true`:
```
POST https://es.us-east-1.amazonaws.com/2021-01-01/opensearch/upgradeDomain
{
"DomainName": "{{domain-name}}",
"TargetVersion": "OpenSearch_1.0",
"AdvancedOptions": {
"override_main_response_version": "true"
}
}
```
Para ativar ou desativar o modo de compatibilidade em OpenSearch domínios *existentes*, você precisa usar a operação da API OpenSearch [\_cluster/settings](https://docs.opensearch.org/latest/opensearch/rest-api/cluster-settings/):
```
PUT /_cluster/settings
{
"persistent" : {
"compatibility.override_main_response_version" : true
}
}
```