简单上传对象
最近更新时间: 2024-10-17 17:10:00
功能描述
PUT Object 接口请求可以将本地的对象（Object）上传至指定存储桶中。该操作需要请求者对存储桶有写入权限。
细节分析
需要有 Bucket 的写权限。
如果请求头的 Content-Length 值小于实际请求体（body）中传输的数据长度，COS 仍将成功创建文件，但 Object 大小只等于 Content-Length 中定义的大小，其他数据将被丢弃。
如果试图添加的 Object 的同名文件已经存在，那么新上传的文件，将覆盖原来的文件，成功时返回200 OK。
请求
请求示例
PUT /<ObjectKey> HTTP/1.1
Host: <BucketName-APPID>.<Endpoint>
Date: GMT Date
Authorization: Auth String说明：
Authorization: Auth String （详请请参阅请求签名文档）。
请求头
公共头部
该请求操作的实现使用公共请求头，了解公共请求头详情请参阅 公共请求头部 文档。
非公共头部
该操作的实现还可以使用以下请求头。
| 名称 | 描述 | 类型 | 必选 |
|---|---|---|---|
| Content-Disposition | RFC 2616 中定义的文件名称，将作为 Object 元数据保存 | string | 否 |
| Content-Encoding | RFC 2616 中定义的编码格式，将作为 Object 元数据保存 | string | 否 |
| Expect | 当使用 Expect：100-continue 时，在收到服务端确认后，才会发送请求内容 | string | 否 |
| Expires | RFC 2616 中定义的缓存策略，将作为 Object 元数据保存 | string | 否 |
| x-cos-meta-* | 包括用户自定义头部后缀和用户自定义头部信息，将作为 Object 元数据返回，大小限制为2KB 注意：用户自定义头部信息支持下划线，但用户自定义头部后缀不支持下划线 |
string | 否 |
| x-cos-storage-class | 设置 Object 的存储级别，枚举值：STANDARD，STANDARD_IA，ARCHIVE。默认值：STANDARD | string | 否 |
| x-cos-acl | 定义 Object 的 ACL 属性，有效值：private，public-read，default；默认值：default（继承 Bucket 权限） 注意：当前访问策略条目限制为1000条，如果您不需要进行 Object ACL 控制，请填 default 或者此项不进行设置，默认继承 Bucket 权限 |
string | 否 |
| x-cos-grant-read | 赋予被授权者读的权限，格式：x-cos-grant-read: id="[OwnerUin]" | String | 否 |
| x-cos-grant-full-control | 赋予被授权者所有的权限，格式：x-cos-grant-full-control: id="[OwnerUin]" | String | 否 |
服务端加密（SSE）相关头部
在上传对象时可以使用服务端加密，请参见 [服务端加密专用头部]。
请求体
该请求的请求体为 Object 文件内容。
响应
响应头
公共响应头
该响应包含公共响应头，了解公共响应头详情请参阅 公共响应头部 文档。
特有响应头
该请求操作的响应头具体数据为：
| 名称 | 类型 | 描述 |
|---|---|---|
| ETag | string | 上传文件内容的 MD5 值 |
版本控制相关头部
在启用版本控制的存储桶中上传对象，将返回下列响应头部：
| 名称 | 描述 | 类型 |
|---|---|---|
| x-cos-version-id | 对象的版本 ID | string |
服务端加密（SSE）相关头部
如果在上传对象时使用了服务端加密，则此接口将返回服务端加密专用头部，请参见 [服务端加密专用头部]。
响应体
该请求响应体为空。
错误码
该请求操作无特殊错误信息，常见的错误信息请参见 错误码 文档。
实际案例
请求
PUT /picture.jpg HTTP/1.1
Host: <BucketName-APPID>.<Endpoint>
Date: Wed, 28 Oct 2015 20:32:00 GMT
Authorization:q-sign-algorithm=sha1&q-ak=AKIDWtTCBYjM5OwLB9CAwA1Qb2ThTSUjfGFO&q-sign-time=1484639384;32557535384&q-key-time=1484639384;32557535384&q-header-list=host&q-url-param-list=&q-signature=5c07b7c67d56497d9aacb1adc19963135b7d00dc
Content-Length: 64
[Object]响应
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 0
Date: Wed,16 Aug 2017 11: 59: 33 GMT
Server: tencent-cos
x-cos-request-id: NTk5NDMzYTRfMjQ4OGY3Xzc3NGRfMWY=案例：使用服务端加密 SSE-C
请求
PUT /exampleobject HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Fri, 10 Apr 2020 09:36:12 GMT
Content-Type: image/jpeg
x-cos-server-side-encryption-customer-algorithm: AES256
x-cos-server-side-encryption-customer-key: MDEyMzQ1Njc4OUFCQ0RFRjAxMjM0NTY3ODlBQkNERUY=
x-cos-server-side-encryption-customer-key-MD5: U5L61r7jcwdNvT7frmUG8g==
Content-Length: 16
Content-MD5: 7o3pGNBWQBRbGPcPTDqmAg==
Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1586511372;1586518572&q-key-time=1586511372;1586518572&q-header-list=content-length;content-md5;content-type;date;host;x-cos-server-side-encryption-customer-algorithm;x-cos-server-side-encryption-customer-key;x-cos-server-side-encryption-customer-key-md5&q-url-param-list=&q-signature=4f6f9f0a6700930f70bff31e3a2b2e622711****
Connection: close
[Object Content]
响应
HTTP/1.1 200 OK
Content-Length: 0
Connection: close
Date: Fri, 10 Apr 2020 09:36:13 GMT
ETag: "582d9105f71525f3c161984bc005efb5"
Server: tencent-cos
x-cos-hash-crc64ecma: 16749565679157681890
x-cos-request-id: NWU5MDNlMGNfZTFjODJhMDlfMzVlMDFfZTk1****
x-cos-server-side-encryption-customer-algorithm: AES256
x-cos-server-side-encryption-customer-key-MD5: U5L61r7jcwdNvT7frmUG8g==