# 使用 AWS CLI
<a name="single-region-aws-cli"></a>

AWS CLI 提供了用于管理 Aurora DSQL 集群的命令行界面。以下示例演示常见的集群管理操作：

## 创建集群
<a name="create-cluster"></a>

使用 **create-cluster** 命令创建集群。

**注意**  
集群创建是一个异步操作。调用 **GetCluster** API，直到状态变为 `ACTIVE`。集群变为活动状态后，即可连接到该集群。

**Example 命令**  

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

**注意**  
要在创建过程中禁用删除保护，请包括 `--no-deletion-protection-enabled` 标志。

**Example 响应**  

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

## 描述集群
<a name="get-cluster"></a>

使用 **get-cluster** 命令获取有关集群的信息。

**Example 命令**  

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

**Example 响应**  

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

## 更新集群
<a name="update-cluster"></a>

使用 **update-cluster** 命令更新现有集群。

**注意**  
更新是异步操作。调用 **GetCluster** API，直到状态变为 `ACTIVE`，以查看您的更改。

**Example 命令**  

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

**Example 响应**  

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

## 删除集群
<a name="delete-cluster"></a>

使用 **delete-cluster** 命令删除现有集群。

**注意**  
您只能删除禁用了删除保护的集群。默认情况下，创建新集群时会启用删除保护。

**Example 命令**  

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

**Example 响应**  

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

## 列出集群
<a name="list-clusters"></a>

使用 **list-clusters** 命令列出您的集群。

**Example 命令**  

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

**Example 响应**  

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