重置 Amazon DocumentDB 集群参数组 - Amazon DocumentDB
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

重置 Amazon DocumentDB 集群参数组

通过使用 Amazon Web Services Management Console 或 Amazon Command Line Interface (Amazon CLI) 来重置集群参数组，您可以将部分或全部 Amazon DocumentDB 集群参数组的参数值重置为其默认值。

Using the Amazon Web Services Management Console

按照以下步骤将将部分或全部集群参数组的参数值重置为默认值。

要重置集群参数组的参数值

  1. 登录到 Amazon Web Services Management Console 并打开 Amazon DocumentDB 控制台，网址：https://console.aws.amazon.com/docdb。

  2. 在控制台左侧的导航窗格中，选择参数组。

  3. 在集群参数组窗格中，选择要对其复置的集群参数组的名称。

  4. 选择操作，然后选择重置以重置该参数组。

  5. 在所得的集群参数组重置确认页面上，确认您想要将该参数组的所有集群参数重置为默认值。然后，选择重置以重置您的参数组。您也可以选择取消以放弃所做更改。

Using the Amazon CLI

要将部分或全部集群参数组的参数值重置为其默认值，请使用带有以下参数的 reset-db-cluster-parameter-group 操作。

  • --db-cluster-parameter-group-name – 必需。要重置的集群参数组的名称。

  • --parameters — 可选。集群参数组中要重置为其默认值的 ParameterName 和 ApplyMethod 列表。静态参数必须设置成 pending-reboot 才能在下次实例重启或 reboot-db-instance 请求时生效。对于集群中您希望更新的静态参数应用于的每个实例，您必须调用 reboot-db-instance。

    此参数和 --reset-all-parameters 相互排斥：您可以使用这两个参数之一，但不能同时使用二者。

  • --reset-all-parameters 或 --no-reset-all-parameters — 可选。指定是否将所有参数 (--reset-all-parameters ) 或仅部分参数 (--no-reset-all-parameters) 重置为其默认值。--reset-all-parameters 参数和 --parameters 相互排斥：您可以使用这两个参数之一，但不能同时使用二者。

    当您重置整个组时，动态参数立即更新。将静态参数设置成 pending-reboot，以便在下次实例重启或 reboot-db-instance 请求时生效。对于集群中您希望更新的静态参数应用于的每个实例，您必须调用 reboot-db-instance。

示例 1：将所有参数重置为其默认值

以下代码将集群参数组 sample-parameter-group 中的所有参数重置成它们的默认值。

对于 Linux、macOS 或 Unix：

aws docdb reset-db-cluster-parameter-group \
       --db-cluster-parameter-group-name sample-parameter-group \
       --reset-all-parameters

对于 Windows：

aws docdb reset-db-cluster-parameter-group ^
       --db-cluster-parameter-group-name sample-parameter-group ^
       --reset-all-parameters
示例 2：将指定的参数重置为其默认值

以下代码将集群参数组 sample-parameter-group 中的 tls 参数重置成它的默认值。

对于 Linux、macOS 或 Unix：

aws docdb reset-db-cluster-parameter-group \
       --db-cluster-parameter-group-name sample-parameter-group \
       --no-reset-all-parameters \
       --parameters ParameterName=tls,ApplyMethod=pending-reboot

对于 Windows：

aws docdb reset-db-cluster-parameter-group ^
       --db-cluster-parameter-group-name sample-parameter-group ^
       --no-reset-all-parameters ^
       --parameters ParameterName=tls,ApplyMethod=pending-reboot

此操作的输出将类似于下文（JSON 格式）。

{
       "DBClusterParameterGroupName": "sample-parameter-group"
   }
重启集群实例

在更改静态参数的值之前，必须重新启动集群实例。重启集群中您希望将更新的静态参数应用到的每个实例。

对于 Linux、macOS 或 Unix：

aws docdb reboot-db-instance \
       --db-instance-identifier sample-cluster-instance

对于 Windows：

aws docdb reboot-db-instance ^
       --db-instance-identifier sample-cluster-instance