如何获取Multipart Upload任务列表（GET）

描述

此操作会列出指定Vault中正在进行的Multipart Upload任务。正在进行的Multipart Upload任务是成功启动Multipart Upload，但尚未完成的任务。默认情况下，此操作返回的列表中最多会有1000个Multipart Upload任务，列表按Upload ID升序排列。用户应始终检查返回体中的Marker字段，该字段可以在新的请求中作为获取下一个列表的起点；如果Marker为””（空串），则表示列表已全部获取完成。用户还可以通过设置limit 参数来限制每次请求返回的Multipart Upload任务数量，但是limit 不能超过1000，如果超过1000，按1000处理。

请求参数

名称	是否必须	描述
limit	否	指定列表返回数量的上限。如果未指定，则最多会返回1000个Upload任务。当用户设置大于1000时，当1000处理
marker	否	指定本次请求列表的起始位置。第一次请求列表时，不需要带上marker；当返回体提示Marker不为空串（””）时，第二次请求带上之前返回体中的Marker值就可以获取后续列表。当marker对应ID不存在时，会报异常。

请求头部

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

请求体

无

返回头部

无，其他公共返回头部参见2.4.2

返回体

[backcolor=transparent]Marker

下一次列表请求的起始标记，空串（””）表示无后续的列表

[backcolor=transparent]UploadsList

Multipart Upload请求元数据数组，以下是元数据的字段

[backcolor=transparent]ArchiveDescription

多段上传时提供的Archive描述信息

[backcolor=transparent]CreationDate

多段上传任务的创建时间

[backcolor=transparent]PartSizeInBytes

初始化时指定的段大小

[backcolor=transparent]MultipartUploadId

多段上传任务的ID

示例

请求示例

GET /vaults/[VaultId]/multipart-uploads HTTP/1.1 
Host: cn-hangzhou.oas.aliyuncs.com 
Date: Tue, 25 Mar 2014 12:10:00 GMT 
x-oas-version: 2014-01-01 
Authorization: [SignatureValue]

返回示例

HTTP/1.1 200 OK
x-oas-request-id: [RequestId]
Date: Tue, 25 Mar 2014 12:10:00 GMT
Content-Type: application/json
Content-Length: 451
{
    "Marker": "", 
    "UploadsList": 
    [{
        "ArchiveDescription": "MyArchive1",
        "CreationDate": "Tue, 25 Mar 2014 12:02:00 GMT",
        "MultipartUploadId”: "28E23B4C061D457094AD16F8D0988826",
        "PartSizeInBytes": 68157440
    }, 
    {
        "ArchiveDescription": "MyArchive2",
        "CreationDate": "Tue, 25 Mar 2014 12:02:00 GMT",
        "MultipartUploadId": "5RX99B4C061D457894AD16F8D0977737",
        "PartSizeInBytes": 68157440
    }]
}

带limit的请求示例

GET /vaults/[VaultId]/multipart-uploads?limit=1 HTTP/1.1 
Host: cn-hangzhou.oas.aliyuncs.com 
Date: Tue, 25 Mar 2014 12:10:00 GMT 
x-oas-version: 2014-01-01 
Authorization: [SignatureValue]

返回示例

HTTP/1.1 200 OK
x-oas-request-id: [RequestId]
Date: Tue, 25 Mar 2014 12:10:00 GMT
Content-Type: application/json
Content-Length: 272
{
    "Marker": "5RX99B4C061D457894AD16F8D0977737", 
    "UploadsList": 
    [{
        "ArchiveDescription": "MyArchive1",
        "CreationDate": "Tue, 25 Mar 2014 12:02:00 GMT",
        "MultipartUploadId": "28E23B4C061D457094AD16F8D0988826",
        "PartSizeInBytes": 68157440
    }]
}

带limit和marker的请求示例

GET /vaults/[VaultId]/multipart-uploads?limit=1&marker=5RX99B4C061D457894AD16F8D0977737 HTTP/1.1 
Host: cn-hangzhou.oas.aliyuncs.com 
Date: Tue, 25 Mar 2014 12:10:00 GMT 
x-oas-version: 2014-01-01 
Authorization: [SignatureValue]

返回示例

HTTP/1.1 200 OK
x-oas-request-id: [RequestId]
Date: Tue, 25 Mar 2014 12:10:00 GMT
Content-Type: application/json
Content-Length: 240
{
    "Marker": "", 
    "UploadsList": 
    [{
        "ArchiveDescription": "MyArchive2",
        "CreationDate": "Tue, 25 Mar 2014 12:02:00 GMT",
        "MultipartUploadId": "5RX99B4C061D457894AD16F8D0977737",
        "PartSizeInBytes": 68157440
    }]
}

如何获取Multipart Upload任务列表（GET）

相关文章

相关电子书