接口介绍
查询正在进行中的分段上传。
接口约束
支持的线上资源池 ：上海7、南京3、南京5、杭州2、合肥2、九江、广州6、武汉4、福州25、厦门3、郴州2、海口2、北京5、雄安2、石家庄20、内蒙6、晋中、辽阳1、西安5、乌鲁木齐4、乌鲁木齐27、中卫5、兰州2、西宁2、拉萨3、昆明2、重庆2、成都4、贵州3、上海33、宁波边缘云、华东1、上海36、南昌5、青岛20、武汉41、长沙42、长沙37、南宁23、北京行业云20、华北2、西南1、上海32。
URI
GET /v4/oss/list-multipart-uploads
请求参数
请求 Query 参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 |
|---|---|---|---|---|
| bucket | 是 | String | 桶名 | bucket1 |
| regionID | 是 | String | 区域 ID | 332232eb-63aa-465e-9028-52e5123866f0 |
| keyMarker | 否 | String | 只有Key大于KeyMarker的分段上传数据才会返回 | nextkeyfrompreviousresponse |
| maxUploads | 否 | Integer | 单次最多返回的分段上传数据，大小是1-1000，超过1000的数据会被视为1000 | 333 |
| prefix | 否 | String | Key的前缀，只有以Prefix为开头的Key才会被返回 | hello_ |
响应参数
| 参数 | 参数类型 | 说明 | 示例 |
|---|---|---|---|
| statusCode | Integer | 返回码 取值范围：800 成功 |
800 |
| message | String | 状态描述 | SUCCESS |
| description | String | 状态描述，一般为中文 | 成功 |
| returnObj | Object | 响应对象 | 见下级对象 |
| errorCode | String | 业务细分码（仅失败时具有此参数），为product.module.code三段式码 | openapi.userPermission.accessFailed |
表 returnObj
| 参数 | 参数类型 | 说明 | 示例 |
|---|---|---|---|
| bucket | String | 启动分段上传的桶的名称 | bk1 |
| keyMarker | String | 列表开始处或之后的 key | xciuvysaduhfgb |
| uploadIDMarker | String | 列出 uploadID 之后的分段 | sxcuyvibsdhyuifbe |
| nextKeyMarker | String | 当列表被截断时，此元素指定应用于后续请求中的 key 标记请求参数的值 | xciuyvyasdbuhrgweuyuya |
| nextUploadIDMarker | String | 当列表被截断时，此元素指定应用于后续请求中的 upload-id-marker 请求参数的值 | fcvobeiuowertdf |
| maxUploads | Integer | 可以包含在响应中的分段上传的最大数量 | 22 |
| isTruncated | Boolean | 指示返回的分段列表是否被截断。值为 true 表示列表已被截断。如果分段上传的数量超过最大上传允许或指定的限制，则可以截断该列表 | false |
| uploads | Array of Objects | 与特定分段上传相关的元素的容器。响应可以包含零个或多个 Upload 元素 | 见下级对象 |
表 uploads
| 参数 | 参数类型 | 说明 | 示例 |
|---|---|---|---|
| uploadID | String | uploadID | xcviuywsierbyhdfg |
| key | String | 对象名 | obj1 |
| initiated | String | 分段上传初始化时间，ISO-8601 格式的日期字符串 | 2022-10-18T02:24:40Z |
| storageClass | String | 存储类，可选的值由 STANDARD, STANDARD_IA, GLACIER | |
| owner | Object | 所有者 | 见下级对象 |
| initiator | Object | 初始化分段上传事件的用户 | 见下级对象 |
表 owner
| 参数 | 参数类型 | 说明 | 示例 |
|---|---|---|---|
| displayName | String | 展示名称 | dname1 |
| ID | String | 用户ID | user1 |
表 initiator
| 参数 | 参数类型 | 说明 | 示例 |
|---|---|---|---|
| displayName | String | 展示名称 | dname2 |
| ID | String | 用户ID | user2 |
请求示例
GET https://zos-global.ctapi.ctyun.cn/v4/oss/list-multipart-uploads?bucket=bucket1®ionID=332232eb-63aa-465e-9028-52e5123866f0&keyMarker=nextkeyfrompreviousresponse&maxUploads=333&prefix=hello_
响应示例
{
"returnObj": {
"bucket": "bucket1",
"keyMarker": "nextkeyfrompreviousresponse",
"uploadIDMarker": "sxcuyvibsdhyuifbe",
"nextKeyMarker": "xciuyvyasdbuhrgweuyuya",
"nextUploadIDMarker": "fcvobeiuowertdf",
"maxUploads": 22,
"isTruncated": true,
"uploads": [
{
"uploadID": "xcviuywsierbyhdfg",
"key": "obj1",
"initiated": "2022-10-18T02:24:40Z",
"storageClass": "GLACIER_IR",
"owner": {
"displayName": "dname1",
"ID": "user1"
},
"initiator": {
"ID": "dname2",
"displayName": "user2"
}
}
]
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
状态码
| 状态码 | 描述 |
|---|---|
| 800 | 表示请求成功。 |
| 900 | 表示请求失败。 |
错误码
errorCode 枚举值，见错误码总表
