ModifyDBCluster

正在修改之叢集的叢集識別符。此參數不區分大小寫。

約束:

類型：字串

必要：是

指示是否允許升級主要版本的值。

限制條件：指定與資料庫叢集目前版本不同的 EngineVersion 參數值時，您必須允許主要版本升級。

類型：布林值

必要：否

指定此請求中的變更和任何待定變更是否以非同步方式盡快套用的值，無論叢集PreferredMaintenanceWindow的設定為何。如果此參數設定為 false，則叢集的變更會在下一個維護時段套用。

ApplyImmediately 參數只會影響 NewDBClusterIdentifier和 MasterUserPassword值。如果您將此參數值設定為 false，則 NewDBClusterIdentifier和 MasterUserPassword值的變更會在下一個維護時段套用。所有其他的變更都會立即套用，無論 ApplyImmediately 參數的值為何。

預設：false

類型：布林值

必要：否

自動備份保留的天數。您必須指定一個值 (最小值為 1)。

預設：1

約束:

類型：整數

必要：否

要為特定執行個體或叢集啟用的日誌類型組態設定，以匯出至 Amazon CloudWatch Logs。EnableLogTypes 和 DisableLogTypes陣列會決定將哪些日誌匯出 （或未匯出） 至 CloudWatch 日誌。

類型：CloudwatchLogsExportConfiguration 物件

必要：否

要用於叢集的叢集參數群組名稱。

類型：字串

必要：否

指定是否可以刪除此叢集。如果 DeletionProtection 已啟用，除非修改並DeletionProtection停用，否則無法刪除叢集。 會DeletionProtection保護叢集，避免意外刪除。

類型：布林值

必要：否

您要升級的資料庫引擎版本號碼。變更此參數會造成中斷。變更會在下一次維護時段期間套用，除非已啟用 ApplyImmediately。

若要列出 Amazon DocumentDB 的所有可用引擎版本，請使用下列命令：

aws docdb describe-db-engine-versions --engine docdb --query "DBEngineVersions[].EngineVersion"

類型：字串

必要：否

指定是否使用 Amazon Web Services Secrets Manager 管理主要使用者密碼。如果叢集沒有使用 Amazon Web Services Secrets Manager 管理主要使用者密碼，您可以開啟此管理。在此情況下，您無法指定 MasterUserPassword。如果叢集已使用 Amazon Web Services Secrets Manager 管理主要使用者密碼，且您指定主要使用者密碼不是使用 Amazon Web Services Secrets Manager 管理，則您必須指定 MasterUserPassword。在此情況下，Amazon DocumentDB 會刪除秘密，並為 指定的主要使用者使用新密碼MasterUserPassword。

類型：布林值

必要：否

主要資料庫使用者的密碼。此密碼可以包含任何可列印ASCII字元，但正斜線 (/)、雙引號 (") 或「at」符號 (@) 除外。

限制條件：必須包含 8 到 100 個字元。

類型：字串

必要：否

Amazon Web Services KMS金鑰識別符，用於加密在 Amazon Web Services Secrets Manager 中自動產生和管理的秘密。

此設定只有在同時符合下列兩個條件時才有效：

Amazon Web Services KMS金鑰識別符是金鑰的金鑰 ARN、金鑰 IDARN、別名 或KMS金鑰的別名。若要在不同 Amazon Web Services 帳戶中使用KMS金鑰，請指定金鑰ARN或別名 ARN。

您的 Amazon Web Services 帳戶有預設KMS金鑰。您的 Amazon Web Services 帳戶在每個 Amazon Web Services 區域都有不同的預設KMS金鑰。

類型：字串

必要：否

重新命名叢集時，叢集的新叢集識別碼。此值會以小寫字母字串的形式儲存。

約束:

範例：my-cluster2

類型：字串

必要：否

叢集接受連線的連接埠號碼。

限制條件：必須是從 1150到 的值65535。

預設：與原始叢集相同的連接埠。

類型：整數

必要：否

每日的時間範圍，若使用 BackupRetentionPeriod 參數啟用自動化備份，則會在此期間建立自動化備份。

預設值為 30 分鐘時段，從每個時段的 8 小時區段中隨機選取 AWS 區域。

約束:

類型：字串

必要：否

系統維護可以發生的每週時間範圍，以國際標準時間 () 為單位UTC。

格式：ddd:hh24:mi-ddd:hh24:mi

預設值是 30 分鐘時段，從每個時段的 8 小時時段中隨機選取 AWS 區域，該時段發生在一週的隨機日期。

有效日：星期一、星期二、星期三、星期四、星期五、星期六、星期日

限制條件：必須至少是 30 分鐘的時段。

類型：字串

必要：否

指定是否要輪換由 Amazon Web Services Secrets Manager 管理的主使用者密碼的秘密。

只有在叢集的 Amazon Web Services Secrets Manager 中由 Amazon DocumentDB 管理主要使用者密碼時，此設定才有效。秘密值包含更新的密碼。

限制條件：輪換主要使用者密碼時，您必須立即套用變更。

類型：布林值

必要：否

和資料庫叢集相關聯的儲存類型。

如需 Amazon DocumentDB 叢集儲存類型的資訊，請參閱《Amazon DocumentDB 開發人員指南》中的叢集儲存組態。

儲存類型 - 的有效值 standard | iopt1

預設值為 standard

類型：字串

必要：否

叢集所屬的虛擬私有雲端 (VPC) 安全群組清單。

類型：字串陣列

必要：否

叢集的詳細資訊。

類型：DBCluster 物件

您已有一個具有指定識別符的叢集。

HTTP 狀態碼：400

DBClusterIdentifier 不會參考現有的叢集。

HTTP 狀態碼：404

DBClusterParameterGroupName 不會參考現有的叢集參數群組。

HTTP 狀態碼：404

DBSubnetGroupName 不會參考現有的子網路群組。

HTTP 狀態碼：404

叢集未處於有效狀態。

HTTP 狀態碼：400

指定的執行個體未處於可用狀態。

HTTP 狀態碼：400

安全群組的狀態不允許刪除。

HTTP 狀態碼：400

無法刪除子網路群組，因為它正在使用中。

HTTP 狀態碼：400

請求的子網路無效，或請求了多個子網路，這些子網路並非全部位於通用虛擬私有雲端 () 中VPC。

HTTP 狀態碼：400

子網路群組不會在建立後涵蓋所有可用區域，因為已進行變更。

HTTP 狀態碼：400

請求將導致您超過所有執行個體中可用的允許儲存量。

HTTP 狀態碼：400