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 l’interface de ligne de commande (CLI) AWS
<a name="single-region-aws-cli"></a>

L’interface de ligne de commande (CLI) AWS fournit une interface de ligne de commande pour gérer vos clusters Aurora DSQL. L’exemple suivant montre les opérations courantes de gestion de cluster.

## Créer un cluster
<a name="create-cluster"></a>

Créez un cluster à l’aide de la commande **create-cluster**.

**Note**  
La création de clusters est une opération asynchrone. Appelez l’API **GetCluster** jusqu’à ce que le statut passe à `ACTIVE`. Vous pouvez vous connecter à votre cluster une fois qu’il est actif.

**Example Commande**  

```
aws dsql create-cluster --region us-east-1
```

**Note**  
Pour désactiver la protection contre la suppression lors de la création, incluez l’indicateur `--no-deletion-protection-enabled`.

**Example Réponse**  

```
{
    "identifier": "abc0def1baz2quux3quuux4",
    "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/abc0def1baz2quux3quuux4",
    "status": "CREATING",
    "creationTime": "2024-05-25T16:56:49.784000-07:00",
    "deletionProtectionEnabled": true,
    "tag": {},
    "encryptionDetails": {
        "encryptionType": "AWS_OWNED_KMS_KEY",
        "encryptionStatus": "ENABLED"
    }
}
```

## Description d’un cluster
<a name="get-cluster"></a>

Obtenez des informations sur un cluster à l’aide de la commande **get-cluster**.

**Example Commande**  

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

**Example Réponse**  

```
{
    "identifier": "abc0def1baz2quux3quuux4",
    "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/abc0def1baz2quux3quuux4",
    "status": "ACTIVE",
    "creationTime": "2024-11-27T00:32:14.434000-08:00",
    "deletionProtectionEnabled": false,
    "encryptionDetails": {
        "encryptionType": "CUSTOMER_MANAGED_KMS_KEY",
        "kmsKeyArn": "arn:aws:kms:us-east-1:111122223333:key/123a456b-c789-01de-2f34-g5hi6j7k8lm9",
        "encryptionStatus": "ENABLED"
    }
}
```

## Mise à jour d’un cluster
<a name="update-cluster"></a>

Mettez à jour un cluster existant à l’aide de la commande **update-cluster**.

**Note**  
Les mises à jour sont des opérations asynchrones. Appelez l’API **GetCluster** jusqu’à ce que le statut passe à `ACTIVE` pour voir vos modifications.

**Example Commande**  

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

**Example Réponse**  

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

## Suppression d’un cluster
<a name="delete-cluster"></a>

Supprimez un cluster existant à l’aide de la commande **delete-cluster**.

**Note**  
Vous pouvez uniquement supprimer les clusters dont la protection contre la suppression est désactivée. La protection contre la suppression est activée par défaut lorsque vous créez de nouveaux clusters.

**Example Commande**  

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

**Example Réponse**  

```
{
    "identifier": "abc0def1baz2quux3quuux4",
    "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/abc0def1baz2quux3quuux4",
    "status": "DELETING",
    "creationTime": "2024-05-24T09:16:43.778000-07:00"
}
```

## Établissement de la liste des clusters
<a name="list-clusters"></a>

Répertoriez vos clusters à l’aide de la commande **list-clusters**.

**Example Commande**  

```
aws dsql list-clusters --region us-east-1
```

**Example Réponse**  

```
{
    "clusters": [
        {
            "identifier": "abc0def1baz2quux3quux4quuux",
            "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/abc0def1baz2quux3quux4quuux"
        },
        {
            "identifier": "abc0def1baz2quux3quux5quuuux",
            "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/abc0def1baz2quux3quux5quuuux"
        }
    ]
}
```