公共字段
请求头字段 (Request Header)
Host
指定所请求资源的云服务器名及端口。在 HTTP/1.1 中为必填字段,可以为空值。HTTP/1.0 中为可选字段。详情可参考 RFC 文档。
Authorization
认证所需信息。详情可参考 RFC 文档。
Date
客户端请求发送时的时间。格式由 RFC 822 定义,如:
Date: Tue, 15 Nov 1994 08:12:31 GMT
详情可参考 RFC 文档。
Content-Length
请求的内容长度,以字节为单位。详情可参考 RFC 文档。
Content-Type
请求实体的 MIME 类型。总长度不可超过 255 个字符,且应该符合 RFC 文档的规范。若客户端未指定 Content-Type
或值为空,服务端将按 application/octet-stream
处理。详情可参考 RFC 文档。
Content-MD5
请求实体的 MD5 校验值,用来验证数据的完整性。详情可参考 RFC 文档。
Expect
用来确认服务端是否支持特定行为。当 Expect
的值为 100-continue
时,客户端在发送请求实体前,等待服务器的确认,若服务器拒绝该请求,则请求实体将不会被发送。详情可参考 RFC 文档。
Range
用于指定请求的内容范围。取值可为以下三类,目前不支持 rfc2616 中定义的按逗号分隔的多段 Range:
bytes=start_offset-stop_offset
将返回从 start_offset 开始,至 stop_offset 的数据,单位为字节,包含 stop_offset 所对应的字节。如bytes=0-0
,将返回第一个字节的数据。bytes=start_offset-
将返回从 start_offset 开始之后的数据,单位为字节,包含 start_offset 所对应的字节。bytes=-suffix_length
将返回文件末尾长度为 suffix_length 的数据。若 suffix_length 大于文件长度,那么将返回整个文件。
若指定了 Range 头字段,那么成功的情况下 HTTP 返回码为 206,若参数有误或 start_offset 超出文件边界的情况下返回 416 错误。 详情可参考 RFC 文档。
响应头字段 (Response Header)
Content-Length
服务端返回的消息实体的传输长度,以字节为单位。详情可参考 RFC 文档。
Content-Type
服务端返回的消息实体的 MIME 类型。仅支持 application/json
格式。详情可参考 RFC 文档。
Connection
标识连接是否已关闭,有效值为 keep-alive
和 close
。详情可参考 RFC 文档。
Date
服务端返回响应时的日期和时间。格式由 RFC 822 定义,如:
Date: Tue, 15 Nov 1994 08:12:31 GMT
详情可参考 RFC 文档。
ETag
用于标识 Object 的内容是否已被更新。对于通过 PUT Object 上传的对象,该值由服务端生成;对于通过 Multipart Upload 上传的对象,该值由调用 Complete Multipart Upload 接口时,请求头中的 ETag 来设置。详情可参考 RFC 文档。
需要注意的是,这里提到的 Object 内容,不包括元数据。
Server
Web服务器软件信息,固定为 OIS
。详情可参考 RFC 文档。
x-qs-request-id
服务端会为每个请求生成并返回一个唯一标示。用户提交工单时如果能附带此 ID 将有助于对象存储的研发团队定位问题。
Content-Range
当请求中附带了 Range
头字段时,响应中的 Content-Range
头说明了实际返回的数据在文件中的位置。格式为:
bytes start_offset-stop_offset/file_size
如一个长度为500字节的文件,在请求中有 Range: bytes=0-0
的时候,响应中附带 Content-Range: bytes 0-0/500
。详情可参考 RFC 文档。
x-qs-content-copy-range
当请求中附带了 x-qs-copy-range
头字段时,响应中的 x-qs-content-copy-range
头说明了实际返回的数据在文件中的位置。格式为:
bytes start_offset-stop_offset/file_size
如一个长度为500字节的文件,在请求中有 x-qs-copy-range: bytes=0-0
的时候,响应中附带 x-qs-content-copy-range: bytes 0-0/500