Utilisation de l’interface de ligne de commande (CLI) AWS - Amazon Aurora DSQL
Créer un clusterDescription d’un clusterMise à jour d’un clusterSuppression d’un clusterÉtablissement de la liste des clusters

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

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

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.

Exemple 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.

Exemple 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

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

Exemple Commande
aws dsql get-cluster \
  --region us-east-1 \
  --identifier your_cluster_id
Exemple 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

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.

Exemple Commande
aws dsql update-cluster \
  --region us-east-1 \
  --no-deletion-protection-enabled \
  --identifier your_cluster_id
Exemple 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

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.

Exemple Commande
aws dsql delete-cluster \
  --region us-east-1 \
  --identifier your_cluster_id
Exemple 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

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

Exemple Commande
aws dsql list-clusters --region us-east-1
Exemple 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"
        }
    ]
}