1. List Bucket Multipart Uploads

1.1. 描述

该接口所有执行中的Multipart Upload事件，即已初始化但未被完成或放弃的Multipart Upload事件。

1.2. 请求地址

GET /{bucket}?uploads

1.3. 请求头

请求头信息请参考【公共参数】部分。

1.4. 请求参数

Name	Type	Description	Required
delimiter	String	分割符，用来对Object进行分组，前缀与第一次出现delimiter字符之间的object将作为一组	否
prefix	String	限定返回包含特定前缀的object key	否
maxUploads	Integer	限定返回Muitipart Uploads事件的最大数目，范围为1-1000，默认值为1000	否
keyMarker	String	与uploadIdMarker参数一同使用，指定返回结果的起始位置。若uploadIdMarker参数未设置，则结果为在所有key的字典顺序中，大于keyMarker对象的所有MultiPart Uploads事件；若uploadIdMarker参数设定了，则结果可分为两部分，一部分为在所有key的字典顺序中，大于keyMaker值的对象的所有Multipart Uploads事件，另一部分为key等于keyMarker且其uploadId值大于uploadIdMarker的对象的所有Multipart Uploads事件。	否
uploadIdMarker	String	UploadIdMarker参数与keyMarker参数一同使用。若keyMarker没有指定，uploadIdMarker则忽略，若keyMarker已指定，则返回结果为在所有key的字典顺序中，返回大于keyMarker值的对象的所有Multipart Uploads事件和key等于keyMarker且其uploadId值大于uploadIdMarker的对象的所有Multipart Uploads事件。	否
encodingType	String	指定对返回内容的编码类型，可以通过encodingType对返回的参数内容进行编码。	否

1.5. 响应头

该响应头信息请参考【公共参数】部分。

1.6. 响应体

Name	Type	Description
bucketName	String	Bucket名称
keyMarker	String	请求参数中的keyMarker值
delimiter	String	值同请求参数中的delimiter
prefix	String	值同请求参数中的prefix
uploadIdMarker	String	值同请求参数中的uploadIdMarker
maxUploads	int	设置最大的返回multipart数量，maxUploads请求参数指定的值
encodingType	String	返回结果的编码类型
isTruncated	Boolean	如果结果已全部返回，值为false；如果返回部分结果，值为true
nextKeyMarker	String	下一次请求keyMarker的值
nextUploadIdMarker	String	下一次请求uploadIdMarker的值
multipartUploads	List	Bucket内multipartUpload事件信息
commonPrefixes	List	前缀与分割符之间相同的内容集合

multipartUploads对象中的内容

Name	Type	Description
key	String	对象的名称
uploadId	String	一次上传对应的id
owner	Owner	对象所属者信息
initiator	Owner	上传发起者信息
storageClass	String	对象存储类型
initiated	Date	发起上传的时间

1.7. 请求示例

GET /bucket123?uploads&uploads&delimiter=%2F&maxUploads=5 HTTP/1.1
Host: cn-east-1.cloud-oss.com
Date: Thu, 15 Nov 2018 13:27:48 GMT
Nonce: 5e72e157-f4e3-4180-9062-7c7127939faa
Authorization: YCS1-HMAC-SHA1 Credential=5adb2538-9333-4024-b757-e095fc609a84, SignedHeaders=date;nonce;version, Signature=5KmNSmZ7/vlWNti0cgNpJFiQNMY=
Version: 2018-10-30

1.8. 返回结果

1.8.1. 返回正确结果示例

{
    "bucketName": "bucket123",
    "commonPrefixes": [
    ],
    "delimiter": "/",
    "maxUploads": 5,
    "multipartUploads": [
        {
            "initiated": 1534990213118,
            "initiator": {
                "displayName": "PRJ2",
                "id": "PRJ2"
            },
            "key": "1534846566426.jpg",
            "owner": {
                "displayName": "PRJ2",
                "id": "PRJ2"
            },
            "storageClass": "STANDARD",
            "uploadId": "2~nxfvQVuLAFI7yAKEUHXd0XwYCjE0Qkn"
        },
        {
            "initiated": 1534990232896,
            "initiator": {
                "displayName": "PRJ2",
                "id": "PRJ2"
            },
            "key": "2222.jpg",
            "owner": {
                "displayName": "PRJ2",
                "id": "PRJ2"
            },
            "storageClass": "STANDARD",
            "uploadId": "2~FSmtsupn50ORxh1pRNa7jgniwzKPW7V"
        }
    ],
    "nextKeyMarker": "QQ_V6.5.0.dmg",
    "nextUploadIdMarker": "2~whZ8L8XsLmZjRiBgcWkpXbXLHumLh12",
    "truncated": false
}

1.9. 错误码

该接口没有特殊错误码，错误码可以参考公共错误码

List Bucket Multipart Uploads