AWS CLI를 사용한 Aurora DSQL - Amazon Aurora DSQL
CreateClusterGetClusterUpdateClusterDeleteClusterListClusters다중 리전 클러스터에 대한 GetCluster

AWS CLI를 사용한 Aurora DSQL

AWS CLI를 사용하여 클러스터를 관리하는 방법을 알아보려면 이어지는 섹션을 참조하세요.

CreateCluster

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

참고

클러스터 생성은 비동기적으로 수행됩니다. 상태가 ACTIVE가 될 때까지 GetCluster API를 직접 호출합니다. 클러스터가 ACTIVE가 되면 클러스터에 연결할 수 있습니다.

샘플 명령

aws dsql create-cluster --region us-east-1
참고

생성 시 삭제 방지를 비활성화하려면 --no-deletion-protection-enabled 플래그를 포함합니다.

샘플 응답

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

클러스터를 설명하려면 get-cluster 명령을 사용합니다.

샘플 명령

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

샘플 응답

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

기존 클러스터를 업데이트하려면 update-cluster 명령을 사용합니다.

참고

업데이트는 비동기적으로 수행됩니다. 상태가 ACTIVE가 될 때까지 GetCluster API를 직접 호출하면 변경 사항을 확인할 수 있습니다.

샘플 명령

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

샘플 응답

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

DeleteCluster

기존 클러스터를 삭제하려면 delete-cluster 명령을 사용합니다.

참고

삭제 방지 기능이 비활성화된 클러스터만 삭제할 수 있습니다. 새로운 클러스터를 생성할 때 기본적으로 삭제 방지가 활성화됩니다.

샘플 명령

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

샘플 응답

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

ListClusters

클러스터를 가져오려면 list-clusters 명령을 사용합니다.

샘플 명령

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

샘플 응답

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

다중 리전 클러스터에 대한 정보를 가져오려면 get-cluster 명령을 사용합니다. 다중 리전 클러스터의 경우 응답에는 연결된 클러스터 ARN이 포함됩니다.

샘플 명령

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

샘플 응답

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