上传对象

此PUT接口可以添加一个Object对象文件到某个存储桶。如果要使用此接口，需要具有该存储桶的写权限。

请求

  • 请求语法

    • 内容 

        PUT /{ObjectKey} HTTP/1.1
  Host: {BucketName}.{Endpoint}
  Date: {date}
  Authorization: {SignatureValue}

    • 描述

        Endpoint：参考与region地域的关系
  SignatureValue：参考签名算法

  • 请求参数

    无

  • 非公共请求头

名称 类型 是否必须 描述
Cache-Control 字符串 否 指定该Object下载时网页采取何种缓存方式。
默认值：None
Content-Disposition 字符串 否 指定该Object被下载时的名称。
默认值：None
Content-Encoding 字符串 否 指定该Object被下载时的内容编码格式。
默认值：None
Content-Length 字符串 否 用于描述HTTP消息体的传输大小。
如果请求头中的Content-Length值小于实际请求体中传输的数据大小，OSS仍将成功创建Object，但Object的大小只能等于Content-Length中定义的大小，其他数据将被丢弃。
Content-MD5 字符串 否 用于检查消息内容是否与发送时一致。Content-MD5是由MD5算法生成的值。
默认值：None
Content-Type 字符串 否 用于描述文件内容MIME格式。
默认值：binary/octet-stream
有效值: MIME types
Expect 字符串 否 当用户使用 100-continue 时，直到收到确认时才会发送请求体。如果头部信息被拒绝，请求体不会被发送
默认值：None
有效值：100-continue
Expires 字符串 否 对象存在于缓存的有效时间日期。
默认值：None
x-oss-meta-* 字符串 否 用户元数据前缀标识。若某个头部前缀为 x-oss-meta-， 则为用户自定义元数据。
默认值：None
x-oss-storage-class 字符串 否 指定Object的存储类型。
对于任意存储类型的Bucket，若上传Object时指定此参数，则此次上传的Object将存储为指定的类型。例如，在IA类型的Bucket中上传Object时，若指定x-oss-storage-class为Standard，则该Object直接存储为Standard。
取值：Standard、IA、Archive
x-oss-acl 字符串 否 定义 Object 的 ACL 属性。用于对象的预定义权限。
默认值：private
有效值：private，public-read-write，public-read;
（提示）为用户授予权限的功能，在系统设计中，暂时不用实现，可以参考（x-oss-grant-read、x-oss-grant-write、x-oss-grant-full-control）

  • 请求体

    无

响应

  • 非公共响应头
名称 类型 描述
ETag 字符串 ETag (entity tag) 在每个 Object 生成的时候被创建，ETag 值是该 Object 内容的uuid，可以用于检查该 Object 内容是否发生变化。
x-oss-object-type 枚举字符串 表示该对象为Appendable对象或者Normal对象
有效值：Appendable;Normal
  • 响应体

无

示例

当服务器上文件已存在时，若上传成功，将会导致覆盖。Content-Length是必须的，且不能大于body中的实际数据大小。

  • 请求
      GET /my-image.jpg HTTP/1.1
  Host: oss-example.oss-cn-beijing.inspurcloud.com
  Date: Wed, 12 Oct 2009 17:50:00 GMT
  Authorization: authorization string
  Content-Type: text/plain
  Content-Length: 11434
  Expect: 100-continue
  Authorization: authorization string
  [data]
  • 响应
      HTTP/1.1 100 Continue
  HTTP/1.1 200 OK
  x-oss-requestid:dbea4ce4ec23415b9e454ecfa25ec4d9
  Date: Wed, 12 Oct 2009 17:50:00 GMT
  ETag: "1b2cf535f27731c974343645a3985328"
  Content-Length: 0
  Connection: keep-alive
  x-oss-object-type: Normal
  Server:
  [data]

错误码

错误码 描述 状态码 描述
... ... ... ...