更新时间:2024-04-15 GMT+08:00

取消多段上传任务

功能介绍

如果用户希望取消一个任务,可以调用取消多段上传任务接口取消任务。合并段或取消任务接口被调用后,用户不能再对任务进行上传段和列举段的操作。

请求消息样式

1
2
3
4
DELETE /ObjectName?uploadId=uplaodID HTTP/1.1 
Host: bucketname.obs.region.example.com
Date: date
Authorization: auth

请求消息参数

该请求通过消息参数,指定要取消的段任务的多段上传任务号,参数的意义如表1所示。

表1 请求消息参数

参数名称

描述

是否必选

uploadId

指明多段上传任务。

类型:String

请求消息头

该请求使用公共消息头,具体请参考表3

请求消息元素

该请求消息中不使用消息元素。

响应消息样式

HTTP/1.1 status_code
Date: date

响应消息头

该请求的响应消息使用公共消息头,具体请参考表1

响应消息元素

该请求的响应消息中不带消息元素。

错误响应消息

  1. 如果AccessKey或签名无效,OBS返回403 Forbidden,错误码为AccessDenied。
  2. 如果请求的桶不存在,OBS返回404 Not Found,错误码为NoSuchBucket。
  3. 用户执行取消多段上传任务操作时判断用户是否是任务初始化者或是桶的所有者,如果不是则OBS则返回403 Forbidden。
  4. 操作成功,OBS向用户返回204 No Content。

其他错误已包含在表2中。

请求示例

1
2
3
4
5
6
DELETE /object02?uploadId=00000163D46218698DF407362295674C HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.example.com
Accept: */*
Date: WED, 01 Jul 2015 05:28:27 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:QmM2d1DBXZ/b8drqtEv1QJHPbM0=

响应示例

1
2
3
4
5
HTTP/1.1 204 No Content
Server: OBS
x-obs-request-id: 8DF400000163D463E02A07EC2295674C
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCTp5YDlzn0UgqG3laRfkHLGyz7RpR9ON
Date: WED, 01 Jul 2015 05:28:27 GMT