Uso de la CLI de AWS - Amazon Aurora DSQL
Crear un clústerDescripción de un clústerActualización de un clústerEliminación de un clústerMostrar clústeres

Uso de la CLI de AWS

La CLI de AWS proporciona una interfaz de línea de comandos para administrar los clústeres de Aurora DSQL. En los siguientes ejemplos se muestran las operaciones de administración de clústeres comunes.

Crear un clúster

Cree un clúster mediante el comando create-cluster.

nota

La creación de un clúster es una operación asíncrona. Llame a la API GetCluster hasta que el estado cambie a ACTIVE. Puede conectarse al clúster después de que se active.

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

Para desactivar la protección contra eliminación durante la creación, incluya la marca --no-deletion-protection-enabled.

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

Descripción de un clúster

Obtenga información sobre un clúster mediante el comando get-cluster.

ejemplo Comando
aws dsql get-cluster \
  --region us-east-1 \
  --identifier your_cluster_id
ejemplo Respuesta
{
    "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"
    }
}

Actualización de un clúster

Actualice un clúster existente mediante el comando update-cluster.

nota

Las actualizaciones son operaciones asíncronas. Llame a la API GetCluster hasta que el estado cambie a ACTIVE para ver los cambios.

ejemplo Comando
aws dsql update-cluster \
  --region us-east-1 \
  --no-deletion-protection-enabled \
  --identifier your_cluster_id
ejemplo Respuesta
{
    "identifier": "abc0def1baz2quux3quuux4",
    "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/abc0def1baz2quux3quuux4",
    "status": "UPDATING",
    "creationTime": "2024-05-24T09:15:32.708000-07:00"
}

Eliminación de un clúster

Elimine un clúster existente mediante el comando delete-cluster.

nota

Solo puede eliminar clústeres que tengan desactivada la protección contra eliminación. De forma predeterminada, la protección contra eliminación está activada cuando crea nuevos clústeres.

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

Mostrar clústeres

Enumere los clústeres mediante el comando list-clusters.

ejemplo Comando
aws dsql list-clusters --region us-east-1
ejemplo Respuesta
{
    "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"
        }
    ]
}