CopyClusterSnapshot - Amazon DocumentDB
请求语法URI 请求参数请求体响应语法响应元素错误另请参阅
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

CopyClusterSnapshot

复制弹性集群的快照。

请求语法

POST /cluster-snapshot/snapshotArn/copy HTTP/1.1
Content-type: application/json

{
   "copyTags": boolean,
   "kmsKeyId": "string",
   "tags": { 
      "string" : "string" 
   },
   "targetSnapshotName": "string"
}

URI 请求参数

请求使用以下 URI 参数。

snapshotArn

弹性集群快照的 Amazon 资源名称（ARN）标识符。

必需：是

请求体

请求接受采用 JSON 格式的以下数据。

targetSnapshotName

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

约束：

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

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

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

例如：elastic-cluster-snapshot-5

类型：字符串

长度限制：最小长度为 1。最大长度为 63。

必需：是

copyTags

设置为 true，将源集群快照的所有标签复制到目标弹性集群快照。默认为 false。

类型：布尔值

必需：否

kmsKeyId

已加密弹性集群快照的 Amazon KMS 密钥 ID。Amazon KMS 密钥 ID 是 Amazon 资源名称 (ARN)、Amazon KMS 密钥标识符或 Amazon KMS 加密密钥的 Amazon KMS 密钥别名。

如果您从 Amazon 账户复制加密的弹性集群快照，则可以为 KmsKeyId 指定值来使用新的 Amazon KMS 加密密钥加密副本。如果您不为 KmsKeyId 指定值，则使用与源弹性集群快照相同的 AWS KMS 密钥来加密弹性集群快照的副本。

要将加密的弹性集群快照复制到另一个 Amazon 区域，请将 KmsKeyId 设置为要用于加密 Amazon 目标区域中弹性集群快照副本的 Amazon KMS 密钥 ID。KMS 加密密钥是特定于其 Amazon 创建区域的，您无法将一个 Amazon 区域中的加密密钥用于另一个 Amazon 区域。

如果您复制未加密的弹性集群快照并为 KmsKeyId 参数指定值，则会返回错误。

类型：字符串

必需：否

tags

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

类型：字符串到字符串映射

密钥长度限制：最小长度为 1。长度上限为 128。

键模式：^(?!aws:)[a-zA-Z+-=._:/]+$

值长度限制：最小长度为 0。最大长度为 256。

必需：否

响应语法

HTTP/1.1 200
Content-type: application/json

{
   "snapshot": { 
      "adminUserName": "string",
      "clusterArn": "string",
      "clusterCreationTime": "string",
      "kmsKeyId": "string",
      "snapshotArn": "string",
      "snapshotCreationTime": "string",
      "snapshotName": "string",
      "snapshotType": "string",
      "status": "string",
      "subnetIds": [ "string" ],
      "vpcSecurityGroupIds": [ "string" ]
   }
}

响应元素

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

snapshot

返回有关特定弹性集群快照的信息。

类型：ClusterSnapshot 对象

错误

有关所有操作的常见错误的信息，请参阅常见错误。

AccessDeniedException

没有足够权限执行某操作时出现的异常。

HTTP 状态代码：403

ConflictException

存在访问冲突。

HTTP 状态代码：409

InternalServerException

出现内部服务器错误。

HTTP 状态代码：500

ResourceNotFoundException

不能定位指定的资源。

HTTP 状态代码：404

ServiceQuotaExceededException

已超过该操作的服务限额。

HTTP 状态代码：402

ThrottlingException

因请求节流拒绝请求时，将抛出 throttlingException。

HTTP 状态代码：429

ValidationException

定义验证异常的结构。

HTTP 状态代码：400

另请参阅

有关在特定语言的 Amazon SDK 中使用此 API 的更多信息，请参阅以下内容：