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

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

StartCopyJob

启动任务以创建指定资源的一次性副本。

不支持连续备份。

请求语法

PUT /copy-jobs HTTP/1.1
Content-type: application/json

{
   "DestinationBackupVaultArn": "string",
   "IamRoleArn": "string",
   "IdempotencyToken": "string",
   "Lifecycle": { 
      "DeleteAfterDays": number,
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   },
   "RecoveryPointArn": "string",
   "SourceBackupVaultName": "string"
}

URI 请求参数

该请求不使用任何 URI 参数。

请求体

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

DestinationBackupVaultArn

唯一标识要复制到的目的地备份保管库的 Amazon 资源名称 (ARN)；例如，arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault。

类型：字符串

必需：是

IamRoleArn

指定用于复制目标恢复点的 IAM 角色 ARN；例如，arn:aws:iam::123456789012:role/S3Access

类型：字符串

必需：是

IdempotencyToken

客户选择的字符串，可用于区分对 StartCopyJob 的其他相同调用。使用相同的幂等性令牌重试成功的请求会生成一条成功消息，而不执行任何操作。

类型：字符串

必需：否

Lifecycle

指定恢复点过渡到冷存储或被删除之前的时间段（以天为单位）。

转换到冷存储的备份必须在冷存储中存储至少 90 天。因此，在主机上，保留期设置必须比在几天后过渡到冷藏设置长 90 天。将备份转换为冷备份后，无法更改天后过渡到冷的设置。

按资源划分的功能可用性表中列出了可以过渡到冷存储的资源类型。 Amazon Backup 对于其他资源类型，将忽略此表达式。

要删除现有的生命周期和保留期并无限期保留恢复点，请为和指定 -1。MoveToColdStorageAfterDays DeleteAfterDays

类型：Lifecycle 对象

必需：否

RecoveryPointArn

一个唯一标识用于复制作业的恢复点的 ARN；例如，arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45。

类型：字符串

必需：是

SourceBackupVaultName

用于存储备份的逻辑源容器的名称。Backup 存储库由用于创建备份存储库的账户和创建备份存储库的 Amazon 区域所特有的名称进行标识。名称包含小写字母、数字和连字符。

类型：字符串

模式：^[a-zA-Z0-9\-\_]{2,50}$

必需：是

响应语法

HTTP/1.1 200
Content-type: application/json

{
   "CopyJobId": "string",
   "CreationDate": number,
   "IsParent": boolean
}

响应元素

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

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

CopyJobId

唯一标识复制作业。

类型：字符串

CreationDate

复制作业的创建日期和时间，采用 Unix 时间格式和协调世界时 (UTC)。CreationDate 的值精确到毫秒。例如，值 1516925490.087 表示 2018 年 1 月 26 日星期五上午 12:11:30.087。

类型：时间戳

IsParent

这是一个返回的布尔值，表示这是父（复合）复制作业。

类型：布尔值

错误

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

InvalidParameterValueException

表示参数的值有问题。例如，该值超出了范围。

HTTP 状态代码：400

InvalidRequestException

表示请求的输入有问题。例如，参数的类型错误。

HTTP 状态代码：400

LimitExceededException

已超过请求中的限制；例如，请求中允许的最大项目数。

HTTP 状态代码：400

MissingParameterValueException

表示缺少必需的参数。

HTTP 状态代码：400

ResourceNotFoundException

该操作所需的资源不存在。

HTTP 状态代码：400

ServiceUnavailableException

由于服务器发生临时故障而导致请求失败。

HTTP 状态代码：500

另请参阅

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