

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.

# Aktualisierung einer Domain (CLI)

Sie können die folgenden Operationen verwenden, um die richtige Version von zu identifizieren OpenSearch oder Elasticsearch für Ihre Domain, starten Sie ein direktes oder klonbasiertes Upgrade, führen Sie die Überprüfung vor dem Upgrade durch und sehen Sie sich den Fortschritt an:
+ `get-compatible-versions` (`GetCompatibleVersions`)
+ `upgrade-domain` (`UpgradeDomain`)
+ `get-upgrade-status` (`GetUpgradeStatus`)
+ `get-upgrade-history` (`GetUpgradeHistory`)
+ `describe-domain-change-progress` (`DescribeDomainChangeProgress`) — Überwacht ein klonbasiertes Upgrade.
+ `update-clone` (`UpdateClone`) — Leitet den Lesetraffic auf den geklonten Cluster um, unterbricht und verwaltet den Aufbewahrungszeitraum für ein Clone-basiertes Upgrade.

## In-place aufrüsten
<a name="cli-in-place"></a>

Um zu überprüfen, ob Ihre Domain berechtigt ist, ohne ein Upgrade zu starten, verwenden Sie den `--perform-check-only` Option:

```sh
aws opensearch upgrade-domain \
  --domain-name my-domain \
  --target-version OpenSearch_2.19 \
  --perform-check-only
```

Um das Upgrade zu starten, führen Sie denselben Befehl ohne `--perform-check-only`:

```sh
aws opensearch upgrade-domain \
  --domain-name my-domain \
  --target-version OpenSearch_2.19
```

Um den Fortschritt anzuzeigen, verwenden Sie `get-upgrade-status`:

```sh
aws opensearch get-upgrade-status --domain-name my-domain
```

## Clone-based aufrüsten
<a name="cli-clone-based"></a>

Ein klonbasiertes Upgrade umfasst mehr Schritte als ein direktes Upgrade. Informationen zu den einzelnen Schritten finden Sie unter [Validierung, Umstellung und Rollback während eines klonbasierten Upgrades](clone-based-upgrade.md).

### Starten Sie das Upgrade
<a name="cli-clone-start"></a>

Um ein klonbasiertes Upgrade zu starten, führen Sie Folgendes aus `upgrade-domain` mit `DeploymentStrategy` gesetzt auf `ClonedBlueGreen` in `--deployment-strategy-options`. Die Aufbewahrungsfrist ist optional. Das Maximum beträgt 336 Stunden (14 Tage). Um einen längeren Zeitraum anzufordern, wenden Sie sich an [AWS Unterstützung](https://aws.amazon.com/premiumsupport/).

```sh
aws opensearch upgrade-domain \
  --domain-name my-domain \
  --target-version OpenSearch_3.1 \
  --deployment-strategy-options 'DeploymentStrategy=ClonedBlueGreen,ClonedBlueGreenOptions={RetentionOptions={RetentionInHours=48}}'
```

Die Antwort beinhaltet eine `ChangeId`. Verwenden Sie es, um das Upgrade zu überwachen:

```sh
aws opensearch describe-domain-change-progress \
  --domain-name my-domain \
  --change-id 9f1c2b7a-4d3e-4e21-9a5f-0c8b7d6e5f40
```

Wann der `ConfigChangeStatus` ist `PendingUserInput`, der geklonte Cluster ist bereit für Sie zur Validierung.

### Leiten Sie den Leseverkehr auf den geklonten Cluster um
<a name="cli-clone-traffic"></a>

`CloneReadTrafficPercent` ist der Anteil der Leseanforderungen, die an den geklonten Cluster gehen, von 0 bis 100. Schreibvorgänge werden immer an den primären Cluster gesendet.

```sh
aws opensearch update-clone \
  --domain-name my-domain \
  --traffic-split-options Strategy=ShiftReadTrafficPercent,CloneReadTrafficPercent=10
```

### Wechseln Sie zum geklonten Cluster
<a name="cli-clone-cutover"></a>

Setzen Sie `Target` auf `ClonedCluster`.

```sh
aws opensearch update-clone \
  --domain-name my-domain \
  --cutover-options Target=ClonedCluster
```

### Brechen Sie das Upgrade vor der Umstellung ab
<a name="cli-clone-cancel"></a>

Einstellen `Target` zu `PrimaryCluster`. OpenSearch Der Service löscht den geklonten Cluster und Ihre Domain bleibt unverändert.

```sh
aws opensearch update-clone \
  --domain-name my-domain \
  --cutover-options Target=PrimaryCluster
```

### Legen Sie den Aufbewahrungszeitraum fest oder ändern Sie ihn
<a name="cli-clone-retention"></a>

Sie können den Aufbewahrungszeitraum vor oder nach der Umstellung festlegen oder ändern.

```sh
aws opensearch update-clone \
  --domain-name my-domain \
  --retention-options RetentionInHours=24
```

### Beenden Sie die Aufbewahrungsfrist vorzeitig
<a name="cli-clone-end-retention"></a>

Nach der Umstellung können Sie zum primären Cluster zurückkehren oder den primären Cluster jetzt löschen.

```sh
aws opensearch update-clone \
  --domain-name my-domain \
  --retention-options '{"RetentionAction":"RollbackToPrimaryCluster"}'
```

```sh
aws opensearch update-clone \
  --domain-name my-domain \
  --retention-options '{"RetentionAction":"DeletePrimaryCluster"}'
```

Weitere Informationen finden Sie in der [AWS CLI-Befehlsreferenz](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/opensearch/index.html) und [Amazon OpenSearch Referenz zur Service-API](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/Welcome.html).