构造请求
更新时间 2026-04-10 16:44:56
最近更新时间: 2026-04-10 16:44:56
请求URI
ZOS会根据桶名、对象名及附带的资源参数生成唯一的资源标识符（URI），用于资源的具体操作。其通用格式如下（方括号表示可选项）：
protocol://[bucket.]domain[:port][/object][?param]
| 参数 | 含义说明 | 是否必选 |
|---|---|---|
| protocol | 协议类型，如 http 或 https，用于指定通信方式 | 是 |
| bucket | 桶名称，表示资源所在的存储桶，在资源池中唯一标识一个桶 | 否 |
| domain | 服务域名或IP地址 | 是 |
| port | 请求端口号，未指定则使用协议默认端口，HTTP默认80端口，HTTPS默认443端口 | 否 |
| object | 对象路径，指定桶内的具体资源 | 否 |
| param | 查询参数，用于传输额外的请求信息 | 否 |
请求方法
基于对象存储的URI，ZOS支持一系列REST请求方法，用于实现对资源的管理与操作。
| 方法 | 作用描述 |
|---|---|
| GET | 请求服务器返回指定资源，如下载对象、获取桶列表等 |
| PUT | 请求服务器更新指定资源，如创建桶、上传对象等 |
| POST | 请求服务器新增资源或执行特殊操作，如初始化上传段任务、合并段等 |
| DELETE | 请求服务器删除指定资源，如删除对象、删除桶等 |
| HEAD | 请求服务器返回指定资源的概要，如获取对象元数据等 |
| OPTIONS | 请求服务器检查是否具有某个资源的操作权限，如跨域资源共享（CORS）预检请求 |
请求消息头
请求消息头用于传递认证信息、请求条件、元数据设置等，辅助控制资源的访问与操作。不同操作会依赖不同的头字段，以下是常见的公共请求消息头及其作用说明：
| 名称 | 描述 | 类型 | 是否必选 |
|---|---|---|---|
| Authorization | 请求中的签名信息，匿名请求不需要携带 | String | 有条件必选 |
| Content-Length | 请求体长度信息（不含头部），以字节为单位，PUT操作可选，加载XML的操作必须带 | String | 有条件必选 |
| Content-Type | 请求体中资源的类型，例如：text/plain | String | 否 |
| Content-MD5 | 请求体的MD5摘要信息（不包含头部），用作请求体的完整性校验 | String | 否 |
| Date | 当前请求的日期和时间，如果作为生成v4签名的请求头，格式必须为ISO8601，这种情况就不需要x-amz-date请求头。如果不用来生成签名请求头，格式可以为GMT，例如Sun, 05 Sep 2021 23:00:00 GMT | String | 是 |
| Host | 路径样式，格式为 https://jiangsu-10.zos.ctyun.cn | String | 是 |
| x-amz-content-sha256 | 请求体的hash值（不包含头部），用于v4签名校验，如果请求体为空，需要提供空字符串的hash值 | String | 有条件必选 |
| x-amz-date | 用于生成Authorization签名，使用ISO8601格式，例如20111015T080000Z | String | 是 |
请求消息体（可选）
请求消息体用于携带除消息头以外的额外数据，其格式通常与 Content-Type 头部字段相匹配，如 JSON 或 XML。当包含中文参数时，需确保使用 UTF-8 编码。是否需要消息体及其具体内容，取决于所调用的接口类型；例如，GET 和 DELETE 请求通常不包含消息体，而其他接口则可能需要根据其功能传入相应的数据结构。
