StartCopyJob - AWS Backup
请求语法URI请求参数请求正文响应语法响应元素错误另请参阅

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

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

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

类型：字符串

必需：是

IdempotencyToken

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

类型：字符串

必需：否

Lifecycle

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

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

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

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

类型：Lifecycle 对象

必需：否

RecoveryPointArn

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

类型：字符串

必需：是

SourceBackupVaultName

用于存储备份的逻辑源容器的名称。Backup 存储库由用于创建备份存储库的账户和创建备份存储库的 AWS 区域所特有的名称进行标识。

类型：字符串

模式：^[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

另请参阅

有关API在一种特定语言中使用此功能的更多信息 AWS SDKs，请参阅以下内容：