

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Mise à niveau d'un domaine (CLI)

Vous pouvez utiliser les opérations suivantes pour identifier la version correcte de OpenSearch ou Elasticsearch pour votre domaine, lancez une mise à niveau sur place ou basée sur un clone, effectuez la vérification préalable à la mise à niveau et consultez la progression :
+ `get-compatible-versions` (`GetCompatibleVersions`)
+ `upgrade-domain` (`UpgradeDomain`)
+ `get-upgrade-status` (`GetUpgradeStatus`)
+ `get-upgrade-history` (`GetUpgradeHistory`)
+ `describe-domain-change-progress` (`DescribeDomainChangeProgress`) — Surveille une mise à niveau basée sur un clone.
+ `update-clone` (`UpdateClone`) — Déplace le trafic de lecture vers le cluster cloné, interrompt, annule et gère la période de rétention pour une mise à niveau basée sur un clone.

## In-place mettre à niveau
<a name="cli-in-place"></a>

Pour vérifier si votre domaine est éligible sans démarrer de mise à niveau, utilisez le `--perform-check-only` option :

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

Pour démarrer la mise à niveau, exécutez la même commande sans `--perform-check-only`:

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

Pour voir la progression, utilisez `get-upgrade-status`:

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

## Clone-based mettre à niveau
<a name="cli-clone-based"></a>

Une mise à niveau basée sur un clone comporte plus d'étapes qu'une mise à niveau sur place. Pour plus d'informations sur chaque étape, voir [Validation, découpage et restauration lors d'une mise à niveau basée sur un clone](clone-based-upgrade.md).

### Démarrez la mise à niveau
<a name="cli-clone-start"></a>

Pour démarrer une mise à niveau basée sur un clone, exécutez `upgrade-domain` avec `DeploymentStrategy` réglé sur `ClonedBlueGreen` dans `--deployment-strategy-options`. La durée de conservation est facultative. Le maximum est de 336 heures (14 jours). Pour demander une période plus longue, contactez [AWS soutien](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}}'
```

La réponse comprend un `ChangeId`. Utilisez-le pour surveiller la mise à niveau :

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

Quand le `ConfigChangeStatus` est `PendingUserInput`, le cluster cloné est prêt à être validé.

### Déplacer le trafic de lecture vers le cluster cloné
<a name="cli-clone-traffic"></a>

`CloneReadTrafficPercent` est la part des requêtes de lecture envoyées au cluster cloné, comprise entre 0 et 100. Les écritures sont toujours dirigées vers le cluster principal.

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

### Passer au cluster cloné
<a name="cli-clone-cutover"></a>

Définissez `Target` sur `ClonedCluster`.

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

### Annuler la mise à niveau avant la mise en service
<a name="cli-clone-cancel"></a>

Set `Target` pour `PrimaryCluster`. OpenSearch Le service supprime le cluster cloné et votre domaine reste tel quel.

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

### Définir ou modifier la période de conservation
<a name="cli-clone-retention"></a>

Vous pouvez définir ou modifier la période de conservation avant ou après la coupure.

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

### Fin anticipée de la période de conservation
<a name="cli-clone-end-retention"></a>

Après le basculement, vous pouvez revenir au cluster principal ou supprimer le cluster principal dès maintenant.

```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"}'
```

Pour plus d'informations, consultez le [AWS Référence des commandes CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/opensearch/index.html) et [Amazon OpenSearch Référence de l'API de service](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/Welcome.html).