

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Actualización de un dominio (CLI)

Puede utilizar las siguientes operaciones para identificar la versión correcta de OpenSearch o Elasticsearch para tu dominio, inicia una actualización local o basada en clones, realiza la comprobación previa a la actualización y consulta el progreso:
+ `get-compatible-versions` (`GetCompatibleVersions`)
+ `upgrade-domain` (`UpgradeDomain`)
+ `get-upgrade-status` (`GetUpgradeStatus`)
+ `get-upgrade-history` (`GetUpgradeHistory`)
+ `describe-domain-change-progress` (`DescribeDomainChangeProgress`) — Supervisa una actualización basada en clones.
+ `update-clone` (`UpdateClone`) — Transfiere el tráfico de lectura al clúster clonado, interrumpe, cancela y administra el período de retención de una actualización basada en la clonación.

## In-place mejorar
<a name="cli-in-place"></a>

Para comprobar si tu dominio cumple los requisitos sin iniciar una actualización, usa `--perform-check-only` opción:

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

Para iniciar la actualización, ejecute el mismo comando sin `--perform-check-only`:

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

Para ver el progreso, usa `get-upgrade-status`:

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

## Clone-based mejorar
<a name="cli-clone-based"></a>

Una actualización basada en clones tiene más pasos que una actualización local. Para obtener información sobre cada paso, consulte [Validar, cortar y deshacer durante una actualización basada en clones](clone-based-upgrade.md).

### Inicie la actualización
<a name="cli-clone-start"></a>

Para iniciar una actualización basada en clones, ejecute `upgrade-domain` con `DeploymentStrategy` establecido en `ClonedBlueGreen` en `--deployment-strategy-options`. El período de retención es opcional. El máximo es de 336 horas (14 días). Para solicitar un período más largo, póngase en contacto con [AWS Soporte](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 respuesta incluye un `ChangeId`. Úselo para supervisar la actualización:

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

Cuando el `ConfigChangeStatus` es `PendingUserInput`, el clúster clonado está listo para que lo valides.

### Cambie el tráfico de lectura al clúster clonado
<a name="cli-clone-traffic"></a>

`CloneReadTrafficPercent` es el porcentaje de solicitudes de lectura que van al clúster clonado, de 0 a 100. Las escrituras siempre van al clúster principal.

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

### Diríjase al clúster clonado
<a name="cli-clone-cutover"></a>

Establece `Target` en `ClonedCluster`.

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

### Cancele la actualización antes de la transición
<a name="cli-clone-cancel"></a>

Establecer `Target` a `PrimaryCluster`. OpenSearch El servicio elimina el clúster clonado y su dominio permanece como estaba.

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

### Establece o cambia el período de retención
<a name="cli-clone-retention"></a>

Puedes establecer o cambiar el período de retención antes o después de la transición.

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

### Finalice el período de retención antes de tiempo
<a name="cli-clone-end-retention"></a>

Tras la transición, puede volver al clúster principal o eliminarlo ahora.

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

Para obtener más información, consulte [AWS Referencia de comandos de la CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/opensearch/index.html) y [Amazon OpenSearch Referencia de API de servicio](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/Welcome.html).