接口介绍
此接口用于分片上传文件。
接口约束
无
请求URI
PUT /v1/uploads/{bucket}/{objectName}
路径参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 |
|---|---|---|---|---|
| bucket | 是 | String | 桶名称 | testBucket |
| objectName | 是 | String | 对象名称 | test |
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| partNumber | 是 | String | 标识分片的维一编码 | 1 | |
| uploadId | 是 | String | 上传任务ID |
请求参数
请求头header参数
此接口涉及的其他公共请求头，例如Host、Date等的更多信息，请参见公共HTTP头。
请求体body参数
必传，对应为需要实际上传的数据部分。
响应参数
无
请求示例
PUT /v1/uploads/testbucket/test?partNumber=1&uploadId=9GSpv6cxEbmQCXNzLf6mMiCPNQ9nIck
请求头header
Host: gdoss.xstore.ctyun.cn
Date: Wed, 28 Oct 2023 09:32:00 GMT
Authorization: authorization string
Content-Length：6291456
请求体body
实际文件数据。
响应示例
HTTP/1.1 200 OK
状态码
| HTTP状态 | 描述 |
|---|---|
| 200 | 操作成功。 |
| 400 | 分段上传的片段太大。 |
| 400 | 请求中设置的ContentMD5的值与OSS接收到文件的MD5值不符。 |
| 400 | 对象的名字不合法。 |
| 403 | 用户没有权限执行操作。 |
| 404 | 操作指定的桶不存在。 |
