本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 修改 Amazon DocumentDB 執行個體
您可以使用 AWS 管理主控台 或 來修改 Amazon DocumentDB 執行個體 AWS CLI。若要修改執行個體，執行個體必須處於*可用*狀態。您無法修改已停止的執行個體。如果叢集已停止，請先啟動叢集，等待執行個體變成*可用*，然後進行所需的修改。如需詳細資訊，請參閱[停止和啟動 Amazon DocumentDB 叢集](db-cluster-stop-start.md)。
------
#### [ Using the AWS 管理主控台 ]
若要使用主控台修改特定 Amazon DocumentDB 執行個體，請完成下列步驟。
1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) 開啟 Amazon DocumentDB 主控台。
1. 在導覽窗格中，選擇**叢集**。
**提示**
如果畫面左側沒有出現導覽窗格，請選擇頁面左上角的功能表圖示 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/docdb-menu-icon.png))。
1. 在叢集導覽方塊中，您會看到**叢集識別符**欄。您的執行個體會列在叢集下，類似於下面的螢幕擷取畫面。
![\[叢集資料表顯示叢集識別符欄下的叢集清單，其中執行個體巢狀在叢集內。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/choose-clusters.png)
1. 勾選您要修改之執行個體左側的方塊。
1. 選擇 **Actions (動作)**，然後選擇 **Modify (修改)**。
1. 在 **Modify instance: (修改執行個體：<執行個體-名稱>** 窗格中，進行您想要的變更。您可進行下列變更。
+ **執行個體規格** — 執行個體識別符和類別。執行個體識別符命名限制：
+ **執行個體識別符** — 為 AWS 帳戶 目前區域中 擁有的所有執行個體輸入唯一的名稱。執行個體識別符必須包含 【1-63】 個英數字元或連字號、以字母做為第一個字元，且不能以連字號結尾或包含兩個連續連字號。
+ **執行個體類別** — 從下拉式功能表中，選取 Amazon DocumentDB 執行個體的執行個體類別。如需詳細資訊，請參閱[管理執行個體類別](db-instance-classes.md)。
+ **憑證授權機構** — 此執行個體的伺服器憑證。如需詳細資訊，請參閱[更新您的 Amazon DocumentDB TLS 憑證](ca_cert_rotation.md)。
+ **容錯移轉** — 在容錯移轉期間，具有最高提升層的執行個體將提升為主要執行個體。如需詳細資訊，請參閱[Amazon DocumentDB 容錯移轉](failover.md)。
+ **維護** — 將待定修改或修補程式套用至叢集中執行個體的維護時段。
1. 完成後，請選擇 **Continue (繼續)** 以查看變更的摘要。
1. 確認變更後，即可立即套用，或是在下一個維護時段在 **Scheduling of modifications (修改的排程)** 下套用。選擇 **Modify Instance (修改執行個體)**，以儲存變更。或者，您可以選擇 **Cancel (取消)** 以捨棄變更。
套用您的變更需要幾分鐘的時間才會完成。您只能使用狀態為*可用*的執行個體。您可以使用主控台或 AWS CLI監控執行個體的狀態。如需詳細資訊，請參閱[監控 Amazon DocumentDB 執行個體的狀態](monitoring_docdb-instance_status.md)。
------
#### [ Using the AWS CLI ]
若要使用 修改特定 Amazon DocumentDB 執行個體 AWS CLI，請使用 `modify-db-instance`搭配下列參數。如需詳細資訊，請參閱 [ ModifyDBInstance](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBInstance.html)。以下程式碼將執行個體 `sample-instance` 的執行個體類別修改為 `db.r5.large`。
**Parameters**
+ **--db-instance-identifier** – 必要。要修改的執行個體識別碼。
+ **--db-instance-class** — 選用。執行個體的新運算和記憶體容量；例如 `db.r5.large`。並非所有執行個體類別都可在所有 中使用 AWS 區域。如果您修改執行個體類別，則會在變更期間發生中斷。除非此請求`ApplyImmediately`指定為 true，否則變更會在下一個維護時段套用。
+ **--apply-immediately** 或 **--no-apply-immediately** — 選用。指定這項修改應立即套用，或等到下一次維護時段才套用。若省略此參數，則會在下一次維護時段進行修改。
**Example**
針對 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 管理主控台 或 監控執行個體的狀態 AWS CLI。如需詳細資訊，請參閱[監控 Amazon DocumentDB 執行個體的狀態](monitoring_docdb-instance_status.md)。
------