修改 Amazon DocumentDB 實例

您可以使用 AWS Management Console 或修改 Amazon DocumentDB 執行個體。 AWS CLI若要修改執行個體，執行個體必須處於可用狀態。您無法修改已停止的執行個體。如果叢集已停止，請先啟動叢集，等待執行個體變成可用，然後進行所需的修改。如需詳細資訊，請參閱 停止和啟動 Amazon DocumentDB 集群。

Using the AWS Management Console

若要使用主控台修改特定的 Amazon DocumentDB 執行個體，請完成以下步驟。

1. 登入 AWS Management Console，然後在 https://console.aws.amazon.com/docdb 開啟 Amazon DocumentDB 主控台。

2. 在導覽窗格中，選擇叢集。

   提示

   如果畫面左側沒有出現導覽窗格，請選擇頁面左上角的功能表圖示 ()。

3. 在 [叢集] 導覽方塊中，您會看到 [叢集識別碼] 資料行。您的執行個體會列在叢集下，類似下方的螢幕擷取畫面。

   

4. 核取您要修改之執行個體左側的方塊。

5. 選擇 Actions (動作)，然後選擇 Modify (修改)。

6. 在 Modify instance:<instance-name> (修改執行個體：<執行個體-名稱> 窗格中，進行您想要的變更。您可進行下列變更。

   • 執行個體規格 — 執行個體識別碼和類別。執行個體識別符命名限制：

     • 執行個體識別碼 — 輸入您 AWS 帳戶 在目前地區擁有的所有執行個體的唯一名稱。實體識別碼必須包含 [1—63] 英數字元或連字號，以字母作為第一個字元，且不能以連字號結尾或包含兩個連字號。

     • 執行個體類別 — 從下拉式功能表中，選取 Amazon DocumentDB 執行個體的執行個體類別。如需詳細資訊，請參閱 管理執行個體類別。

   • 憑證授權單位 — 此執行個體的伺服器憑證。如需詳細資訊，請參閱 更新您的 Amazon DocumentDB TLS 證書。

   • 容錯移轉 — 在容錯移轉期間，具有最高升級層的執行個體將升級為主要執行個體。如需詳細資訊，請參閱 Amazon DocumentDB 容錯移轉。

   • 維護 — 將擱置修改或修正程式套用至叢集中執行處理的維護時段。

7. 完成後，請選擇 Continue (繼續) 以查看變更的摘要。

8. 確認變更後，即可立即套用，或是在下一個維護時段在 Scheduling of modifications (修改的排程) 下套用。選擇 Modify Instance (修改執行個體)，以儲存變更。或者，您可以選擇 Cancel (取消) 以捨棄變更。

套用您的變更需要幾分鐘的時間才會完成。您只能使用狀態為可用的執行個體。您可以使用主控台或 AWS CLI 監控執行個體的狀態。如需詳細資訊，請參閱 監控 Amazon DocumentDB 執行個體的狀態。

Using the AWS CLI

若要使用修改特定的 Amazon DocumentDB 執行個體 AWS CLI，請modify-db-instance搭配下列參數使用。如需詳細資訊，請參閱 ModifyDBInstance。以下程式碼將執行個體 sample-instance 的執行個體類別修改為 db.r5.large。

參數

• --db-instance-identifier – 必要。要修改的執行個體識別碼。

• --db-instance-class-可選。執行個體的新運算和記憶體容量；例如，db.r5.large. 並非所有實例類都可用 AWS 區域。如果您修改執行個體類別，變更期間就會發生中斷。除非針對此要求指定為 true，否則ApplyImmediately變更會在下一個維護時段套用。

• --apply-immediately或 --no-apply-immediately-可選。指定這項修改應立即套用，或等到下一次維護時段才套用。若省略此參數，則會在下一次維護時段進行修改。

若為 Linux、macOS 或 Unix：

aws docdb modify-db-instance \
       --db-instance-identifier sample-instance \
       --db-instance-class db.r5.large \
       --apply-immediately

針對 Windows：

aws docdb modify-db-instance ^
       --db-instance-identifier sample-instance ^
       --db-instance-class db.r5.large ^
       --apply-immediately

此操作的輸出將會如下所示。

{
    "DBInstances": [
        {
            "DBInstanceIdentifier": "sample-instance-1",
            "DBInstanceClass": "db.r5.large",
            "Engine": "docdb",
            "DBInstanceStatus": "modifying",
            "Endpoint": {                     
                "Address": "sample-instance-1.node.us-east-1.docdb.amazonaws.com",
                "Port": 27017,   
                "HostedZoneId": "ABCDEFGHIJKLM"
            },
            "InstanceCreateTime": "2020-01-10T22:18:55.921Z",
            "PreferredBackupWindow": "02:00-02:30",
            "BackupRetentionPeriod": 1,
            "VpcSecurityGroups": [
                {                             
                    "VpcSecurityGroupId": "sg-abcd0123",
                    "Status": "active"
                }
            ],
            "AvailabilityZone": "us-east-1a",
            "DBSubnetGroup": {
                "DBSubnetGroupName": "default",
                "DBSubnetGroupDescription": "default",
                "VpcId": "vpc-abcd0123",
                "SubnetGroupStatus": "Complete",
                "Subnets": [
                    {
                        "SubnetIdentifier": "subnet-abcd0123",
                        "SubnetAvailabilityZone": {
                            "Name": "us-east-1a"
                        },
                        "SubnetStatus": "Active"
                    },
                    {
                        "SubnetIdentifier": "subnet-abcd0123",
                        "SubnetAvailabilityZone": {
                            "Name": "us-east-1b"
                        },
                        "SubnetStatus": "Active"
                    }
                ]
            },
            "PreferredMaintenanceWindow": "sun:10:57-sun:11:27",
            "PendingModifiedValues": {
                "DBInstanceClass": "db.r5.large"
            },
            "EngineVersion": "3.6.0",
            "AutoMinorVersionUpgrade": true,
            "PubliclyAccessible": false,
            "DBClusterIdentifier": "sample-cluster",
            "StorageEncrypted": true,
            "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
            "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
            "CACertificateIdentifier": "rds-ca-2019",
            "PromotionTier": 1,                     
            "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:sample-instance-1",
            "EnabledCloudwatchLogsExports": [
                "profiler"
            ]
        }
    ]
}

套用您的修改需要幾分鐘的時間才會完成。您只能使用狀態為可用的執行個體。您可以使用 AWS Management Console 或監視執行個體的狀態 AWS CLI。如需詳細資訊，請參閱 監控 Amazon DocumentDB 執行個體的狀態。