初始化Job任务

描述


此操作用于新建指定类型的Job任务，类型有archive-retrieval、inventory-retrieval、pull-from-oss和push-to-oss四种。其中archive-retrieval对应的Job Output是可下载的Archive数据，inventory-retriveval对应的Job Output是Archive列表， pull-from-oss对应的Job执行结果是归档存储直接将用户OSS上的Object迁移到归档存储上，push-to-oss对应的Job执行结果是归档存储直接将用户的数据迁移到用户指定的OSS Bucket。 pull-from-oss与push-to-oss两种类型的Job属于跨产品数据传输，用户务必要授权归档存储对用户OSS的访问权限。 Job的创建与执行是两个异步的过程：

1. 新建指定类型Job，新建Job成功以后，Job进入数据准备状态，服务端会返回对应的Job ID。
2. Job执行完成后：如果Job类型为archive-retrieval和inventory-retrieval，用户可下载Job Output；如果Job类型为pull-from-oss用户的OSS数据会迁移到归档存储上；如果Job类型为push-to-oss，用户在归档存储上的数据会迁移到OSS上。
3. Job自准备完成，保留24个小时的有效期，超出以后，Job不可再访问。

请求参数


无

请求头部


无，其他公共请求头部参见2.4.1

请求体

• [backcolor=transparent]ArchiveId

需要下载的Archive ID，当Job类型为inventory-retrieval或pull-from-oss时，则不需要此参数

• [backcolor=transparent]Description

Job描述信息，非必需

• [backcolor=transparent]Type

Job的类型，分archive-retrieval，inventory-retrieval，pull-from-oss和push-to-oss四种类型

• [backcolor=transparent]RetrievalByteRange

archive-retrieval类型Job需要取出的数据字节范围，格式为”StartByte-EndByte”，StartByte必须能够被1MB整除；EndBytes加1，必须能够被1MB或Archive总字节数整除。如果不指定该字段，默认取回全部Archive。
如果该字段不符合格式，或在inventory-retrieval类型Job中指定该字段，请求会返回错误。当Job类型为pull-from-oss或push-to-oss类型，则不需要此参数。

• [backcolor=transparent]OSSHost

pull-from-oss，push-to-oss类型Job需要指明OSS的域名，该OSS域名必须为阿里云内网域名，且与所访问归档存储的域名在同一region, 如： 用户访问归档存储的域名为cn-hangzhou.oas-internal.aliyuncs.com，则oss-cn-hangzhou-internal.aliyuncs.com是合法的OSS域名，而oss-cn-beijing-internal.aliyuncs.com，oss-cn-hangzhou.aliyuncs.com为不支持的OSS域名。当Job类型为archive-retrieval或inventory-retrieval类型，则不需要此参数。

• [backcolor=transparent]Bucket

pull-from-oss，push-to-oss类型Job需要指明OSS的Bucket，用户需要确保该Bucket已经对OAS授予了访问权限。当Job类型为archive-retrieval或inventory-retrieval类型，则不需要此参数。

• [backcolor=transparent]Object

pull-from-oss，push-to-oss类型Job需要指明所需要迁移的对象存储OSS的Object。 用户需要注意的是，提交push-to-oss类型Job，需要确保不出现重名的Object，否则，该Object会被覆盖。当Job类型为archive-retrieval或inventory-retrieval类型，则不需要此参数。

返回头部

名称	描述
Location	已经合并的文档URI路径
x-oas-job-id	Job的ID，这个值也被置于Location中

其他公共返回头部参见2.4.2

返回体


无

示例


请求示例 POST /vaults/[VaultId]/jobs HTTP/1.1
Host: cn-hangzhou.oas.aliyuncs.com
Date: Tue, 25 Mar 2014 12:00:00 GMT
x-oas-version: 2014-01-01
Authorization: [SignatureValue]
{
  "Type": "archive-retrieval",
  "ArchiveId": "ArchiveId",
  "Description": "MyArchive",
  "RetrievalByteRange": "0-1024"
}

或 {
  "Type": "inventory-retrieval",
  "Description": "MyInventory"
}

或 {
    "Type": "pull-from-oss",
    "Description": "My First pull-from-oss Archive",
    "OSSHost": "cn-hangzhou.oas-internal.aliyuncs.com",
    "Bucket": "oastest",
    "Object": "smallfile"
}

或 {
    "Type": "push-to-oss",
    "Description": "My First push-to-oss Archive",
    "OSSHost": "cn-hangzhou.oas-internal.aliyuncs.com",
    "Bucket": "oastest",
    "ArchiveId":  "BD2FBC11A9D078CE50E95396EDD4BDCAD5AB7E0380DA4587B872B4F5B99ADCAD3E855350FBBDDFD4D8FDD2974BF68783AD8B2321692A5F6F65E02815D9170C33",
    "Object": "BD2FBC11A"
}

返回示例 HTTP/1.1 202 Accepted
x-oas-request-id: [RequestId]
Date: Tue, 25 Mar 2014 12:00:00 GMT
Location: /vaults/[VaultId]/jobs/[JobID]
x-oas-job-id: [JobID]