使用 的 Aurora DSQL AWS CLI - Amazon Aurora DSQL
CreateClusterGetClusterUpdateClusterDeleteClusterListClusters多區域叢集上的 GetCluster

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 的 Aurora DSQL AWS CLI

請參閱下列各節，了解如何使用 管理您的叢集 AWS CLI。

CreateCluster

若要建立叢集，請使用 create-cluster命令。

注意

叢集建立會以非同步方式進行。呼叫 GetCluster API，直到狀態為 為止ACTIVE。一旦叢集變成 ，您就可以連線到叢集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命令。

注意

更新會以非同步方式進行。呼叫 GetCluster API，直到狀態為 ACTIVE為止，您將會看到變更。

範例命令

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命令。對於多區域叢集，回應將包含連結ARNs。

範例命令

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