有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

接口描述

  • 接口名称: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 失败。