管理弹性集群快照 - Amazon DocumentDB
创建手动弹性集群快照查看弹性集群快照从快照还原弹性集群复制弹性集群快照删除弹性集群快照管理弹性集群快照自动备份
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

管理弹性集群快照

已经创建弹性集群后可以手动拍摄快照。创建弹性集群快照的那一刻就会创建自动备份。

注意

您的集群必须处于 Available 状态，才能拍摄手动快照。

这个部分解释如何创建、查看、恢复和删除弹性集群快照。

以下主题显示使用 Amazon DocumentDB 弹性集群快照时如何执行各种任务。

创建手动弹性集群快照

在本节中，我们将说明如何使用 Amazon Web Services Management Console 或 Amazon CLI 以及以下说明创建手动弹性集群快照。

Using the Amazon Web Services Management Console

要使用 Amazon Web Services Management Console 创建手动弹性集群快照：

  1. 登录 Amazon Web Services Management Console 并打开 Amazon DocumentDB 控制台。

  2. 在导航窗格中，选择快照。

    提示

    如果您在屏幕左侧没有看到导航窗格，请在导航窗格左上角选择菜单图标。

  3. 在 Snapshots (快照) 页面上，选择 Create (创建)。

  4. 在创建集群快照页面的集群标识符字段中，从下拉列表中选择您的弹性集群。

    在快照标识符字段中，输入您弹性集群的唯一标识符。

    选择 创建。

    图：弹性集群创建快照
注意

或者，您可以通过以下方式访问创建集群快照对话框：转到集群页面，勾选紧邻您集群的复选框，然后选择操作，然后拍摄快照。

您的弹性集群快照现正在预配置。此过程可能需要数分钟完成。当状态作为 Available 在快照列表中显示时，您可以查看快照并从其中恢复。

Using the Amazon CLI

要使用创建手动弹性集群快照 Amazon CLI，请使用带有以下参数的create-cluster-snapshot操作：

  • --snapshot-name – 必填项。用来创建新集群的快照的名称。

  • --cluster-arn – 必填项。您想要创建其快照的集群的 ARN 标识符。

在以下示例中，将每个用户输入占位符替换为您自己的信息。

对于 Linux、macOS 或 Unix：

aws docdb-elastic create-cluster-snapshot \
    --snapshot-name sample-snapshot-1 \
    --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster

对于 Windows：

aws docdb-elastic create-cluster-snapshot ^
    --snapshot-name sample-snapshot-1 ^
    --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster

查看弹性集群快照

在本节中，我们将说明如何使用 Amazon Web Services Management Console 或 Amazon CLI 以及以下说明查看弹性集群快照信息。

Using the Amazon Web Services Management Console

要查看有关特定弹性集群快照的信息，请使用 Amazon Web Services Management Console：

  1. 登录 Amazon Web Services Management Console 并打开 Amazon DocumentDB 控制台。

  2. 在导航窗格中，选择快照。

    提示

    如果您在屏幕左侧没有看到导航窗格，请在导航窗格左上角选择菜单图标。

  3. 在快照页面上，通过点击快照标识符列中的名称，从列表选择您的快照。

  4. 在详情中查看您的快照信息。

    图：弹性集群视图快照
Using the Amazon CLI

要使用查看有关特定弹性集群快照的信息 Amazon CLI，请使用带有以下参数的get-cluster-snapshot操作：

  • --snapshot-arn – 必填项。您要获取其信息的快照的 ARN 标识符。

在以下示例中，将每个用户输入占位符替换为您自己的信息。

对于 Linux、macOS 或 Unix：

aws docdb-elastic get-cluster-snapshot \
    --snapshot-arn sampleResourceName

对于 Windows：

aws docdb-elastic get-cluster-snapshot ^
    --snapshot-arn sampleResourceName

要使用查看有关特定弹性集群快照的信息 Amazon CLI，请使用带有以下参数的get-cluster-snapshot操作：

  • --snapshot-arn – 必填项。您要获取其信息的快照的 ARN 标识符。

在以下示例中，将每个用户输入占位符替换为您自己的信息。

对于 Linux、macOS 或 Unix：

aws docdb-elastic get-cluster-snapshot \
    --snapshot-arn sampleResourceName

对于 Windows：

aws docdb-elastic get-cluster-snapshot ^
    --snapshot-arn sampleResourceName

要使用查看有关所有弹性集群快照的信息 Amazon CLI，请使用带有以下参数的list-cluster-snapshots操作：

  • --snapshot-type—可选。要返回的数据库集群快照的类型。可以指定以下值之一：

    • automated-返回 Amazon DocumentDB 自动为您的 Amazon 账户创建的所有集群快照。

    • manual-返回您为 Amazon 账户手动创建的所有集群快照。

    • shared-返回已共享到您的 Amazon 账户的所有手动集群快照。

    • public – 返回已标记为公有的所有集群快照。

  • --next-token—可选。由之前的请求提供的可选分页标记。如果指定此参数，则响应仅包含令牌之外的记录，最大数量为 max-results 指定的值。

  • --max-results—可选。包括在响应中的最大记录数。如果存在的记录数超过了指定的max-results 值，则在响应中包含分页记号（next-token），以便检索剩余的结果。

    • 默认值：100

    • 最小值 20，最大值 100

在以下示例中，将每个用户输入占位符替换为您自己的信息。

对于 Linux、macOS 或 Unix：

aws docdb-elastic list-cluster-snapshots \
    --snapshot-type  value \
    --next-token  value \
    --max-results 50

对于 Windows：

aws docdb-elastic list-cluster-snapshots ^
    --snapshot-type  value ^
    --next-token  value ^
    --max-results 50

从快照还原弹性集群

在本节中，我们将按照以下说明说明如何使用 Amazon Web Services Management Console 或 Amazon CLI 从快照恢复弹性集群。

Using the Amazon Web Services Management Console

使用 Amazon Web Services Management Console 从快照还原弹性集群：

  1. 登录 Amazon Web Services Management Console 并打开 Amazon DocumentDB 控制台。

  2. 在导航窗格中，选择快照。

    提示

    如果您在屏幕左侧没有看到导航窗格，请在导航窗格左上角选择菜单图标。

  3. 在快照标识符 中，选择要用于还原集群的快照左侧的按钮。

  4. 选择操作，然后还原。

    图：从快照恢复弹性集群

  5. 在还原快照页面上，在集群标识符字段中输入新集群的名称。

    注意

    对于任何手动快照恢复，您必须创建一个新集群。

  6. 在虚拟私有云 (VPC)字段中，从下拉列表中选择一个 VPC。

  7. 对于子网和 VPC 安全组，您可以使用默认值或选择您选定的三个子网和多达三个 VPC 安全组（最少一个）。

  8. 如果您对集群配置满意，请选择 Restore cluster (还原集群) 并等待集群还原。

Using the Amazon CLI

要使用从快照恢复弹性集群 Amazon CLI，请使用带有以下参数的restore-cluster-from-snapshot操作：

  • --cluster-name – 必填项。创建期间输入或上次修改的弹性集群的当前名称。

  • --snapshot-arn – 必填项。正用于恢复集群的快照的 ARN 标识符。

  • --vpc-security-group-ids—可选。与该集群待关联的一个或多个 Amazon EC2 安全组和 Amazon VPC (VPC) 安全组。

  • --kms-key-id—可选。配置已加密集群的 KMS 密钥标识符。

    KMS 密钥标识符是 Amazon KMS 加密密钥的亚马逊资源名称 (ARN)。如果使用拥有用于加密新集群的 KMS 加密密钥的同一 Amazon Web Services 账户创建集群，则可以使用 KMS 密钥别名而不是 KMS 加密密钥的 ARN。

    如果中未指定加密密钥， KmsKeyId 且StorageEncrypted参数为真，则 Amazon DocumentDB 将使用您的默认加密密钥。

  • --subnet-ids—可选。网络子网 ID。

在以下示例中，将每个用户输入占位符替换为您自己的信息。

对于 Linux、macOS 或 Unix：

aws docdb-elastic restore-cluster-from-snapshot \
     --cluster-name elastic-sample-cluster \
     --snapshot-arn sampleResourceName \
     --vpc-security-group-ids value ec-65f40350 \
     --kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 \
     --subnet-ids subnet-9253c6a3, subnet-9f1b5af9

对于 Windows：

aws docdb-elastic restore-cluster-from-snapshot ^
     --cluster-name elastic-sample-cluster ^
     --snapshot-arn sampleResourceName ^
     --vpc-security-group-ids value ec-65f40350 ^
     --kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ^
     --subnet-ids subnet-9253c6a3, subnet-9f1b5af9

复制弹性集群快照

在 Amazon DocumentDB 中，您可以在同一区域和同一账户内复制手动和自动弹性集群快照。在本节中，我们将说明如何使用 Amazon Web Services Management Console 或复制弹性集群快照 Amazon CLI。

Using the Amazon Web Services Management Console

要使用以下方法复制弹性集群快照 Amazon Web Services Management Console：

  1. 登录 Amazon Web Services Management Console 并打开 Amazon DocumentDB 控制台。

  2. 在导航窗格中，选择快照。

    提示

    如果您在屏幕左侧没有看到导航窗格，请在导航窗格左上角选择菜单图标。

  3. 在 “快照标识符” 列中，选择要复制的快照左侧的按钮。

  4. 选择操作，然后选择复制。

    图：弹性集群副本快照

  5. 在 “新快照标识符” 中，输入新快照的名称。

  6. 对于复制标签，如果您要将所有标签从源弹性集群快照复制到目标弹性集群快照，请选中该复选框。

  7. 对于加密，请选择默认 Amazon KMS 密钥或 KMS 密钥。第二个选项允许您选择已创建的现有 KMS 密钥或允许您创建新的密钥。

  8. 完成后选择 “复制快照”。

Using the Amazon CLI

要使用复制弹性集群快照 Amazon CLI，请使用带有以下参数的copy-cluster-snapshot操作：

  • ‐‐source-db-cluster-snapshot-identifier – 必填项。正在复制的现有弹性集群快照的标识符。弹性集群快照必须存在且处于可用状态。如果您要将快照复制到另一个快照 Amazon Web Services 区域，则此标识符必须采用源的 ARN 格式。 Amazon Web Services 区域此参数不区分大小写。

  • ‐‐target-db-cluster-snapshot-identifier – 必填项。要从现有集群快照创建的新弹性集群快照的标识符。此参数不区分大小写。

    目标快照名称限制：

    • 不能是现有快照的名称。

    • 长度为 [1—63] 个字母、数字或连字符。

    • 第一个字符必须是字母。

    • 不能以连字符结束或包含两个连续连字符。

在以下示例中，将每个用户输入占位符替换为您自己的信息。

对于 Linux、macOS 或 Unix：

aws docdb-elastic copy-cluster-snapshot \
     ‐‐source-cluster-snapshot-arn <sample ARN> \
     ‐‐target-cluster-snapshot-name my-target-copied-snapshot

对于 Windows：

aws docdb-elastic copy-cluster-snapshot ^
     ‐‐source-cluster-snapshot-arn <sample ARN> ^
     ‐‐target-cluster-snapshot-name my-target-copied-snapshot

删除弹性集群快照

在本节中，我们将说明如何使用 Amazon Web Services Management Console 或删除弹性集群快照 Amazon CLI。

Using the Amazon Web Services Management Console

使用 Amazon Web Services Management Console 从快照还原弹性集群：

  1. 登录 Amazon Web Services Management Console 并打开 Amazon DocumentDB 控制台。

  2. 在导航窗格中，选择快照。

    提示

    如果您在屏幕左侧没有看到导航窗格，请在导航窗格左上角选择菜单图标。

  3. 在快照标识符 中，选择要用于还原集群的快照左侧的按钮。

  4. 选择操作，然后选择删除。

    图：弹性集群删除快照

  5. 在删除“快照名称”快照对话框中，选择删除。

Using the Amazon CLI

要使用删除弹性集群快照 Amazon CLI，请使用带有以下参数的delete-cluster-snapshot操作：

  • --snapshot-arn – 必填项。正用于恢复集群的快照的 ARN 标识符。

在以下示例中，将每个用户输入占位符替换为您自己的信息。

对于 Linux、macOS 或 Unix：

aws docdb-elastic delete-cluster-snapshot \
     --snapshot-arn sampleResourceName

对于 Windows：

aws docdb-elastic delete-cluster-snapshot ^
     --snapshot-arn sampleResourceName

管理弹性集群快照自动备份

Amazon DocumentDB 会为您的弹性集群拍摄每日快照。您可以在新的或现有的弹性集群快照配置中指定首选备份窗口和备份保留期。在本节中，我们将说明如何使用 Amazon Web Services Management Console 或在弹性集群快照中设置自动备份参数 Amazon CLI。

Using the Amazon Web Services Management Console

要为新的弹性集群快照设置自动备份，请使用 Amazon Web Services Management Console：

  1. 登录 Amazon Web Services Management Console 并打开 Amazon DocumentDB 控制台。

  2. 在导航窗格中，选择集群。

    提示

    如果您在屏幕左侧没有看到导航窗格，请在导航窗格左上角选择菜单图标。

  3. 在集群标识符列中，选择要更改其备份设置的集群左侧的按钮。

  4. 选择操作，然后选择修改。

  5. 在 Backup 部分，根据您的备份要求编辑字段。

    显示用于配置集群备份时段的步骤的“Backup (备份)”窗格屏幕截图。

    1. 备份留存期 — 在列表中，选择在删除此集群的自动备份前保留它们的天数。

    2. 备份时段 — 设置 Amazon DocumentDB 要备份此集群的每日时间和持续时间。

      1. 如果要配置创建备份的时间和持续时间，请选择 “选择窗口”。

        开始时间 — 在第一个列表中，选择开始自动备份的开始时间小时 (UTC)。在第二个列表中，选择您希望自动备份开始的时间（分钟）。

        持续时间 — 在该列表中，选择要向创建自动备份分配的小时数。

      2. 如果您希望 Amazon DocumentDB 选择创建备份的时间和持续时间，请选择 “无首选项”。

  6. 完成后选择修改集群。

Using the Amazon CLI

要使用为新的弹性集群快照设置自动备份 Amazon CLI，请使用带有以下参数的create-cluster-snapshot操作：

  • --preferred-backup-window—可选。创建自动备份的每日首选时间范围。默认值是从 8 小时的时间段中随机选择一个 30 分钟的窗口。 Amazon Web Services 区域

    约束：

    • 必须采用 hh24:mi-hh24:mi 格式。

    • 必须采用通用协调时间（UTC）。

    • 不得与首选维护时段冲突。

    • 必须至少为 30 分钟。

  • --backup-retention-period — 可选。自动备份的保留天数。默认值是 1。

    约束：

    • 必须将最小值指定为 1。

    • 范围介于 1 到 35 之间。

注意

只有当集群处于 “活动” 状态时，才会进行自动备份。

注意

您也可以使用aws docdb-elastic update-cluster命令修改现有弹性集群的preferred-backup-window和backup-retention-period参数。

在以下示例中，将每个用户输入占位符替换为您自己的信息。

以下create-cluster示例创建了 Amazon DocumentDB 弹性集群示例集群，其自动备份的保留期为 7 天，首选备份窗口为世界标准时间 18:00- 18:30。

对于 Linux、macOS 或 Unix：

aws docdb-elastic create-cluster \
     --cluster-name sample-cluster \
     --shard-capacity 2 \
     --shard-count 2 \
     --admin-user-name SampleAdmin \
     --auth-type PLAIN_TEXT \
     --admin-user-password SamplePass123! \
     --preferred-backup-window 18:00-18:30 \ 
     --backup-retention-period 7

对于 Windows：

aws docdb-elastic create-cluster ^
     --cluster-name sample-cluster ^
     --shard-capacity 2 ^
     --shard-count 2 ^
     --admin-user-name SampleAdmin ^
     --auth-type PLAIN_TEXT ^
     --admin-user-password SamplePass123! ^
     --preferred-backup-window 18:00-18:30 ^ 
     --backup-retention-period 7