Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Umbenennung von Amazon OpenSearch Service — Zusammenfassung der Änderungen
Am 8. September 2021 wurde unsere Such- und Analysesuite in Amazon OpenSearch Service umbenannt. OpenSearch Der Service unterstützt sowohl ältere Elasticsearch-Betriebssysteme OpenSearch als auch ältere Versionen. In den folgenden Abschnitten werden die verschiedenen Teile des Services beschrieben, die sich mit der Umbenennung geändert haben und welche Maßnahmen Sie ergreifen müssen, um sicherzustellen, dass Ihre Domains weiterhin ordnungsgemäß funktionieren.
Einige dieser Änderungen gelten nur, wenn Sie Ihre Domains von Elasticsearch auf aktualisieren. OpenSearch In anderen Fällen, z. B. in der Fakturierung- und Kostenmanagement-Konsole, ändert sich die Benutzererfahrung sofort.
Beachten Sie, dass diese Liste nicht vollumfänglich ist. Auch andere Teile des Produkts haben sich geändert, aber diese Updates sind am relevantesten.
## Neue API-Version
Die neue Version der OpenSearch Service Configuration API (2021-01-01) funktioniert OpenSearch genauso gut mit dem alten Elasticsearch OSS. 21 API-Operationen wurden durch prägnantere und engine-unabhängige Namen ersetzt (z. B. `CreateElasticsearchDomain` geändert in`CreateDomain`), Service unterstützt jedoch OpenSearch weiterhin beide API-Versionen.
Wir empfehlen, dass Sie zukünftig die neuen API-Operationen verwenden, um Domains zu erstellen und zu verwalten. Beachten Sie, dass Sie bei Verwendung der neuen API-Operationen zum Erstellen einer Domain den `EngineVersion`-Parameter im Format `Elasticsearch_X.Y` oder `OpenSearch_X.Y` und nicht nur die Versionsnummer angeben müssen. Wenn Sie keine Version angeben, wird standardmäßig die neueste Version von verwendet. OpenSearch
Führen Sie ein Upgrade AWS CLI auf Version 1.20.40 oder höher durch, um Ihre Domains `aws opensearch ...` zu erstellen und zu verwalten. Das neue CLI-Format finden Sie in der [OpenSearch CLI-Referenz](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/opensearch/index.html).
## Umbenannte Instance-Typen
Instance-Typen in Amazon OpenSearch Service haben jetzt das Format `..search` —zum Beispiel, `m6g.large.search` statt`m6g.large.elasticsearch`. Sie müssen selbst keine Aktion durchführen. Vorhandene Domains werden automatisch auf die neuen Instance-Typen innerhalb der API und in der Fakturierungs- und Kostenmanagementkonsole verweisen.
Wenn Sie Reserved Instances (RIs) haben, ist Ihr Vertrag von der Änderung nicht betroffen. Die alte Konfigurations-API-Version ist weiterhin kompatibel mit dem alten Benennungsformat, aber wenn Sie die neue API-Version verwenden möchten, müssen Sie das neue Format verwenden.
## Änderungen der Zugriffsrichtlinie
In den folgenden Abschnitten wird beschrieben, welche Aktionen Sie ergreifen müssen, um Ihre Zugriffsrichtlinien zu aktualisieren.
### IAM-Richtlinien
Wir empfehlen, dass Sie Ihre [IAM-Richtlinien](ac.md), um die umbenannten API-Vorgänge zu verwenden. Der OpenSearch Service wird jedoch weiterhin die bestehenden Richtlinien respektieren, indem er die alten API-Berechtigungen intern repliziert. Wenn Sie beispielsweise derzeit über die Berechtigung zum Ausführen des `CreateElasticsearchDomain`-Vorgangs verfügen, können Sie jetzt sowohl `CreateElasticsearchDomain` (alte API-Operation) als auch `CreateDomain` (neue API-Operation) aufrufen. Dasselbe gilt für explizite Zugriffsverweigerungen. Eine Liste der aktualisierten API-Operationen finden Sie in der [Richtlinienelementverweis](ac.md#ac-reference).
### SCP-Richtlinien
[Richtlinien zur Dienstkontrolle (SCPs)](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scps.html) führen im Vergleich zu Standard-IAM zu einer zusätzlichen Komplexitätsebene. Um zu verhindern, dass Ihre SCP-Richtlinien verletzt werden, müssen Sie jeder Ihrer SCP-Richtlinien sowohl die alten *als auch* die neuen API-Operationen hinzufügen. Wenn ein Benutzer beispielsweise derzeit über Berechtigungen zum Zulassen von `CreateElasticsearchDomain` verfügt, müssen Sie ihm auch Berechtigungen zum Zulassen von `CreateDomain` erteilen, damit er weiterhin Domains beibehalten kann. Dasselbe gilt für explizite Zugriffsverweigerungen.
Zum Beispiel:
```
"Statement": [
{
"Effect": "Allow",
"Action": [
"es:CreateElasticsearchDomain",
"es:CreateDomain"
...
],
},
"Effect": "Deny",
"Action:" [
"es:DeleteElasticsearchDomain",
"es:DeleteDomain"
...
```
## Neue Ressourcentypen
OpenSearch Service führt die folgenden neuen Ressourcentypen ein:
| Ressource | Description |
| --- | --- |
| `AWS::OpenSearchService::Domain` | Stellt eine Amazon OpenSearch Service-Domain dar. Diese Ressource existiert auf Service-Ebene und ist nicht spezifisch für die Software, die in der Domain ausgeführt wird. Sie gilt für Dienste wie [CloudFormation](https://aws.amazon.com/cloudformation/)- und [AWS](https://docs.aws.amazon.com/ARG/latest/userguide/welcome.html)-Ressourcengruppen, in denen Sie Ressourcen für den Dienst als Ganzes erstellen und verwalten. Anweisungen zum Upgrade von Domains, die innerhalb CloudFormation von Elasticsearch auf definiert sind OpenSearch, finden Sie [in](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-opensearchservice-domain.html#aws-resource-opensearchservice-domain--remarks) den Hinweisen im CloudFormation Benutzerhandbuch. |
| `AWS::OpenSearch::Domain` | Stellt OpenSearch/Elasticsearch Software dar, die auf einer Domain läuft. Diese Ressource bezieht sich auf Dienste wie [AWS CloudTrail](https://aws.amazon.com/documentation/cloudtrail/)und [AWS Config](https://aws.amazon.com/config/), die auf die Software verweisen, die in der Domäne ausgeführt wird, und nicht auf OpenSearch Service als Ganzes. Diese Dienste enthalten jetzt separate Ressourcentypen für Domains, auf denen Elasticsearch (AWS::Elasticsearch::Domain) ausgeführt wird, und Domains, auf denen OpenSearch (AWS::OpenSearch::Domain) ausgeführt wird. |
**Anmerkung**
In [AWS Config](https://aws.amazon.com/config/)werden Sie Ihre Daten noch mehrere Wochen lang unter dem vorhandenen `AWS::Elasticsearch::Domain` Ressourcentyp sehen, auch wenn Sie ein Upgrade für eine oder mehrere Domains auf OpenSearch durchführen.
## Kibana wurde in Dashboards OpenSearch umbenannt
[OpenSearch Dashboards](dashboards.md), die AWS Alternative zu Kibana, ist ein Open-Source-Visualisierungstool, mit dem Sie arbeiten können. OpenSearch Nachdem Sie eine Domain von Elasticsearch auf aktualisiert haben OpenSearch, ändert sich der `/_plugin/kibana` Endpunkt auf. `/_dashboards` OpenSearch Der Service leitet alle Anfragen an den neuen Endpunkt weiter. Wenn Sie den Kibana-Endpunkt jedoch in einer Ihrer IAM-Richtlinien verwenden, aktualisieren Sie diese Richtlinien, sodass auch der neue `/_dashboards` Endpunkt enthalten ist.
Wenn Sie verwenden[SAML-Authentifizierung für Dashboards OpenSearch](saml.md), müssen Sie vor dem Upgrade Ihrer Domain auf OpenSearch alle in Ihrem Identity Provider (IdP) URLs konfigurierten Kibana von `/_plugin/kibana` auf ändern. `/_dashboards` Am gebräuchlichsten URLs sind Assertion Consumer Service (ACS) URLs und Recipient. URLs
Die `kibana_read_only` Standardrolle für OpenSearch Dashboards wurde umbenannt in`opensearch_dashboards_read_only`, und die `kibana_user` Rolle wurde umbenannt in. `opensearch_dashboards_user` Die Änderung gilt für alle *neu erstellten 1.* OpenSearch *X-Domänen*, auf denen die Service-Software R20211203 oder höher ausgeführt wird. Wenn Sie eine bereits vorhandene Domain auf die Service-Software R20211203 aktualisieren, bleiben die Rollennamen gleich.
## CloudWatch Metriken umbenannt
Für laufende Domains ändern sich mehrere CloudWatch Messwerte OpenSearch. Wenn Sie eine Domain auf aktualisieren OpenSearch, ändern sich die Messwerte automatisch und Ihre aktuellen CloudWatch Alarme werden unterbrochen. Bevor Sie Ihren Cluster von einer Elasticsearch-Version auf eine OpenSearch Version aktualisieren, stellen Sie sicher, dass Sie Ihre CloudWatch Alarme aktualisieren, um die neuen Metriken zu verwenden.
Die folgenden Metriken haben sich verändert:
| Ursprünglicher Metrikname | Neuer Name |
| --- | --- |
| `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` |
Eine vollständige Liste der Messwerte, die OpenSearch Service an Amazon sendet CloudWatch, finden Sie unter[Überwachung von OpenSearch Cluster-Metriken mit Amazon CloudWatch](managedomains-cloudwatchmetrics.md).
## Änderungen Fakturierung und Kostenmanagement
Historische Daten in der [Billing and Cost Management-Konsole](https://console.aws.amazon.com/billing/home) und in [Kosten- und Nutzungsberichten](https://aws.amazon.com/aws-cost-management/aws-cost-and-usage-reporting/) verwenden weiterhin den alten Servicenamen. Daher müssen Sie bei der Suche nach Daten Filter sowohl für **Amazon OpenSearch Service** als auch für den alten Elasticsearch-Namen verwenden. Wenn Sie bereits über gespeicherte Berichte verfügen, aktualisieren Sie die Filter, um sicherzustellen, dass sie auch OpenSearch Service enthalten. Möglicherweise erhalten Sie zunächst eine Warnung, wenn Ihre Nutzung für Elasticsearch abnimmt und weiter zunimmt OpenSearch, aber sie verschwindet innerhalb weniger Tage.
Zusätzlich zum Service-Namen ändern sich die folgenden Felder für alle Berichte, Rechnungen und Preislisten-API-Vorgänge:
| Feld | Altes Format | Neues Format |
| --- | --- | --- |
| Instance-Typ | `m5.large.elasticsearch` | `m5.large.search` |
| Produktfamilie | Elasticsearch-Instance Elasticsearch-Volume | Amazon OpenSearch Service-Instanz OpenSearch Amazon-Servicevolumen |
| Preisbeschreibung | 5,098\$1 pro c5.18xlarge.elasticsearch-Instance-Stunde (oder Teilstunde) - EU | 5,098\$1 pro c5.18xlarge.search-Instance-Stunde (oder Teilstunde) - EU |
| Instance-Familie | `ultrawarm.elasticsearch` | `ultrawarm.search` |
## Neues Ereignisformat
Das Format der Ereignisse, die OpenSearch Service an Amazon EventBridge und Amazon sendet, CloudWatch hat sich geändert, insbesondere das `detail-type` Feld. Das Quellfeld (`aws.es`) bleibt gleich. Das vollständige Format für jeden Ereignistyp finden Sie unter [Überwachung von OpenSearch Service-Ereignissen mit Amazon EventBridge](monitoring-events.md). Wenn Sie über vorhandene Ereignisregeln verfügen, die vom alten Format abhängen, stellen Sie sicher, dass sie dem neuen Format entsprechen.
## Was bleibt gleich?
Die folgenden Funktionen und Funktionalitäten, unter anderem nicht aufgeführt, bleiben gleich:
+ Dienstauftraggeber (`es.amazonaws.com`)
+ Anbieter-Code
+ Domäne ARNs
+ Domains-Endpunkte
## Erste Schritte: Aktualisieren Sie Ihre Domains auf OpenSearch 1.x
OpenSearch 1. *x* unterstützt Upgrades von den Elasticsearch-Versionen 6.8 und 7. *x.* Anweisungen zum Upgrade Ihrer Domain finden Sie unter [Eine Domain aktualisieren (Konsole)](starting-upgrades.md). Wenn Sie die Konfigurations-API AWS CLI oder verwenden, um Ihre Domain zu aktualisieren, müssen Sie das `TargetVersion` als angeben`OpenSearch_1.x`.
OpenSearch 1. *x* führt eine zusätzliche Domäneneinstellung namens **Kompatibilitätsmodus aktivieren** ein. Da bestimmte Elasticsearch OSS-Clients und -Plugins die Cluster-Version überprüfen, bevor sie eine Verbindung herstellen, wird OpenSearch im Kompatibilitätsmodus die Version 7.10 gemeldet, sodass diese Clients weiterhin funktionieren.
Sie können den Kompatibilitätsmodus aktivieren, wenn Sie OpenSearch Domains zum ersten Mal erstellen oder wenn Sie ein Upgrade auf OpenSearch eine Elasticsearch-Version durchführen. Wenn er nicht gesetzt ist, wird der Parameter standardmäßig auf `false` gesetzt, wenn Sie eine Domain erstellen, und auf `true` wenn Sie eine Domain aktualisieren.
Um den Kompatibilitätsmodus mit der [Konfigurations-API](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_UpgradeDomain.html) zu aktivieren, setzen Sie `override_main_response_version` auf `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"
}
}
```
Um den Kompatibilitätsmodus für *bestehende* OpenSearch Domains zu aktivieren oder zu deaktivieren, müssen Sie die API-Operation OpenSearch [\$1cluster/settings](https://docs.opensearch.org/latest/opensearch/rest-api/cluster-settings/) verwenden:
```
PUT /_cluster/settings
{
"persistent" : {
"compatibility.override_main_response_version" : true
}
}
```