Aurora DSQL con la AWS CLI - Amazon Aurora DSQL

Aurora DSQL con la AWS CLI

Consulte las secciones siguientes para obtener información sobre cómo administrar los clústeres con la AWS CLI.

CreateCluster

Para crear un clúster, utilice el comando create-cluster.

nota

La creación del clúster se produce de forma asíncrona. Llame a la API GetCluster hasta que el estado sea ACTIVE. Puede conectarse a un clúster una vez que se convierta en ACTIVE.

Comando de ejemplo

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

Si desea desactivar la protección contra eliminación en el momento de la creación, incluya la marca --no-deletion-protection-enabled.

Respuesta de ejemplo

{
    "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

Para describir un clúster, utilice el comando get-cluster.

Comando de ejemplo

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

Respuesta de ejemplo

{
    "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

Para actualizar un clúster existente, utilice el comando update-cluster.

nota

Las actualizaciones se producen de forma asíncrona. Llame a la API GetCluster hasta que el estado sea ACTIVE y observará los cambios.

Comando de ejemplo

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

Respuesta de ejemplo

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

DeleteCluster

Para eliminar un clúster existente, utilice el comando delete-cluster.

nota

Solo puede eliminar un clúster que tenga desactivada la protección contra eliminación. La protección contra eliminación está activada de forma predeterminada al crear nuevos clústeres.

Comando de ejemplo

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

Respuesta de ejemplo

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

ListClusters

Para obtener la lista de los clústeres, utilice el comando list-clusters.

Comando de ejemplo

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

Respuesta de ejemplo

{
    "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 en clústeres multirregionales

Para obtener información sobre un clúster multirregional, utilice el comando get-cluster. En el caso de los clústeres multirregionales, la respuesta incluirá los ARN de los clústeres vinculados.

Comando de ejemplo

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

Respuesta de ejemplo

{
    "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"
    }
}