本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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 天。将备份转换为冷备份后,无法更改天后过渡到冷的设置。
按资源划分的功能可用性表中列出了可以过渡到冷存储的资源类型。 Amazon Backup 对于其他资源类型,将忽略此表达式。
要删除现有的生命周期和保留期并无限期保留恢复点,请为和指定 -1。
MoveToColdStorageAfterDays
DeleteAfterDays
类型:Lifecycle 对象
必需:否
- RecoveryPointArn
-
唯一标识用于拷贝作业的恢复点;例如ARN,arn: aws: backup: us-east-1:123456789012: recovery-point:1 -9EB0-435A-A80B-108B488B0D45。EB3B5E7
类型:字符串
必需:是
- 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
另请参阅
有关API在一种特定语言中使用此功能的更多信息 Amazon SDKs,请参阅以下内容: