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 Analyse-Suite in Amazon OpenSearch Service umbenannt. OpenSearch Service unterstützt OpenSearch genauso wie Legacy-System-Elasticsearch-OSS. 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 Domänen von Elasticsearch auf OpenSearch aktualisieren. 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-Konfigurations-API (2021-01-01) funktioniert sowohl mit Legacy-System-Elasticsearch-OSS OpenSearch als auch mit Legacy-System-Elasticsearch-OSS. 21 API-Operationen wurden durch prägnantere und Engine-agnostische Namen ersetzt (z. B. CreateElasticsearchDomain geändert inCreateDomain), aber OpenSearch Service unterstützt 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 OpenSearch verwendet.

Aktualisieren Sie AWS CLI auf Version 1.20.40 oder höher, um Ihre Domains aws opensearch ... zu erstellen und zu verwalten. Informationen zum neuen CLI-Format finden Sie in der OpenSearch CLI-Referenz.

Umbenannte Instance-Typen

Instance-Typen in Amazon OpenSearch Service haben jetzt das Format <type>.<size>.search —zum Beispiel m6g.large.search stattm6g.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.

Falls Sie über Reserved Instances (RIs) verfügen, wird Ihr Vertrag von der Änderung nicht beeinflusst. 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, um die umbenannten API-Vorgänge zu verwenden. OpenSearch Service wird jedoch weiterhin bestehende Richtlinien respektieren, indem es intern die alten API-Berechtigungen 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.

SCP-Richtlinien

Service-Kontroll-Richtlinien (SCPs) führen im Vergleich zu Standard-IAM eine zusätzliche Komplexitätsebene ein. 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:

Kibana wurde in Dashboards OpenSearch umbenannt

OpenSearch Dashboards, die AWS -Alternative zu Kibana, ist ein Open-Source-Visualisierungs-Tool, das für die Verwendung entwickelt wurde. OpenSearch Nachdem Sie eine Domain von Elasticsearch auf aktualisiert haben OpenSearch, ändert sich der /_plugin/kibana Endpunkt auf. /_dashboards OpenSearch Service leitet alle Anfragen an den neuen Endpunkt um. Wenn Sie jedoch den Kibana-Endpunkt in einer Ihrer IAM-Richtlinien verwenden, aktualisieren Sie diese Richtlinien, um auch den neuen /_dashboards Endpunkt einzuschließen.

Wenn Sie verwendenSAML-Authentifizierung für Dashboards OpenSearch , müssen Sie vor dem Upgrade Ihrer Domain auf OpenSearch alle in Ihrem Identitätsanbieter (IdP) URLs konfigurierten Kibana von /_plugin/kibana auf ändern. /_dashboards Die häufigsten URLs sind Assertion Consumer Service (ACS) URLs und Empfänger URLs.

Die kibana_read_only Standardrolle für OpenSearch Dashboards wurde umbenannt inopensearch_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 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.

Umbenannte CloudWatch Kennzahlen

Für laufende Domains ändern sich mehrere CloudWatch Metriken OpenSearch. Wenn Sie eine Domäne auf aktualisieren OpenSearch, ändern sich die Metriken automatisch und Ihre aktuellen CloudWatch Alarme werden unterbrochen. Bevor Sie Ihren Cluster von einer Elasticsearch-Version auf eine OpenSearch Version aktualisieren, müssen Sie Ihre CloudWatch Alarme aktualisieren, um die neuen Metriken zu verwenden.

Die folgenden Metriken haben sich verändert:

Eine vollständige Liste der Messwerte, die OpenSearch Service an Amazon sendet CloudWatch, finden Sie unterÜberwachung von OpenSearch Cluster-Metriken mit Amazon CloudWatch.

Änderungen Fakturierung und Kostenmanagement

Historische Daten in der Billing and Cost Management -Konsole und in Kosten- und Nutzungsberichten werden weiterhin den alten Service-Namen verwenden. Daher benötigen Sie bei der Suche nach Daten Filter sowohl für Amazon OpenSearch Service als auch für den alten Elasticsearch-Namen. Wenn Sie über gespeicherte Berichte verfügen, aktualisieren Sie die Filter, um sicherzustellen, dass sie auch den OpenSearch Service enthalten. Möglicherweise erhalten Sie zunächst eine Warnung, wenn Ihre Nutzung für Elasticsearch abnimmt und für zunimmt OpenSearch, diese verschwindet jedoch innerhalb weniger Tage.

Zusätzlich zum Service-Namen ändern sich die folgenden Felder für alle Berichte, Rechnungen und Preislisten-API-Vorgänge:

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. 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:

Erste Schritte: Aktualisieren Sie Ihre Domains auf OpenSearch 1.x

OpenSearch 1. x unterstützt Upgrades von Elasticsearch Version 6.8 und 7. x. Anweisungen zum Upgrade Ihrer Domain finden Sie unter Aktualisierung einer Domain (Konsole). Wenn Sie die AWS CLI oder Konfigurations-API zum Aktualisieren Ihrer Domäne verwenden, müssen Sie die TargetVersion As angebenOpenSearch_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 Clusterversion vor der Verbindung überprüfen, setzt OpenSearch der Kompatibilitätsmodus so ein, dass er dessen Version als 7.10 meldet, damit diese Clients weiterhin funktionieren.

Sie können den Kompatibilitätsmodus aktivieren, wenn Sie OpenSearch Domains zum ersten Mal erstellen oder wenn Sie OpenSearch von einer Elasticsearch-Version aktualisieren. 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 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 vorhandene OpenSearch Domänen zu aktivieren oder zu deaktivieren, müssen Sie die OpenSearch _cluster/settings API-Operation verwenden:

PUT /_cluster/settings
{
  "persistent" : {
    "compatibility.override_main_response_version" : true
  }
}