CopyDBClusterSnapshot - Amazon DocumentDB
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

CopyDBClusterSnapshot

复制集群的快照。

要从共享手动集群快照复制集群快照,请SourceDBClusterSnapshotIdentifier必须是共享集群快照的 Amazon 资源名称 (ARN)。无论加密与否,都只能将共享的数据库集群快照复制到相同的 Amazon Web Services 区域 .

要在正在进行复制时取消操作,请删除由TargetDBClusterSnapshotIdentifier而该集群快照位于复制状态。

请求参数

有关所有操作通用的参数的信息,请参阅常见参数.

SourceDBClusterSnapshotIdentifier

要复制的集群快照的标识符。此参数不区分大小写。

约束:

  • 必须将有效的系统快照指定为可用 状态。

  • 如果源快照位于同一 Amazon Web Services 区域 作为副本,则指定有效的快照标识符。

  • 如果源快照位于其他 Amazon Web Services 区域 ,则指定有效的集群快照 ARN。

示例:my-cluster-snapshot1

类型: String

:必需 是

TargetDBClusterSnapshotIdentifier

要从源集群快照创建的新集群快照标识符​。此参数不区分大小写。

约束:

  • 必须包含 1 到 63 个字母、数字或连字符。

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

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

示例:my-cluster-snapshot2

类型: String

:必需 是

CopyTags

设置设置true将源集群快照的所有标签复制到目标集群快照,否则false. 默认为 false

类型: Boolean

:必需 否

KmsKeyId

这些区域有:Amazon KMS加密集群快照的密钥 ID。Amazon KMS 密钥 ID 是 Amazon 资源名称 (ARN)、Amazon KMS 密钥标识符或 Amazon KMS 加密密钥的 Amazon KMS 密钥别名。

如果将加密的群集快照从 Amazon Web Services 账户 ,您可以为KmsKeyId使用新的Amazon KMS加密密钥。如果您没有为KmsKeyId,集群快照副本将使用相同的Amazon KMS键作为源集群快照。

如果您复制从其他 Amazon Web Services 账户 ,则必须为KmsKeyId.

要将加密的集群快照复制到另一 Amazon Web Services 区域 ,设置KmsKeyId添加到Amazon KMS密钥 ID,您要用于对目标区域中的集群快照副本进行加密。Amazon KMS加密密钥特定于 Amazon Web Services 区域 ,并且您无法从一个 Amazon Web Services 区域 在另一个 Amazon Web Services 区域 .

如果您复制未加密的集群快照并为KmsKeyId参数,会返回一个错误。

类型: String

:必需 否

PreSignedUrl

包含签名版本 4 签名请求的 URLCopyDBClusterSnapshotAPI 操作 Amazon Web Services 区域 ,其中包含要复制的源集群快照。您必须使用PreSignedUrl参数复制集群快照时从另一个 Amazon Web Services 区域 .

如果使用AmazonSDK 工具或Amazon CLI,您可以指定SourceRegion(或--source-region(对于 )Amazon CLI)而不是指定PreSignedUrl手动。指定SourceRegion自动生成一个预签名 URL,它是可在源中执行的操作的有效请求 Amazon Web Services 区域 .

预签名 URL 必须是CopyDBClusterSnapshot可以在源代码中执行的 API 操作 Amazon Web Services 区域 ,其中包含要复制的集群快照。预签名 URL 请求必须包含以下参数值:

  • SourceRegion-包含要复制的快照的区域的 ID。

  • SourceDBClusterSnapshotIdentifier-要复制的加密集群快照的标识符。对于源,此标识符必须采用 Amazon 资源名称 (ARN) 格式 Amazon Web Services 区域 . 例如,如果您从 us-east-1 复制加密集群快照 Amazon Web Services 区域 ,然后您的SourceDBClusterSnapshotIdentifier看起来类似于以下内容:arn:aws:rds:us-east-1:12345678012:sample-cluster:sample-cluster-snapshot.

  • TargetDBClusterSnapshotIdentifier— 要创建的新集群快照的标识符。该参数不区分大小写。

类型: String

:必需 否

标签。标签 .N

要分配给集群快照的标签。

类型: 数组 Tag objects

:必需 否

响应元素

服务返回以下元素。

DBClusterSnapshot

有关集群快照的详细信息。

类型: DBClusterSnapshot 对象

Errors

有关所有操作常见错误的信息,请参阅常见错误.

DBClusterSnapshotAlreadyExistsFault

您已拥有具有给定标识符的集群快照。

HTTP 状态代码:HTTP 400

DBClusterSnapshotNotFoundFault

DBClusterSnapshotIdentifier不引用现有集群快照。

HTTP 状态代码:HTTP 404

InvalidDBClusterSnapshotStateFault

提供的值不是有效的集群快照状态。

HTTP 状态代码:HTTP 400

InvalidDBClusterStateFault

集群未处于有效状态。

HTTP 状态代码:HTTP 400

KMSKeyNotAccessibleFault

访问Amazon KMS键。

HTTP 状态代码:HTTP 400

SnapshotQuotaExceeded

请求将导致超出允许的快照数目。

HTTP 状态代码:HTTP 400

另请参阅

有关在特定语言的Amazon软件开发工具包中使用此 API 的更多信息,请参阅以下内容: