更新时间:2024-03-05 GMT+08:00

截断对象

功能介绍

截断对象操作是指将指定文件桶内的一个对象截断到指定大小。

目前接口仅在并行文件系统支持,创建并行文件系统的方法详见请求示例:创建并行文件系统

请求消息样式

PUT /ObjectName?truncate&length=Length HTTP/1.1
Host: bucketname.obs.region.example.com
Authorization: authorization
Content-Length: length
Date: date

请求消息参数

该请求需要在消息中指定参数,表明这是截断写上传,同时指定本次截断后的对象大小。参数说明如表1所示。

表1 请求消息参数

参数名称

描述

是否必选

truncate

表明这是以截断方式上传。

类型:String

length

截断后对象的大小。

类型:Integer

请求消息头

该请求使用公共的请求消息头,具体如表3所示。

请求消息元素

该请求消息头中不带消息元素。

响应消息样式

1
2
3
4
5
HTTP/1.1 204 status_code
Server: OBS
x-obs-request-id: request-id
x-obs-id-2: id
Date: Date

响应消息头

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

响应消息元素

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

错误响应消息

无特殊错误,所有错误已经包含在表2中。

请求示例

PUT /ObjectName?truncate&length=1000 HTTP/1.1
Host: examplebucket.obs.region.example.com
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:75/Y4Ng1izvzc1nTGxpMXTE6ynw=
Content-Length: 1
Date: WED, 01 Jul 2015 04:19:20 GMT

响应示例

1
2
3
4
5
HTTP/1.1 204 No Content
Server: OBS
x-obs-request-id: 8DF400000163D3F51DEA05AC9CA066F1
x-obs-id-2: 32AAAUgAIAABAAAQAAEAABAAAQAAEAABCSgkM4Dij80gAeFY8pAZIwx72QhDeBZ5
Date: WED, 01 Jul 2015 04:19:21 GMT