接口描述
- 接口名称:PutObject
- 接口功能:该接口可以将本地的对象(Object)上传至指定数据保险箱中,该接口的请求者需要对数据保险箱有写入权限。
说明:
- PutObject 接口最大支持上传5GB文件。如需上传大于5GB的文件,请使用分块上传 InitiateMultipartUpload 接口。
- 如果请求头的 Content-Length 值小于实际请求体(body)中传输的数据长度,数据保险箱仍将成功创建文件,但对象大小只等于 Content-Length 中定义的大小,其他数据将被丢弃。
- 如果试图添加已存在的同名对象,则接口会返回对象已存在的错误。
请求
请求示例
PUT /<CofferName-APPID>/<ObjectKey> HTTP/1.1
Host: cdcs.<Region>.myqcloud.com
Date: GMT Datex
Content-Type: Content Type
Content-Length: Content Length
Content-MD5: MD5
Authorization: Auth String
[Object Content]
说明:Authorization: Auth String 详情,请参见 请求签名 文档。
请求参数
此接口无请求参数。
请求头
此接口无特殊请求头部,公共请求头部详情,请参见 公共请求头部 文档。
请求体
此接口请求的请求体为对象(文件)内容。
响应
响应头
此接口无特殊响应头,公共响应头部详情请参见 公共响应头部 文档。
响应体
此接口响应体为空。
错误码
此接口的特殊错误信息如下所述,全部错误信息请参见 错误码 文档。
错误码 | HTTP 状态码 | 描述 |
---|---|---|
ObjectAlreadyExists | 409 Conflict | 指定的对象已存在(也可能是正在上传中或分片上传中)。 |
ObjectAlreadyExistsOwnedByYou | 409 Conflict | 指定的对象已存在且由当前账户创建(也可能是正在上传中或分片上传中)。 |
AssumeRoleFailed | 409 Conflict | 扮演角色失败,检查是否已授予保险箱角色。 |
KMSFailed | 409 Conflict | 调用 KMS 失败。 |