Amazon DocumentDB クラスターの変更

パラメータ

• --db-cluster-identifier — 必須 変更しようとしている Amazon DocumentDB クラスターの識別子。

• --backup-retention-period - オプション。自動バックアップを保管する日数。有効な値は、1 – 35 です。

• --storage-type - オプション。クラスターのストレージ設定 有効な値は、standard (標準) または iopt1 (I/O 最適化) です。

• --db-cluster-parameter-group-name - オプション。クラスターに使用するクラスターパラメータグループの名前。

• --manage-master-user-password - オプション。Amazon DocumentDB は、マスターユーザーパスワードを生成し、Secrets Manager のライフサイクルを通じて管理します。

• --rotate-master-user-password - オプションです。Secrets Manager は、既存のシークレットの新しいシークレットバージョンを生成します。シークレットの新しいバージョンには、新しいプライマリユーザーのパスワードが含まれています。Amazon DocumentDB は、新しいシークレットバージョンのパスワードと一致するようにクラスターのプライマリユーザーパスワードを変更します。

  プライマリパスワードをローテーションするときは、 --apply-immediatelyオプションを指定する必要があります。

• --master-user-password - オプションです。プライマリデータベースユーザー向け新しいパスワード。

  パスワードの制約:

  • 長さは [8～100] の印刷可能なASCII文字です。

  • 以下を除く印刷可能なASCII任意の文字を使用できます。

    • / (スラッシュ)

    • " (二重引用符)

    • @ (アットマーク)

• --new-db-cluster-identifier - オプション。クラスターの名前を変更する場合のクラスターの新しいクラスター識別子。この値は小文字で保存されます。

  命名に関する制約:

  • 1 − 63 個の英字、数字、またはハイフンで構成します。

  • 1 字目は英字である必要があります。

  • ハイフンを、文字列の最後に使用したり、2 つ続けて使用したりすることはできません。

  • Amazon 、Amazon NeptuneRDS、Amazon DocumentDB のすべてのクラスターで AWS アカウント、リージョンごとに一意である必要があります。

• --preferred-backup-window - オプションです。自動バックアップが作成される毎日の時間範囲 (協定世界時UTC）。

  • 形式: hh24:mm-hh24:mm

• --preferred-maintenance-window - オプション。でシステムメンテナンスを実行できる週 1 回の時間範囲UTC。

  • 形式: ddd:hh24:mm-ddd:hh24:mm

  • 有効な日: Sun、Mon、Tue、Wed、Thu、Fri、および Sat。

• --deletion-protection または --no-deletion-protection - オプション。このクラスターで削除に対する保護を有効にするかを指定します。削除保護では、クラスターを変更して削除保護を無効にするまで、クラスターが誤って削除されないようにします。詳細については、「Amazon DocumentDB クラスターの削除」を参照してください。

• --apply-immediately または --no-apply-immediately − 今すぐ変更を適用するには、--apply-immediately を使用します。クラスターの次のメンテナンスウィンドウ時に変更するには、--no-apply-immediately を使用します。

aws docdb modify-db-cluster \
       --db-cluster-identifier sample-cluster \
       --apply-immediately \
       --backup-retention-period 7

aws docdb modify-db-cluster ^
       --db-cluster-identifier sample-cluster ^
       --apply-immediately ^
       --backup-retention-period 7

{
    "DBCluster": {
        "BackupRetentionPeriod": 7,
        "DbClusterResourceId": "cluster-VDP53QEWST7YHM36TTXOPJT5YE",
        "Status": "available",
        "DBClusterMembers": [
            {
                "PromotionTier": 1,
                "DBClusterParameterGroupStatus": "in-sync",
                "DBInstanceIdentifier": "sample-cluster-instance",
                "IsClusterWriter": true
            }
        ],
        "ReadReplicaIdentifiers": [],
        "AvailabilityZones": [
            "us-east-1b",
            "us-east-1c",
            "us-east-1a"
        ],
        "ReaderEndpoint": "sample-cluster.cluster-ro-ctevjxdlur57.us-east-1.rds.amazonaws.com",
        "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
        "PreferredMaintenanceWindow": "sat:09:51-sat:10:21",
        "EarliestRestorableTime": "2018-06-17T00:06:19.374Z",
        "StorageEncrypted": false,
        "MultiAZ": false,
        "AssociatedRoles": [],
        "MasterUsername": "<your-master-user-name>",
        "DBClusterIdentifier": "sample-cluster",
        "VpcSecurityGroups": [
            {
                "Status": "active",
                "VpcSecurityGroupId": "sg-77186e0d"
            }
        ],
        "HostedZoneId": "Z2SUY0A1719RZT",
        "LatestRestorableTime": "2018-06-18T21:17:05.737Z",
        "AllocatedStorage": 1,
        "Port": 27017,
        "Engine": "docdb",
        "DBClusterParameterGroup": "default.docdb3.4",
        "Endpoint": "sample-cluster.cluster-ctevjxdlur57.us-east-1.rds.amazonaws.com",
        "DBSubnetGroup": "default",
        "PreferredBackupWindow": "00:00-00:30",
        "EngineVersion": "3.4",
        "ClusterCreateTime": "2018-06-06T19:25:47.991Z",
        "IAMDatabaseAuthenticationEnabled": false
    }
}