Aurora DSQL avec le AWS CLI - Amazon Aurora DSQL
CreateClusterGetClusterUpdateClusterDeleteClusterListClustersGetCluster sur les clusters multirégionaux

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.

Aurora DSQL avec le AWS CLI

Consultez les sections suivantes pour savoir comment gérer vos clusters avec le AWS CLI.

CreateCluster

Pour créer un cluster, utilisez la create-cluster commande.

Note

La création de clusters s'effectue de manière asynchrone. Appelez l'GetClusterAPI jusqu'à ce que le statut soit rétabliACTIVE. Vous pouvez vous connecter à un cluster une fois qu'il le devientACTIVE.

Exemple de commande

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

Si vous souhaitez désactiver la protection contre la suppression lors de la création, incluez le --no-deletion-protection-enabled drapeau.

Exemple de réponse

{
    "identifier": "abc0def1baz2quux3quuux4",
    "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/abc0def1baz2quux3quuux4",
    "status": "CREATING",
    "creationTime": "2025-05-22T14:03:26.631000-07:00",
    "encryptionDetails": {
        "encryptionType": "AWS_OWNED_KMS_KEY",
        "encryptionStatus": "ENABLED"
    },
    "deletionProtectionEnabled": true
}

GetCluster

Pour décrire un cluster, utilisez la get-cluster commande.

Exemple de commande

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

Exemple de réponse

{
    "identifier": "abc0def1baz2quux3quuux4",
    "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/abc0def1baz2quux3quuux4",
    "status": "ACTIVE",
    "creationTime": "2025-05-22T14:03:26.631000-07:00",
    "deletionProtectionEnabled": true,
    "tags": {},
    "encryptionDetails": {
        "encryptionType": "AWS_OWNED_KMS_KEY",
        "encryptionStatus": "ENABLED"
    }
}

UpdateCluster

Pour mettre à jour un cluster existant, utilisez la update-cluster commande.

Note

Les mises à jour se font de manière asynchrone. Appelez l'GetClusterAPI jusqu'à ce que le statut soit ACTIVE rétabli et que vous observiez les modifications.

Exemple de commande

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

Exemple de 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"
}

DeleteCluster

Pour supprimer un cluster existant, utilisez la delete-cluster commande.

Note

Vous ne pouvez supprimer qu'un cluster dont la protection contre la suppression est désactivée. La protection contre la suppression est activée par défaut lors de la création de nouveaux clusters.

Exemple de commande

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

Exemple de 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"
}

ListClusters

Pour obtenir le a des clusters, utilisez la list-clusters commande.

Exemple de commande

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

Exemple de réponse

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

GetCluster sur les clusters multirégionaux

Pour obtenir des informations sur un cluster multirégional, utilisez la get-cluster commande. Pour les clusters multirégionaux, la réponse inclura le cluster ARNs lié.

Exemple de commande

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

Exemple de réponse

{
    "identifier": "abc0def1baz2quux3quuux4",
    "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/abc0def1baz2quux3quuux4",
    "status": "ACTIVE",
    "creationTime": "2025-05-22T13:56:18.716000-07:00",
    "deletionProtectionEnabled": true,
    "multiRegionProperties": {
        "witnessRegion": "us-west-2",
        "clusters": [
            "arn:aws:dsql:us-east-1:842685632318:cluster/fuabuc7d3szkr37uqd5znkjynu"
        ]
    },
    "tags": {},
    "encryptionDetails": {
        "encryptionType": "AWS_OWNED_KMS_KEY",
        "encryptionStatus": "ENABLED"
    }
}