# Uso de la CLI de AWS
<a name="multi-region-aws-cli"></a>

La CLI de AWS proporciona una interfaz de línea de comandos para administrar los clústeres de Aurora DSQL multirregionales. Los siguientes ejemplos demuestran cómo crear, configurar y eliminar clústeres multirregionales.

## Conexión al clúster multirregional
<a name="connecting-multi-region-clusters"></a>

Los clústeres emparejados multirregionales proporcionan dos puntos de conexión regionales, uno en cada Región de AWS de clúster interconectado. Ambos puntos de conexión presentan una única base de datos lógica que admite operaciones de lectura y escritura simultáneas con una coherencia de datos sólida. Además de los clústeres emparejados, un clúster de varias regiones también tiene una región testigo que almacena una ventana limitada de registros de transacciones cifrados, que se utiliza para mejorar la durabilidad y la disponibilidad de varias regiones. Las regiones testigo de varias regiones no tienen puntos de conexión.

## Creación de clústeres multirregionales
<a name="creating-multi-region-clusters"></a>

Para crear clústeres de varias regiones, primero debe crear un clúster con una región testigo. A continuación, empareje este clúster con un segundo clúster que comparte la misma región testigo que el primer clúster. En el siguiente ejemplo se muestra cómo crear clústeres en Este de EE. UU. (Norte de Virginia) y Este de EE. UU. (Ohio) con Oeste de EE. UU. (Oregón) como región testigo. 

### Paso 1: creación del clúster 1 en Este de EE. UU. (Norte de Virginia)
<a name="create-first-cluster"></a>

Para crear un clúster en la Región de AWS Este de EE. UU. (Norte de Virginia) con propiedades multirregionales, utilice el siguiente comando. 

```
aws dsql create-cluster \
--region us-east-1 \
--multi-region-properties '{"witnessRegion":"us-west-2"}'
```

**Example Respuesta:**  

```
{
    "identifier": "abc0def1baz2quux3quuux4",
    "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/abc0def1baz2quux3quuux4",
    "status": "UPDATING",
    "encryptionDetails": {
        "encryptionType": "AWS_OWNED_KMS_KEY",
        "encryptionStatus": "ENABLED"
   }
   "creationTime": "2024-05-24T09:15:32.708000-07:00"
}
```

**nota**  
Cuando la operación de la API se realiza correctamente, el clúster cambia al estado `PENDING_SETUP`. La creación del clúster permanece en `PENDING_SETUP` hasta que actualice el clúster con el ARN del clúster emparejado.

### Paso 2: creación del clúster 2 en Este de EE. UU. (Ohio)
<a name="create-cluster-two"></a>

Para crear un clúster en la Región de AWS Este de EE. UU. (Ohio) con propiedades multirregionales, utilice el siguiente comando. 

```
aws dsql create-cluster \
--region us-east-2 \
--multi-region-properties '{"witnessRegion":"us-west-2"}'
```

**Example Respuesta:**  

```
{
    "identifier": "foo0bar1baz2quux3quuxquux5",
    "arn": "arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5",
    "status": "PENDING_SETUP",
    "creationTime": "2025-05-06T06:51:16.145000-07:00",
    "deletionProtectionEnabled": true,
    "multiRegionProperties": {
        "witnessRegion": "us-west-2",
        "clusters": [
            "arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5"
        ]
    }
}
```

Cuando la operación de la API se realiza correctamente, el clúster realiza la transición al estado `PENDING_SETUP`. La creación del clúster permanece en el estado `PENDING_SETUP` hasta que lo actualice con el ARN de otro clúster para el emparejamiento.

### Paso 3: emparejamiento del clúster en Este de EE. UU. (Norte de Virginia) con Este de EE. UU. (Ohio)
<a name="peer-cluster-east1"></a>

Para emparejar el clúster de Este de EE. UU. (Norte de Virginia) con el clúster de Este de EE. UU. (Ohio), utilice el comando `update-cluster`. Especifique el nombre del clúster del Este de EE. UU. (Norte de Virginia) y una cadena JSON con el ARN del clúster de Este de EE. UU. (Ohio). 

```
aws dsql update-cluster \
--region us-east-1 \
--identifier 'foo0bar1baz2quux3quuxquux4' \
--multi-region-properties '{"witnessRegion": "us-west-2","clusters": ["arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5"]}'
```

**Example Respuesta**  

```
{
    "identifier": "foo0bar1baz2quux3quuxquux4",
    "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4",
    "status": "UPDATING",
    "creationTime": "2025-05-06T06:46:10.745000-07:00"
}
```

### Paso 4: emparejamiento del clúster de Este de EE. UU. (Ohio) con el clúster de Este de EE. UU. (Norte de Virginia)
<a name="peer-cluster-east2"></a>

Para emparejar el clúster de Este de EE. UU. (Ohio) con el clúster de Este de EE. UU. (Norte de Virginia), utilice el comando `update-cluster`. Especifique el nombre del clúster Este de EE. UU. (Ohio) y una cadena JSON con el ARN del clúster Este de EE. UU. (Norte de Virginia).

**Example**  

```
aws dsql update-cluster \
--region us-east-2 \
--identifier 'foo0bar1baz2quux3quuxquux5' \
--multi-region-properties '{"witnessRegion": "us-west-2", "clusters": ["arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4"]}'
```

**Example Respuesta**  

```
{
    "identifier": "foo0bar1baz2quux3quuxquux5",
    "arn": "arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5",
    "status": "UPDATING",
    "creationTime": "2025-05-06T06:51:16.145000-07:00"
}
```

**nota**  
Tras un emparejamiento correcto, ambos clústeres pasan del estado “PENDING\_SETUP” al estado “CREATING” y, finalmente, al estado “ACTIVE” cuando están listos para utilizarse.

#### Visualización de propiedades de clústeres multirregionales
<a name="describe-cluster-multiregion"></a>

Al describir un clúster, puede ver las propiedades multirregionales de los clústeres en diferentes Regiones de AWS.

**Example**  

```
aws dsql get-cluster \
--region us-east-1 \
--identifier 'foo0bar1baz2quux3quuxquux4'
```

**Example Respuesta**  

```
{
    "identifier": "foo0bar1baz2quux3quuxquux4",
    "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4",
    "status": "PENDING_SETUP", 
    "encryptionDetails": {
    "encryptionType": "AWS_OWNED_KMS_KEY",
    "encryptionStatus": "ENABLED"
},
    "creationTime": "2024-11-27T00:32:14.434000-08:00",
    "deletionProtectionEnabled": false,
    "multiRegionProperties": {
       "witnessRegion": "us-west-2",
       "clusters": [
          "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4",
          "arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5"
       ]
    }
}
```

#### Emparejamiento de clústeres durante la creación
<a name="peer-during-creation"></a>

Puede reducir el número de pasos si incluye información de emparejamiento durante la creación del clúster. Después de crear el primer clúster en Este de EE. UU. (Norte de Virginia) (paso 1), puede crear el segundo clúster en Este de EE. UU. (Ohio) mientras inicia simultáneamente el proceso de emparejamiento mediante la inclusión del ARN del primer clúster.

**Example**  

```
aws dsql create-cluster \
--region us-east-2 \
--multi-region-properties '{"witnessRegion":"us-west-2","clusters": ["arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4"]}'
```

Esto combina los pasos 2 y 4, pero aún deberá completar el paso 3 (actualizar el primer clúster con el ARN del segundo clúster) para establecer la relación de emparejamiento. Una vez completados todos los pasos, ambos clústeres pasarán por los mismos estados que en el proceso estándar: de **PENDING\_SETUP** a **CREATING** y, finalmente, a **ACTIVE** cuando estén listos para utilizarse. 

## Creación de clústeres multirregionales
<a name="delete-clusters"></a>

Para eliminar un clúster multirregional, debe completar dos pasos.

1. Desactive la protección contra eliminación de cada clúster.

1. Elimine cada clúster emparejado por separado en la Región de AWS correspondiente

### Actualización y eliminación del clúster en Este de EE. UU. (Norte de Virginia)
<a name="delete-cluster-us-east-1"></a>

1. Desactive la protección contra eliminación mediante el comando `update-cluster`.

   ```
   aws dsql update-cluster \
     --region us-east-1 \
     --identifier 'foo0bar1baz2quux3quuxquux4' \
     --no-deletion-protection-enabled
   ```

1. Elimine el clúster con el comando `delete-cluster`.

   ```
   aws dsql delete-cluster \
     --region us-east-1 \
     --identifier 'foo0bar1baz2quux3quuxquux4'
   ```

   El comando devuelve el siguiente resultado.

   ```
   {
       "identifier": "foo0bar1baz2quux3quuxquux4",
       "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4",
       "status": "PENDING_DELETE", 
       "creationTime": "2025-05-06T06:46:10.745000-07:00"
   }
   ```
**nota**  
El clúster pasa al estado `PENDING_DELETE`. La eliminación no estará completa hasta que elimine el clúster emparejado en Este de EE. UU. (Ohio).

### Actualización y eliminación del clúster en Este de EE. UU. (Ohio)
<a name="delete-cluster-us-east-2"></a>

1. Desactive la protección contra eliminación mediante el comando `update-cluster`.

   ```
   aws dsql update-cluster \
   --region us-east-2 \
   --identifier 'foo0bar1baz2quux3quux4quuux' \
   --no-deletion-protection-enabled
   ```

1. Elimine el clúster con el comando `delete-cluster`.

   ```
   aws dsql delete-cluster \
   --region us-east-2 \
   --identifier 'foo0bar1baz2quux3quuxquux5'
   ```

   El comando devuelve la siguiente respuesta:

   ```
   {
       "identifier": "foo0bar1baz2quux3quuxquux5",
       "arn": "arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5",
       "status": "PENDING_DELETE",
       "creationTime": "2025-05-06T06:46:10.745000-07:00"
   }
   ```
**nota**  
El clúster pasa al estado `PENDING_DELETE`. Después de unos segundos, el sistema realiza de forma automática la transición de ambos clústeres emparejados al estado `DELETING` después de la validación.