Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Amazon OpenSearch Service rename - Riepilogo delle modifiche
L'8 settembre 2021, la nostra suite di ricerca e analisi è stata rinominata Amazon OpenSearch Service. OpenSearch Il servizio supporta OpenSearch oltre al precedente sistema operativo Elasticsearch. Nelle sezioni seguenti vengono descritte le diverse parti del servizio modificate con la rinomina del servizio e le operazioni da eseguire per garantire che i domini continuino a funzionare correttamente.
Alcune di queste modifiche si applicano solo quando aggiorni i tuoi domini da Elasticsearch a. OpenSearch In altri casi, ad esempio nella console di gestione fatturazione e costi, l'esperienza cambia immediatamente.
Questo elenco non è completo. Mentre anche altre parti del prodotto sono cambiate, questi aggiornamenti sono i più rilevanti.
## Nuova versione dell'API
La nuova versione dell'API di configurazione del OpenSearch servizio (2021-01-01) funziona anche con il precedente sistema operativo Elasticsearch. OpenSearch 21 operazioni API sono state sostituite con nomi più concisi e indipendenti dal motore (ad esempio, modificati in), ma Service continua a supportare entrambe le versioni dell'API. `CreateElasticsearchDomain` `CreateDomain` OpenSearch
Per creare e gestire domini da questo punto in poi, consigliamo di utilizzare le nuove operazioni API. Notare che quando si utilizzano le nuove operazioni API per creare un dominio, è necessario specificare il parametro `EngineVersion` nel formato `Elasticsearch_X.Y` o `OpenSearch_X.Y`, piuttosto che solo il numero di versione. Se non si specifica una versione, per impostazione predefinita viene utilizzata la versione più recente di. OpenSearch
Aggiorna il tuo AWS CLI alla versione 1.20.40 o successiva per utilizzarlo per creare e gestire `aws opensearch ...` i tuoi domini. [Per il nuovo formato CLI, consultate il riferimento CLIOpenSearch .](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/opensearch/index.html)
## Tipi di istanza rinominati
I tipi di istanza in Amazon OpenSearch Service ora sono nel formato, ad `..search` esempio, `m6g.large.search` anziché`m6g.large.elasticsearch`. Non è necessario eseguire nessuna operazione. I domini esistenti inizieranno automaticamente con riferimento ai nuovi tipi di istanza all'interno dell'API e nella console di gestione fatturazione e costi.
Se disponi di istanze riservate (RIs), il tuo contratto non sarà influenzato dalla modifica. La versione precedente dell'API di configurazione è ancora compatibile con il vecchio formato di denominazione, ma se si desidera utilizzare la nuova versione dell'API, sarà necessario utilizzare il nuovo formato.
## Modifiche delle policy di accesso
Nelle sezioni seguenti vengono descritte le azioni da intraprendere per aggiornare le policy di accesso.
### Policy IAM
Consigliamo di aggiornare le [policy IAM](ac.md) in modo da utilizzare le operazioni API rinominate. Tuttavia, OpenSearch Service continuerà a rispettare le politiche esistenti replicando internamente le vecchie autorizzazioni API. Ad esempio, se al momento si dispone dell'autorizzazione per eseguire l'operazione `CreateElasticsearchDomain`, è ora possibile effettuare sia chiamate a `CreateElasticsearchDomain` (vecchia operazione API) che a `CreateDomain` (nuova operazione API). Lo stesso vale per i rifiuti espliciti. Per un elenco delle operazioni API aggiornate, consultare il [riferimento all'elemento policy](ac.md#ac-reference).
### Policy SCP
[Le policy di controllo dei servizi (SCPs)](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scps.html) introducono un ulteriore livello di complessità rispetto allo standard IAM. Per evitare che le policy SCP non vengano rispettate, *è necessario* aggiungere sia le vecchie operazioni che le nuove per ogni policy SCP. Ad esempio, se un utente dispone attualmente delle autorizzazioni per `CreateElasticsearchDomain`, è necessario concedere loro anche le autorizzazioni per `CreateDomain` in modo che possano mantenere la possibilità di creare domini. Lo stesso vale per i rifiuti espliciti.
Ad esempio:
```
"Statement": [
{
"Effect": "Allow",
"Action": [
"es:CreateElasticsearchDomain",
"es:CreateDomain"
...
],
},
"Effect": "Deny",
"Action:" [
"es:DeleteElasticsearchDomain",
"es:DeleteDomain"
...
```
## Nuovi tipi di risorsa
OpenSearch Il servizio introduce i seguenti nuovi tipi di risorse:
| Risorsa | Description |
| --- | --- |
| `AWS::OpenSearchService::Domain` | Rappresenta un dominio Amazon OpenSearch Service. Questa risorsa esiste a livello di servizio e non è specifica del software in esecuzione nel dominio. Si applica a servizi come [CloudFormation](https://aws.amazon.com/cloudformation/) e [AWS Resource Groups](https://docs.aws.amazon.com/ARG/latest/userguide/welcome.html), in cui è possibile creare e gestire le risorse per il servizio nel suo complesso. Per istruzioni su come aggiornare i domini definiti in Elasticsearch CloudFormation a OpenSearch, consulta la sezione [Note](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-opensearchservice-domain.html#aws-resource-opensearchservice-domain--remarks) nella Guida per l'utente. CloudFormation |
| `AWS::OpenSearch::Domain` | Rappresenta il OpenSearch/Elasticsearch software in esecuzione su un dominio. Questa risorsa si applica a servizi come [AWS CloudTrail](https://aws.amazon.com/documentation/cloudtrail/)and [AWS Config](https://aws.amazon.com/config/), che fanno riferimento al software in esecuzione sul dominio anziché al OpenSearch servizio nel suo insieme. Questi servizi ora contengono tipi di risorse separati per i domini che eseguono Elasticsearch (AWS::Elasticsearch::Domain) rispetto ai domini che eseguono (). OpenSearch AWS::OpenSearch::Domain |
**Nota**
In [AWS Config](https://aws.amazon.com/config/), continuerai a visualizzare i tuoi dati nel tipo di `AWS::Elasticsearch::Domain` risorsa esistente per diverse settimane, anche se esegui l'upgrade di uno o più domini a. OpenSearch
## Kibana è stato rinominato in Dashboards OpenSearch
[OpenSearch Dashboards](dashboards.md), l' AWS alternativa a Kibana, è uno strumento di visualizzazione open source progettato per funzionare con. OpenSearch Dopo aver aggiornato un dominio da Elasticsearch a, l'endpoint cambia in. OpenSearch `/_plugin/kibana` `/_dashboards` OpenSearch Il servizio reindirizzerà tutte le richieste al nuovo endpoint, ma se utilizzi l'endpoint Kibana in una delle tue policy IAM, aggiorna tali policy per includere anche il nuovo endpoint. `/_dashboards`
Se utilizzi[Autenticazione SAML per dashboard OpenSearch](saml.md), prima di aggiornare il tuo dominio a OpenSearch, devi modificare tutti i Kibana URLs configurati nel tuo provider di identità (IdP) da a. `/_plugin/kibana` `/_dashboards` I più comuni URLs sono Assertion Consumer Service (ACS) e Destinatario. URLs URLs
Il `kibana_read_only` ruolo predefinito per OpenSearch Dashboards è stato rinominato in e il `kibana_user` ruolo è stato rinominato in. `opensearch_dashboards_read_only` `opensearch_dashboards_user` *La modifica si applica a tutti i 1 appena creati.* OpenSearch domini *x* che eseguono il software di servizio R20211203 o versione successiva. Se si aggiorna un dominio esistente al software del servizio R20211203, i nomi dei ruoli rimangono invariati.
## CloudWatch Metriche rinominate
Diverse CloudWatch metriche cambiano per i domini in esecuzione. OpenSearch Quando aggiorni un dominio a OpenSearch, le metriche cambiano automaticamente e gli CloudWatch allarmi attuali si interrompono. Prima di aggiornare il cluster da una versione di Elasticsearch a una OpenSearch versione, assicurati di aggiornare gli CloudWatch allarmi per utilizzare le nuove metriche.
Sono stati modificati i seguenti parametri:
| Nome parametro originale | Nuovo 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` |
Per un elenco completo delle metriche inviate dal OpenSearch Servizio ad Amazon CloudWatch, consulta[Monitoraggio delle metriche dei OpenSearch cluster con Amazon CloudWatch](managedomains-cloudwatchmetrics.md).
## Modifiche della console Gestione fatturazione e costi
I dati storici nella console di [Billing and Cost](https://console.aws.amazon.com/billing/home) Management e [nei report sui costi e sull'utilizzo](https://aws.amazon.com/aws-cost-management/aws-cost-and-usage-reporting/) continueranno a utilizzare il vecchio nome di servizio, quindi devi iniziare a utilizzare i filtri sia per ** OpenSearch Amazon** Service che per il nome precedente di Elasticsearch durante la ricerca dei dati. Se hai già dei report salvati, aggiorna i filtri per assicurarti che includano anche Service. OpenSearch Inizialmente potresti ricevere un avviso quando l'utilizzo di Elasticsearch diminuisce o aumenta OpenSearch, ma scompare nel giro di alcuni giorni.
Oltre al nome del servizio, i campi seguenti verranno modificati per tutti i report, le fatture e le operazioni API del listino prezzi:
| Campo | Vecchio formato | Nuovo formato |
| --- | --- | --- |
| Tipo di istanza | `m5.large.elasticsearch` | `m5.large.search` |
| Famiglia di prodotti | Istanza Elasticsearch Volume Elasticsearch | Istanza OpenSearch di servizio Amazon Volume OpenSearch di servizi Amazon |
| Descrizione dei prezzi | 5.098 USD per ora di istanza c5.18xlarge.elasticsearch (o ora parziale) - EU | 5.098 USD per ora di istanza c5.18xlarge.search (o ora parziale) - EU |
| Famiglia di istanze | `ultrawarm.elasticsearch` | `ultrawarm.search` |
## Nuovo formato evento
Il formato degli eventi che il OpenSearch Servizio invia ad Amazon EventBridge e Amazon CloudWatch è cambiato, in particolare il `detail-type` campo. Il campo di origine (`aws.es`) rimane lo stesso. Per il formato completo per ogni tipo di evento, consultare [Monitoraggio degli eventi del OpenSearch servizio con Amazon EventBridge](monitoring-events.md). Se si dispone di regole di evento esistenti che dipendono dal formato precedente, assicurarsi di aggiornarle in modo che siano conformi al nuovo formato.
## Cosa rimane lo stesso?
Le seguenti caratteristiche e funzionalità, tra le altre non elencate, rimarranno invariate:
+ Principale del servizio (`es.amazonaws.com`)
+ Codice fornitore
+ Dominio ARNs
+ Endpoint di dominio
## Inizia: aggiorna i tuoi domini alla OpenSearch versione 1.x
OpenSearch 1. *x* supporta gli aggiornamenti dalle versioni 6.8 e 7 di Elasticsearch. *x*. Per istruzioni su come aggiornare il dominio, consultare [Aggiornamento di un dominio (console)](starting-upgrades.md). Se utilizzi l'API AWS CLI o di configurazione per aggiornare il tuo dominio, devi specificare l'`TargetVersion`as`OpenSearch_1.x`.
OpenSearch 1. *x* introduce un'impostazione di dominio aggiuntiva denominata **Abilita la modalità di compatibilità.** Poiché alcuni client e plugin Elasticsearch OSS controllano la versione del cluster prima di connettersi, la modalità di compatibilità imposta in modo OpenSearch da riportare la versione 7.10 in modo che questi client continuino a funzionare.
Puoi abilitare la modalità di compatibilità quando crei OpenSearch domini per la prima volta o quando esegui l'aggiornamento da una versione di Elasticsearch. OpenSearch Se non è impostato, viene ripristinato il parametro predefinito, `false`, quando crei un dominio e `true` quando esegui l'aggiornamento di un dominio.
Per abilitare la modalità di compatibilità utilizzando l'[API di configurazione](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_UpgradeDomain.html), impostare `override_main_response_version` su `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"
}
}
```
[Per abilitare o disabilitare la modalità di compatibilità sui OpenSearch domini *esistenti*, devi utilizzare l'operazione API \$1cluster/settings: OpenSearch ](https://docs.opensearch.org/latest/opensearch/rest-api/cluster-settings/)
```
PUT /_cluster/settings
{
"persistent" : {
"compatibility.override_main_response_version" : true
}
}
```