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.
# Utilisation de la AWS CLI
La AWS CLI fournit une interface de ligne de commande pour gérer vos clusters Aurora DSQL multirégionaux. Les exemples suivants montrent comment créer, configurer et supprimer des clusters multi-régions.
## Connexion à votre cluster multi-régions
Les clusters multi-régions associés fournissent deux points de terminaison régionaux, un dans chaque cluster associé Région AWS. Les deux points de terminaison présentent une base de données logique unique qui prend en charge les opérations de lecture et d’écriture simultanées avec une forte cohérence des données. Outre les clusters associés, un cluster multi-régions possède également une région témoin qui stocke une fenêtre limitée de journaux de transactions chiffrés, qui est utilisée pour améliorer la durabilité et la disponibilité de plusieurs régions. Les régions témoins multi-régions n’ont pas de points de terminaison.
## Création de clusters multi-régions
Pour créer des clusters multi-régions, vous devez d’abord créer un cluster avec une région témoin. Ensuite, vous associez ce cluster à un second cluster qui partage la même région témoin que votre premier cluster. L’exemple suivant montre comment créer des clusters dans les régions USA Est (Virginie du Nord) et USA Est (Ohio) avec la région USA Ouest (Oregon) comme région témoin.
### Étape 1 : création du cluster 1 dans la région USA Est (Virginie du Nord)
Pour créer un cluster dans l'est des États-Unis (Virginie du Nord) Région AWS avec des propriétés multirégionales, utilisez la commande ci-dessous.
```
aws dsql create-cluster \
--region us-east-1 \
--multi-region-properties '{"witnessRegion":"us-west-2"}'
```
**Example Réponse :**
```
{
"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"
}
```
**Note**
Lorsque l’opération d’API aboutit, le cluster passe à l’état `PENDING_SETUP`. La création du cluster reste à l’état `PENDING_SETUP` jusqu’à ce que vous le mettiez à jour avec l’ARN de son cluster homologue.
### Étape 2 : création du cluster 2 dans la région USA Est (Ohio)
Pour créer un cluster dans l'est des États-Unis (Ohio) Région AWS avec des propriétés multirégionales, utilisez la commande ci-dessous.
```
aws dsql create-cluster \
--region us-east-2 \
--multi-region-properties '{"witnessRegion":"us-west-2"}'
```
**Example Réponse :**
```
{
"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"
]
}
}
```
Lorsque l’opération d’API réussit, le cluster passe à l’état `PENDING_SETUP`. La création du cluster reste à l’état `PENDING_SETUP` jusqu’à ce que vous le mettiez à jour avec l’ARN d’un autre cluster associé.
### Étape 3 : association d’un cluster de la région USA Est (Virginie du Nord) avec la région USA Est (Ohio)
Pour associer votre cluster de la région USA Est (Virginie du Nord) à votre cluster de la région USA Est (Ohio), utilisez la commande `update-cluster`. Spécifiez le nom de votre cluster de la région USA Est (Virginie du Nord) et une chaîne JSON avec l’ARN du cluster de la région USA Est (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 Réponse**
```
{
"identifier": "foo0bar1baz2quux3quuxquux4",
"arn": "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4",
"status": "UPDATING",
"creationTime": "2025-05-06T06:46:10.745000-07:00"
}
```
### Étape 4 : association d’un cluster de la région USA Est (Ohio) avec la région USA Est (Virginie du Nord)
Pour associer votre cluster de la région USA Est (Ohio) à votre cluster de la région USA Est (Virginie du Nord), utilisez la commande `update-cluster`. Spécifiez le nom de votre cluster de la région USA Est (Ohio) et une chaîne JSON avec l’ARN du cluster de la région USA Est (Virginie du Nord).
**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 Réponse**
```
{
"identifier": "foo0bar1baz2quux3quuxquux5",
"arn": "arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5",
"status": "UPDATING",
"creationTime": "2025-05-06T06:51:16.145000-07:00"
}
```
**Note**
Après une association réussie, les deux clusters passent de l’état « PENDING\_SETUP » à « CREATING » et enfin à l’état « ACTIVE » lorsqu’ils sont prêts à être utilisés.
#### Affichage des propriétés d’un cluster multi-régions
Lorsque vous décrivez un cluster, vous pouvez afficher les propriétés multirégionales des clusters de différentes Régions AWS régions.
**Example**
```
aws dsql get-cluster \
--region us-east-1 \
--identifier 'foo0bar1baz2quux3quuxquux4'
```
**Example Réponse**
```
{
"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"
]
}
}
```
#### Association des clusters lors de la création
Vous pouvez réduire le nombre d’étapes en incluant des informations d’association lors de la création du cluster. Après avoir créé votre premier cluster dans la région USA Est (Virginie du Nord) (étape 1), vous pouvez créer votre deuxième cluster dans la région USA Est (Ohio) tout en lançant le processus d’association en incluant l’ARN du premier cluster.
**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"]}'
```
Cela combine les étapes 2 et 4, mais vous devez tout de même terminer l’étape 3 (mise à jour du premier cluster avec l’ARN du deuxième cluster) pour établir la relation d’association. Une fois toutes les étapes terminées, les deux clusters passeront par les mêmes états que dans le processus standard : de **PENDING\_SETUP** à **CREATING**, puis à **ACTIVE** lorsqu’ils seront prêts à être utilisés.
## Suppression de clusters multi-régions
Pour supprimer un cluster multi-régions, vous devez effectuer deux étapes.
1. Désactivez la protection contre la suppression pour chaque cluster.
1. Supprimez chaque cluster pair séparément dans ses clusters respectifs Région AWS
### Mise à jour et suppression d’un cluster dans la région USA Est (Virginie du Nord)
1. Désactivez la protection contre la suppression à l’aide de la commande `update-cluster`.
```
aws dsql update-cluster \
--region us-east-1 \
--identifier 'foo0bar1baz2quux3quuxquux4' \
--no-deletion-protection-enabled
```
1. Supprimez le cluster à l’aide de la commande `delete-cluster`.
```
aws dsql delete-cluster \
--region us-east-1 \
--identifier 'foo0bar1baz2quux3quuxquux4'
```
Cette commande renvoie la réponse suivante.
```
{
"identifier": "foo0bar1baz2quux3quuxquux4",
"arn": "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4",
"status": "PENDING_DELETE",
"creationTime": "2025-05-06T06:46:10.745000-07:00"
}
```
**Note**
Le cluster passe à l’état `PENDING_DELETE`. La suppression n’est pas terminée tant que vous n’avez pas supprimé le cluster associé dans la région USA Est (Ohio).
### Mise à jour et suppression d’un cluster dans la région USA Est (Ohio)
1. Désactivez la protection contre la suppression à l’aide de la commande `update-cluster`.
```
aws dsql update-cluster \
--region us-east-2 \
--identifier 'foo0bar1baz2quux3quux4quuux' \
--no-deletion-protection-enabled
```
1. Supprimez le cluster à l’aide de la commande `delete-cluster`.
```
aws dsql delete-cluster \
--region us-east-2 \
--identifier 'foo0bar1baz2quux3quuxquux5'
```
Cette commande renvoie la réponse suivante :
```
{
"identifier": "foo0bar1baz2quux3quuxquux5",
"arn": "arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5",
"status": "PENDING_DELETE",
"creationTime": "2025-05-06T06:46:10.745000-07:00"
}
```
**Note**
Le cluster passe à l’état `PENDING_DELETE`. Après quelques secondes, le système fait passer automatiquement les deux clusters associés à l’état `DELETING` après validation.