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

类型: 字符串

必需 是

TargetDBClusterSnapshotIdentifier

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

约束:

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

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

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

示例:my-cluster-snapshot2

类型: 字符串

必需 是

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 KMSkey 作为源群集快照。

如果您复制从另一个共享的加密集群快照。Amazon Web Services 账户,则必须为指定一个值。KmsKeyId.

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

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

类型: 字符串

必需 否

PreSignedUrl

包含签名版本 4 签名请求的 URLCopyDBClusterSnapshot中的 API 操作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-要创建的新集群快照的标识符。该参数不区分大小写。

类型: 字符串

必需 否

标签 s.Tag.N

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

类型: 数组Tag对象

必需 否

响应元素

服务返回以下元素。

DBClusterSnapshot

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

类型:DBClusterSnapshot 对象

错误

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

DBClusterSnapshotAlreadyExistsFault

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

HTTP 状态代码:400

DBClusterSnapshotNotFoundFault

DBClusterSnapshotIdentifier不引用现有集群快照。

HTTP 状态代码:404

InvalidDBClusterSnapshotStateFault

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

HTTP 状态代码:400

InvalidDBClusterStateFault

集群未处于有效状态。

HTTP 状态代码:400

KMSKeyNotAccessibleFault

访问Amazon KMS键。

HTTP 状态代码:400

SnapshotQuotaExceeded

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

HTTP 状态代码:400

另请参阅

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