list-bucket-multipart-uploads

List Bucket Multipart Uploads

1. 描述

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

2. 请求地址

GET /{bucket}?uploads

3. 请求头

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

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对返回的参数内容进行编码。

5. 响应头

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

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 发起上传的时间

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

8. 返回示例

{
    "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
}

9. 错误码

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

个结果匹配 ""

    无结果匹配 ""