# AWS CLI 사용
<a name="single-region-aws-cli"></a>

AWS CLI는 Aurora DSQL 클러스터를 관리하기 위한 명령줄 인터페이스를 제공합니다. 다음 예제에서는 아래와 같은 작업을 포함하여 공통적인 클러스터 관리 작업을 설명합니다.

## 클러스터 생성
<a name="create-cluster"></a>

**create-cluster** 명령을 사용하여 클러스터를 생성합니다.

**참고**  
클러스터 생성은 비동기 작업입니다. 상태가 `ACTIVE`로 변경될 때까지 **GetCluster** API를 직접 호출합니다. 클러스터가 활성화되면 클러스터에 연결할 수 있습니다.

**Example Command**  

```
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 Command**  

```
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** 명령을 사용하여 기존 클러스터를 업데이트합니다.

**참고**  
업데이트는 비동기 작업입니다. 상태가 `ACTIVE`로 변경될 때까지 **GetCluster** API를 직접 호출하여 변경 사항을 확인합니다.

**Example Command**  

```
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 Command**  

```
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 Command**  

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