単一リージョンクラスターの設定
クラスターの作成
クラスターを作成するには、create-cluster コマンドを使用します。
注記
クラスターの作成は非同期演算です。ステータスが ACTIVE
に変わるまで GetCluster API を呼び出します。クラスターは、アクティブになった後に接続できます。
例 コマンド
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": "2024-05-25T16:56:49.784000-07:00", "deletionProtectionEnabled": true, "tag": {}, "encryptionDetails": { "encryptionType": "AWS_OWNED_KMS_KEY", "encryptionStatus": "ENABLED" } }
クラスターの説明
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": "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" } }
クラスターの更新
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"
}
クラスターの削除
delete-cluster コマンドを使用して既存のクラスターを削除します。
注記
削除保護が無効になっている DB クラスターのみ削除できます。新しいクラスターを作成する場合は、デフォルトで削除保護が有効になっています。
例 コマンド
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"
}
クラスターの一覧表示
list-clusters コマンドを使用してクラスターを一覧表示します。
例 コマンド
aws dsql list-clusters --region us-east-1
例 レスポンス
{ "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" } ] }