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. # Servicesoftwareupdates in Amazon OpenSearch Service **Anmerkung** Erläuterungen zu den Änderungen und Ergänzungen, die in den einzelnen *wichtigen* Service-Software-Updates (ohne Patch) vorgenommen wurden, finden Sie in den [Versionshinweisen](release-notes.md). Amazon OpenSearch Service veröffentlicht regelmäßig Service-Software-Updates, die Funktionen hinzufügen oder Ihre Domains auf andere Weise verbessern. Das Feld **Notifications** (Benachrichtigungen) in der Konsole ist der einfachste Weg, um festzustellen, ob ein Update verfügbar ist oder um den Status eines Updates zu überprüfen. Jede Benachrichtigung enthält Details zum Service-Software-Update. Alle Service-Software-Updates verwenden blaue/grüne Bereitstellungen, um Ausfallzeiten zu minimieren. Service-Softwareupdates unterscheiden sich von OpenSearch *Service-Versions-Upgrades*. Informationen zum Upgrade auf eine neuere Version von OpenSearch Service finden Sie unter[Upgrade von Amazon OpenSearch Service-Domains](version-migration.md). OpenSearch Für den Service müssen Sie die erforderlichen Servicesoftwareupdates innerhalb von 30 Tagen nach ihrer Verfügbarkeit installieren. Diese Updates sind für die Einhaltung der Sicherheitsbestimmungen von entscheidender Bedeutung. Wenn Sie die erforderlichen Updates nicht innerhalb der Frist von 30 Tagen installieren, erhalten Sie 30 Tage lang alle 15 Tage eine Erinnerungsbenachrichtigung. Nach Ablauf dieses Zeitraums ohne Einhaltung der Vorschriften wird Ihre Domain isoliert, was folgende Auswirkungen hat: + Der gesamte Netzwerkzugriff auf Ihre Domain wird entfernt + Der Domänenstatus ändert sich zu „**isoliert**“ + Die Domain bleibt unbrauchbar, bis Sie die erforderlichen Updates installiert haben Während der Isolierung erhalten Sie 60 Tage lang weiterhin alle 15 Tage Erinnerungsbenachrichtigungen. Wenn Sie die erforderlichen Updates nicht innerhalb dieses Zeitraums installieren, werden Ihre OpenSearch Service-Domain und alle zugehörigen Daten dauerhaft gelöscht. Weitere Informationen finden Sie unter [Behebung von Validierungsfehlern](managedomains-configuration-changes.md#validation). ## Optionale Updates im Vergleich zu erforderlichen Updates OpenSearch Der Service umfasst zwei große Kategorien von Service-Softwareupdates: ### Optionale Updates Optionale Service-Softwareupdates beinhalten in der Regel Verbesserungen und Unterstützung für neue Features oder Funktionen. Optionale Updates werden in Ihren Domänen nicht durchgesetzt, und es gibt keine feste Frist für deren Installation. Die Verfügbarkeit des Updates wird per E-Mail und Konsolenbenachrichtigung mitgeteilt. Sie können wählen, ob Sie das Update sofort anwenden oder es für ein geeigneteres Datum und eine geeignetere Uhrzeit verschieben möchten. Sie können es auch [außerhalb der Spitzenzeiten](off-peak.md) der Domain planen. Die meisten Softwareupdates sind optional. Unabhängig davon, ob Sie ein Update planen oder nicht, aktualisiert Service Ihre OpenSearch Servicesoftware automatisch für Sie, wenn Sie eine Änderung an der Domäne vornehmen, die zu einer [blauen/grünen Bereitstellung](managedomains-configuration-changes.md) führt. Sie können Ihre Domain so konfigurieren, dass optionale Updates [außerhalb der Spitzenzeiten](off-peak.md) automatisch angewendet werden. Wenn diese Option aktiviert ist, wartet der OpenSearch Service mindestens 13 Tage ab dem Zeitpunkt, an dem ein optionales Update verfügbar ist, und plant das Update dann nach sieben Tagen. Sie erhalten eine Konsolenbenachrichtigung, wenn das Update geplant ist, und Sie können wählen, ob Sie es auf einen späteren Zeitpunkt verschieben möchten. Um automatische Softwareupdates zu aktivieren, wählen Sie **Automatisches Softwareupdate aktivieren**, wenn Sie Ihre Domain erstellen oder aktualisieren. Um dieselbe Einstellung mit dem `--software-update-options` zu konfigurieren AWS CLI, legen Sie `true` bei der Erstellung oder Aktualisierung Ihrer Domain fest. ### Erforderliche Updates Zu den erforderlichen Service-Softwareupdates gehören in der Regel wichtige Sicherheitsupdates oder andere obligatorische Updates, um die kontinuierliche Integrität und Funktionalität Ihrer Domain zu gewährleisten. Beispiele für erforderliche Updates sind Log4j Common Vulnerabilities and Exposures (CVEs) und die Durchsetzung von Instance Metadata Service Version 2 (). IMDSv2 Die Anzahl der obligatorischen Updates pro Jahr beträgt in der Regel weniger als drei. OpenSearch Der Service plant diese Updates automatisch und benachrichtigt Sie sieben Tage vor dem geplanten Update per E-Mail und Konsolenbenachrichtigung. Sie können wählen, ob Sie das Update sofort anwenden oder es für ein geeigneteres Datum und eine geeignetere Uhrzeit *innerhalb des zulässigen Zeitrahmens* verschieben möchten. Sie können es auch während des nächsten Zeitfensters der Domain [außerhalb](off-peak.md) der Spitzenzeiten planen. Wenn Sie bei einem erforderlichen Update keine Maßnahmen ergreifen und keine Domainänderungen vornehmen, die zu einer blue/green Bereitstellung führen, kann der OpenSearch Service das Update jederzeit nach Ablauf der angegebenen Frist (in der Regel 14 Tage ab Verfügbarkeit) innerhalb der Nebenzeiten der Domain einleiten. Unabhängig davon, für welchen Zeitpunkt das Update geplant ist: Wenn Sie eine Änderung an der Domain vornehmen, die zu einer [blauen/grünen Bereitstellung](managedomains-configuration-changes.md) führt, aktualisiert der OpenSearch Service Ihre Domain automatisch für Sie. ## Patch-Updates Service-Softwareversionen, die auf „-P“ und einer Zahl wie R20211203- {{P4}} enden, sind Patch-Versionen. Patches werden vermutlich Leistungsverbesserungen, kleinere Bugfixes und Behebungen von Sicherheitslücken oder Verbesserungen der Sicherheitslage beinhalten. Patch-Versionen enthalten keine neuen Funktionen oder grundlegenden Änderungen und haben im Allgemeinen keine direkten oder spürbaren Auswirkungen auf die Benutzer. In der Benachrichtigung zur Service-Software erfahren Sie, ob eine Patch-Version optional oder obligatorisch ist. ## Überlegungen Beachten Sie beim Aktualisieren Ihrer Domain folgende Punkte: + Durch die manuelle Aktualisierung Ihrer Domain können Sie die Vorteile neuer Funktionen schneller nutzen. Wenn Sie **Update** wählen, stellt der OpenSearch Service die Anfrage in eine Warteschlange und startet das Update, sobald er Zeit hat. + Wenn Sie ein Service-Software-Update initiieren, sendet OpenSearch Service eine Benachrichtigung, wenn das Update gestartet und abgeschlossen ist. + Softwareupdates verwenden blue/green Bereitstellungen, um Ausfallzeiten zu minimieren. Aktualisierungen können die dedizierten Hauptknoten eines Clusters vorübergehend belasten. Stellen Sie daher sicher, dass ausreichende Kapazität für den zugeordneten Overhead beibehalten wird. + Aktualisierungen werden normalerweise innerhalb von Minuten abgeschlossen, können aber auch mehrere Stunden oder sogar Tage dauern, wenn Ihr System stark ausgelastet ist. Erwägen Sie, Ihre Domain während des konfigurierten [Zeitfensters außerhalb der Spitzenzeiten](off-peak.md) zu aktualisieren, um lange Aktualisierungszeiträume zu vermeiden. ## Starten eines Dienst-Softwareupdates Sie können ein Service-Software-Update über die OpenSearch Servicekonsole AWS CLI, die oder eine der folgenden anfordern SDKs. ### Konsole **Um ein Service-Software-Update anzufordern** 1. Öffnen Sie die Amazon OpenSearch Service-Konsole zu [https://console.aws.amazon.com/aos/Hause](https://console.aws.amazon.com/aos/home). 1. Wählen Sie den Domainnamen aus, um seine Konfiguration zu öffnen. 1. Wählen Sie **Aktionen**, **Update** und wählen Sie eine der folgenden Optionen: + **Update jetzt anwenden** — Plant sofort, dass die Aktion in der aktuellen Stunde ausgeführt wird, *sofern Kapazität verfügbar ist*. Wenn keine Kapazität verfügbar ist, bieten wir andere verfügbare Zeitfenster zur Auswahl an. + **Planen Sie es außerhalb der Spitzenzeiten** — Nur verfügbar, wenn das Zeitfenster außerhalb der Spitzenzeiten für die Domain aktiviert ist. Plant das Update so, dass es während des für die Domain konfigurierten Zeitfensters außerhalb der Spitzenzeiten stattfindet. Es gibt keine Garantie dafür, dass das Update innerhalb des nächsten unmittelbaren Zeitfensters erfolgt. Je nach Kapazität kann es in den folgenden Tagen passieren. Weitere Informationen finden Sie unter [Planung von Softwareupdates außerhalb der Spitzenzeiten](#service-software-offpeak). + **Zeitplan für ein bestimmtes Datum und eine bestimmte Uhrzeit** — Plant das Update so, dass es an einem bestimmten Datum und zu einer bestimmten Uhrzeit stattfindet. Wenn die von Ihnen angegebene Uhrzeit aus Kapazitätsgründen nicht verfügbar ist, können Sie ein anderes Zeitfenster auswählen. Wenn Sie das Update für einen späteren Zeitpunkt planen (innerhalb oder außerhalb des Randzeitfensters der Domain), können Sie es jederzeit verschieben. Detaillierte Anweisungen finden Sie unter [Aktionen neu planen](off-peak.md#off-peak-reschedule). 1. Wählen Sie **Bestätigen** aus. ### AWS CLI Senden Sie eine [start-service-software-update](https://docs.aws.amazon.com/cli/latest/reference/opensearch/start-service-software-update.html) AWS CLI Anfrage, um ein Service-Software-Update zu initiieren. In diesem Beispiel wird das Update sofort zur Warteschlange hinzugefügt: ``` aws opensearch start-service-software-update \ --domain-name {{my-domain}} \ --schedule-at "NOW" ``` **Antwort:** ``` { "ServiceSoftwareOptions": { "CurrentVersion": "R20220928-P1", "NewVersion": "R20220928-P2", "UpdateAvailable": true, "Cancellable": true, "UpdateStatus": "PENDING_UPDATE", "Description": "", "AutomatedUpdateDate": "1969-12-31T16:00:00-08:00", "OptionalDeployment": true } } ``` **Tipp** Nachdem Sie ein Update angefordert haben, haben Sie ein enges Zeitfenster, in dem Sie es stornieren können. Die Dauer dieses `PENDING_UPDATE` Status kann sehr unterschiedlich sein und hängt von Ihnen AWS-Region und der Anzahl der gleichzeitigen Updates ab, die der OpenSearch Service durchführt. Verwenden Sie die Konsole oder den `cancel-service-software-update` AWS CLI Befehl, um ein Update abzubrechen. Wenn die Anfrage mit einem fehlschlägt`BaseException`, bedeutet dies, dass die von Ihnen angegebene Zeit aus Kapazitätsgründen nicht verfügbar ist und Sie eine andere Uhrzeit angeben müssen. OpenSearch Der Service schlägt in der Antwort alternative verfügbare Zeitnischen vor. ### AWS SDKs Dieses Python-Beispielskript verwendet die Methoden [describe\_domain](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/opensearch.html#OpenSearchService.Client.describe_domain) und [start\_service\_software\_update](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/opensearch.html#OpenSearchService.Client.start_service_software_update) von, AWS SDK für Python (Boto3) um zu überprüfen, ob eine Domäne für ein Dienst-Softwareupdate in Frage kommt, und wenn ja, startet es das Update. Sie müssen einen Wert für `domain_name` angeben. ``` import boto3 from botocore.config import Config import time # Build the client using the default credential configuration. # You can use the CLI and run 'aws configure' to set access key, secret # key, and default region. my_config = Config( # Optionally lets you specify a Region other than your default. region_name='us-east-1' ) domain_name = '' # The name of the domain to check and update client = boto3.client('opensearch', config=my_config) def getUpdateStatus(client): """Determines whether the domain is eligible for an update""" response = client.describe_domain( DomainName=domain_name ) sso = response['DomainStatus']['ServiceSoftwareOptions'] if sso['UpdateStatus'] == 'ELIGIBLE': print('Domain [' + domain_name + '] is eligible for a service software update from version ' + sso['CurrentVersion'] + ' to version ' + sso['NewVersion']) updateDomain(client) else: print('Domain is not eligible for an update at this time.') def updateDomain(client): """Starts a service software update for the eligible domain""" response = client.start_service_software_update( DomainName=domain_name ) print('Updating domain [' + domain_name + '] to version ' + response['ServiceSoftwareOptions']['NewVersion'] + '...') waitForUpdate(client) def waitForUpdate(client): """Waits for the domain to finish updating""" response = client.describe_domain( DomainName=domain_name ) status = response['DomainStatus']['ServiceSoftwareOptions']['UpdateStatus'] if status == 'PENDING_UPDATE' or status == 'IN_PROGRESS': time.sleep(30) waitForUpdate(client) elif status == 'COMPLETED': print('Domain [' + domain_name + '] successfully updated to the latest software version') else: print('Domain is not currently being updated.') def main(): getUpdateStatus(client) ``` ## Planung von Softwareupdates außerhalb der Spitzenzeiten [Jede OpenSearch Service-Domain, die nach dem 16. Februar 2023 erstellt wurde, hat täglich ein 10-Stunden-Fenster zwischen 22:00 Uhr und 8:00 Uhr Ortszeit, das wir als das Zeitfenster außerhalb der Spitzenzeiten betrachten.](off-peak.md) OpenSearch Der Service verwendet dieses Fenster, um Service-Software-Updates für die Domain zu planen. Updates außerhalb der Spitzenzeiten tragen dazu bei, die Belastung der dedizierten Master-Knoten eines Clusters in Zeiten mit höherem Datenverkehr zu minimieren. OpenSearch Der Service kann ohne Ihre Zustimmung keine Updates außerhalb dieses 10-Stunden-Fensters initiieren. + Bei *optionalen* Updates informiert Sie der OpenSearch Service über die Verfügbarkeit des Updates und fordert Sie auf, das Update außerhalb der Hauptverkehrszeiten zu planen. + Bei *erforderlichen* Updates plant der OpenSearch Service das Update automatisch während eines bevorstehenden Zeitfensters außerhalb der Spitzenzeiten und benachrichtigt Sie drei Tage im Voraus. Sie können das Update verschieben (innerhalb oder außerhalb der Spitzenzeiten), jedoch nur innerhalb des Zeitrahmens, der für die Fertigstellung des Updates erforderlich ist. Für jede Domain können Sie festlegen, dass die standardmäßige Startzeit um 22:00 Uhr durch eine benutzerdefinierte Uhrzeit überschrieben wird. Detaillierte Anweisungen finden Sie unter [Konfiguration eines benutzerdefinierten Zeitfensters außerhalb der Spitzenzeiten](off-peak.md#off-peak-custom). ### Konsole **Um ein Update während eines bevorstehenden Zeitfensters außerhalb der Spitzenzeiten zu planen** 1. Öffnen Sie die Amazon OpenSearch Service-Konsole zu [https://console.aws.amazon.com/aos/Hause](https://console.aws.amazon.com/aos/home ). 1. Wählen Sie den Domainnamen aus, um seine Konfiguration zu öffnen. 1. Wählen Sie **Aktionen**, **Aktualisieren**. 1. Wählen Sie **außerhalb der Spitzenzeiten planen aus.** 1. Wählen Sie **Bestätigen** aus. Sie können die geplante Aktion auf der Registerkarte „**Fenster außerhalb der Spitzenzeiten**“ einsehen und sie jederzeit neu planen. Siehe [Geplante Aktionen anzeigen](off-peak.md#off-peak-view). ### CLI Um ein Update während eines bevorstehenden Zeitfensters außerhalb der Spitzenzeiten zu planen AWS CLI, senden Sie eine [StartServiceSoftwareUpdate](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_StartServiceSoftwareUpdate.html)Anfrage und geben Sie `OFF_PEAK_WINDOW` für den Parameter Folgendes an: `--schedule-at` ``` aws opensearch start-service-software-update \ --domain-name {{my-domain}} \ --schedule-at "OFF_PEAK_WINDOW" ``` ## Softwareupdates des Überwachungsdienstes OpenSearch Der Dienst sendet eine [Benachrichtigung](managedomains-notifications.md), wenn ein Dienst-Softwareupdate verfügbar, erforderlich, gestartet, abgeschlossen oder fehlgeschlagen ist. Sie können diese Benachrichtigungen im Bereich **Benachrichtigungen** der OpenSearch Servicekonsole einsehen. Der Schweregrad der Benachrichtigung ist`Informational`, wenn das Update optional ist und`High` wenn es erforderlich ist. OpenSearch Der Service sendet auch Service-Software-Ereignisse an Amazon EventBridge. Sie können Regeln konfigurieren EventBridge , die beim Empfang eines Ereignisses eine E-Mail senden oder eine bestimmte Aktion ausführen. Ein Beispiel für eine exemplarische Vorgehensweise finden Sie unter[Tutorial: Senden von Amazon-SNS-Warnungen für verfügbare Softwareupdates](sns-events.md). Informationen zum Format der einzelnen Service-Software-Ereignisse, die an Amazon gesendet wurden EventBridge, finden Sie unter[Aktualisieren der Software](monitoring-events.md#monitoring-events-sso). ## Wenn Domains nicht für ein Update in Frage kommen Ihre Domain ist für ein Service-Software-Update nicht berechtigt, wenn sie sich in einem der folgenden Zustände befindet: | Status | Description | | --- | --- | | Domain in Verarbeitung | Die Domain befindet sich in der Mitte einer Konfigurationsänderung. Überprüfen Sie die Update-Berechtigung, nachdem die Operation abgeschlossen ist. | | Roter Cluster-Status | Ein oder mehrere Indizes im Cluster sind rot. Fehlerbehandlungsschritte finden Sie unter [Roter Cluster-Status](handling-errors.md#handling-errors-red-cluster-status). | | Hohe Fehlerrate | Beim Versuch, Anfragen zu verarbeiten, gibt der OpenSearch Cluster eine große Anzahl von 5 *xx-Fehlern* zurück. Dieses Problem ist in der Regel das Ergebnis zu vieler gleichzeitiger Lese- oder Schreibanforderungen. Erwägen Sie, den Datenverkehr zu dem Cluster zu reduzieren oder Ihre Domain zu skalieren. | | Split brain | *Split Brain* bedeutet, dass Ihr OpenSearch Cluster über mehr als einen Master-Knoten verfügt und sich in zwei Cluster aufgeteilt hat, die sich von selbst nie wieder verbinden werden. Sie können split brain vermeiden, indem Sie die empfohlene Anzahl der [dedizierten Hauptknoten](managedomains-dedicatedmasternodes.md) verwenden. Für Hilfe zur Wiederherstellung von split brain wenden Sie sich an [Support](https://console.aws.amazon.com/support/home). | | Problem mit der Amazon Cognito Integration | Ihre Domain verwendet die [Authentifizierung für OpenSearch Dashboards](cognito-auth.md), und OpenSearch Service kann eine oder mehrere Amazon Cognito Cognito-Ressourcen nicht finden. Dieses Problem tritt in der Regel auf, wenn der Amazon-Cognito-Benutzerpool fehlt. Um das Problem zu beheben, erstellen Sie die fehlende Ressource neu und konfigurieren Sie die OpenSearch Service-Domain so, dass sie sie verwendet. | | Andere -Service-Probleme | Probleme mit dem OpenSearch Service selbst können dazu führen, dass Ihre Domain als nicht aktualisierbar angezeigt wird. Wenn keine der vorangehenden Bedingungen für Ihre Domain gelten und das Problem mehr als einen Tag bestehen bleibt, wenden Sie sich bitte an [Support](https://console.aws.amazon.com/support/home). | ## Ein Servicesoftwareupdate rückgängig machen Amazon OpenSearch Service unterstützt das Rollback von Servicesoftwareupdates. Sie können ein Rollback über die OpenSearch Service-Konsole, die oder eine der AWS CLI AWS SDKs folgenden Optionen einleiten. Softwareupdates werden mithilfe einer blue/green Bereitstellung rückgängig gemacht. **Anmerkung** Rollback wird nur für Dienst-Softwareupdates unterstützt, die am oder nach dem 24. April 2026 angewendet wurden. Upgrades von Engine-Versionen können nicht rückgängig gemacht werden. ### Voraussetzungen für ein Rollback und Überlegungen Ihre Domain muss alle der folgenden Bedingungen erfüllen, damit ein Rollback verfügbar ist: + **Domain ist aktiv** — Die Domain muss sich in einem bestimmten `Active` Bundesstaat befinden. Rollback ist nicht verfügbar, während eine Konfigurationsänderung, ein Softwareupdate oder eine andere blue/green Bereitstellung ausgeführt wird. + **Innerhalb des Rollback-Zeitfensters** — Das Softwareupdate muss innerhalb des zulässigen Rollback-Zeitraums installiert worden sein. Siehe [Zeitfenster für Rollbacks](#service-software-rollback-windows). + **Keine Konfigurationsänderungen nach dem Update** — Wenn Sie nach der Installation des Softwareupdates eine Konfigurationsänderung an der Domäne vorgenommen haben, wird das Rollback blockiert. Konfigurationsänderungen können sich auf eine Weise auf die Domäneneinstellungen auswirken, die mit der vorherigen Softwareversion nicht kompatibel sind. Wenn Sie beispielsweise Instance-Typen ändern, Replikate aktivieren oder Speichereinstellungen nach einem Update anpassen, wird ein Rollback blockiert. + Das **Update wurde vom Service nicht automatisch installiert — Wenn Sie nicht innerhalb des** 30-tägigen Verfügbarkeitsfensters auf ein obligatorisches Update reagiert haben und der OpenSearch Service das Update automatisch installiert hat, ist ein Rollback für dieses Update nicht verfügbar. + **Das Update war kein Upgrade der Engine-Version — Änderungen an** der Engine-Version (z. B. ein Upgrade von OpenSearch 1.3 auf OpenSearch 2.11) sind irreversibel. Nur Rollbacks von Servicesoftwareversionen werden unterstützt. + Es ist **eine frühere Softwareversion vorhanden** — Rollback ist nur für Softwareupdates verfügbar, die installiert wurden, nachdem diese Funktion allgemein verfügbar (GA) wurde. Für Domänen, für die seit GA noch kein Softwareupdate durchgeführt wurde, gibt es keine frühere Version, auf die ein Rollback durchgeführt werden kann. + **Pro Update ist nur ein Rollback zulässig**. Sobald ein Rollback abgeschlossen ist, wird davon ausgegangen, dass sich die Domain in einem Rollback-Status befindet. Ein erneutes Rollback ist erst möglich, wenn ein neues Softwareupdate erfolgreich installiert wurde. + Das **Softwareupdate wurde explizit initiiert** — Ein Rollback ist nur verfügbar, wenn das Softwareupdate ausdrücklich von Ihnen initiiert oder vom OpenSearch Service automatisch als Teil eines obligatorischen oder optionalen Updates geplant wurde. Rollback ist nicht verfügbar, wenn: + Das Softwareupdate wurde während einer blue/green Bereitstellung angewendet, die durch eine Konfigurationsänderung ausgelöst wurde. Dies gilt auch für Fälle, in denen die `UseLatestServiceSoftwareForBlueGreen` Einstellung aktiviert ist, wodurch das neueste Softwareupdate mit Konfigurationsänderungen gebündelt wird. Sie haben die Möglichkeit, diese Einstellung zu deaktivieren. + Das Update wurde während eines vom Service initiierten Wartungsvorgangs an Ihrer Domain installiert, z. B. bei der Wiederherstellung der Infrastruktur, bei der automatischen Problembehebung oder bei anderen internen Vorgängen, die vom OpenSearch Service ausgeführt wurden, um den Zustand und die Verfügbarkeit Ihrer Domain aufrechtzuerhalten. ### Zeitfenster für Rollbacks Das Rollback-Fenster hängt von der Art des Softwareupdates ab, das angewendet wurde. | Art des Updates | Rollback-Fenster | Hinweise | | --- | --- | --- | | Optional | 15 Tage ab dem Datum, an dem das Update angewendet wurde | Gilt unabhängig davon, ob Sie das Update manuell, geplant oder außerhalb der Hauptverkehrszeiten automatisch installiert haben. | | zwingend erforderlich | 15 Tage ab dem Datum, an dem das Update installiert wurde | Nur verfügbar, wenn Sie das Update innerhalb des 30-tägigen Verfügbarkeitsfensters selbst installiert haben. Wenn der Dienst das Update nach Ablauf der Frist automatisch angewendet hat, ist ein Rollback nicht verfügbar. | Nach Ablauf des Rollback-Fensters ist Self-Service-Rollback nicht mehr verfügbar. Wenden Sie sich an, [Support](https://console.aws.amazon.com/support/home)wenn nach dem Schließen des Fensters ein kritisches Problem auftritt. ### Wie fordere ich einen Rollback an Sie können ein Rollback über die `RollbackServiceSoftwareUpdate` API anfordern. #### Anforderung ``` POST /2021-01-01/opensearch/serviceSoftwareUpdate/rollback ``` Hauptteil der Anfrage: ``` { "DomainName": "{{your-domain-name}}" } ``` #### Antwort Die API gibt in allen Fällen, in denen es sich nicht um Fehler handelt, eine HTTP 200-Antwort zurück. Das `RollbackAvailable` Feld im Antworttext gibt an, ob das Rollback initiiert wurde. ``` { "RollbackServiceSoftwareOptions": { "CurrentVersion": "string", "NewVersion": "string", "RollbackAvailable": boolean, "Description": "string" } } ``` Antwortfelder: | Feld | Typ | Description | | --- | --- | --- | | CurrentVersion | Zeichenfolge | Die Softwareversion, die derzeit auf der Domain läuft. | | NewVersion | Zeichenfolge | Die Softwareversion, auf die die Domain zurückgesetzt wird. Gibt Null zurück, wenn ein Rollback nicht verfügbar ist. | | RollbackAvailable | Boolesch | `true`wenn das Rollback erfolgreich initiiert wurde. `false`wenn die Domain nicht für ein Rollback in Frage kommt. | | Description | Zeichenfolge | Eine menschenlesbare Nachricht, die das Ergebnis oder den Grund beschreibt, warum ein Rollback nicht verfügbar ist. | #### Fehlermeldungen | Fehler | Description | | --- | --- | | ResourceNotFoundException | Die angegebene Domäne ist nicht vorhanden. | | ValidationException | Die Domäne befindet sich nicht in einem aktiven Zustand. Warten Sie, bis alle laufenden Änderungen abgeschlossen sind, bevor Sie es erneut versuchen. | | InternalException | Beim Service trat ein interner Fehler auf. Wiederholen Sie die Anforderung. | | DisabledOperationException | Der Rollback-Vorgang wird für diese Domain nicht unterstützt. | #### Antwortnachrichten In der folgenden Tabelle werden die möglichen Antwortnachrichten beschrieben, die von der `RollbackServiceSoftwareUpdate` API zurückgegeben werden. | Case | Description | | --- | --- | | Herzlichen Glückwunsch | Das Rollback wurde erfolgreich initiiert. Für die Domain wird ein Rollback von {{current-version}} bis {{previous-version}} durchgeführt. | | Funktion nicht aktiviert | Rollback ist nicht verfügbar. Kontaktieren Sie uns [Support](https://console.aws.amazon.com/support/home)für Unterstützung. | | Frühere Software nicht verfügbar | Keine frühere Softwareversion für ein Rollback verfügbar. Wenden Sie sich an, [Support](https://console.aws.amazon.com/support/home)wenn Sie Hilfe benötigen | | Die vorherige Software ist dieselbe wie die aktuelle | Rollback ist nicht verfügbar. Für ein Rollback ist keine frühere Softwareversion verfügbar. Wenden Sie sich an, [Support](https://console.aws.amazon.com/support/home)wenn Sie Hilfe benötigen | | Die Domain wurde bereits zurückgesetzt | Die Domain befindet sich bereits in einem Rollback-Status. | | Der Cluster befindet sich in der angehefteten Softwareversion | Die Softwareüberschreibung wird derzeit auf die Domäne angewendet. | | Außerhalb des Zeitfensters | Rollback ist nicht verfügbar. Das 15-tägige Rollback-Fenster ist abgelaufen. Wenden Sie sich an, wenn Sie [Support](https://console.aws.amazon.com/support/home)Hilfe benötigen | | Obligatorisches Service-Update wird automatisch angewendet | Rollback ist nicht verfügbar. Die aktuelle Version wurde durch ein obligatorisches Service-Update installiert. Wenden Sie sich [Support](https://console.aws.amazon.com/support/home)für Unterstützung an. | | Aktualisierung der Engine-Version | Rollback ist nicht verfügbar. Upgrades der Engine-Version sind irreversibel. Kontaktieren Sie uns [Support](https://console.aws.amazon.com/support/home)für Unterstützung. | | Die Konfiguration wurde nach dem Update geändert | Rollback ist nicht verfügbar. Die Clusterkonfiguration hat sich seit dem letzten Softwareupdate geändert. Wenden Sie sich [Support](https://console.aws.amazon.com/support/home)für Unterstützung an. | **Beispiel für eine Antwort:** ``` { "RollbackServiceSoftwareOptions": { "CurrentVersion": "OpenSearch_2_11_R20240115", "NewVersion": "OpenSearch_2_11_R20231023", "RollbackAvailable": true, "Description": "Rollback initiated successfully. The domain will be rolled back from OpenSearch_2_11_R20240115 to OpenSearch_2_11_R20231023." } } ``` Wenn ein Rollback nicht verfügbar ist, wird `RollbackAvailable` zurückgegeben `false` und das `Description` Feld enthält den Grund aus der obigen Tabelle.