复制对象

此COPY操作使用CopyObject接口发送PUT请求给OSS，OSS根据请求内容可判断该操作为复制操作，进而在服务器端直接执行复制。

请求

  • 请求语法

    • 内容

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

    • 描述

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

  • 请求参数

    • 描述

      拷贝操作涉及到的请求头均以x-oss-开头。

名称 类型 是否必须 描述
x-oss-forbid-overwrite 字符串 否 指定CopyObject操作时是否覆盖同名目标Object
默认值：不指定x-oss-forbid-overwrite，默认覆盖同名目标Object
x-oss-copy-source 字符串 是 指定拷贝的源地址。
默认值：None
x-oss-copy-source-if-match 字符串 否 如果源Object的ETag值和您提供的ETag相等，则执行拷贝操作，并返回200 OK；否则返回412 Precondition Failed错误码（预处理失败）。
默认值：None
x-oss-copy-source-if-none-match 字符串 否 如果源Object的ETag值和您提供的ETag不相等，则执行拷贝操作，并返回200 OK；否则返回304 Not Modified错误码（预处理失败）。
默认值：None
x-oss-copy-source-if-unmodified-since 字符串 否 如果指定的时间等于或者晚于文件实际修改时间，则正常拷贝文件，并返回200 OK；否则返回412 Precondition Failed错误码（预处理失败）。
默认值：None
x-oss-copy-source-if-modified-since 字符串 否 如果源Object在用户指定的时间以后被修改过，则执行拷贝操作；否则返回304 Not Modified错误码（预处理失败）。
默认值：None
x-oss-metadata-directive 字符串 否 设置目标Object的元信息。
默认值：COPY。表示复制源Object的元数据到目标Object
说明 如果拷贝操作的源Object地址和目标Object地址相同，则无论x-oss-metadata-directive为何值，都会直接替换源Object的元数据。
x-oss-server-side-encryption-key-id 字符串 否 表示KMS托管的用户主密钥。
该参数在x-oss-server-side-encryption为KMS时有效。
x-oss-server-side-encryption 字符串 否 指定OSS创建目标Object时，服务器端熵编码加密算法 。取值：AES256 、KMS。
x-oss-object-acl 字符串 否 指定OSS创建目标Object时的访问权限。
取值：public-read、private、public-read-write、default。

  • 非公共请求头

    无

  • 请求体

    无

响应

  • 非公共响应头
名称 类型 是否必须 描述
CopyObjectResult 字符串 是 CopyObject的结果。
默认值：无
ETag 字符串 是 目标Object的ETag值。
父元素：CopyObjectResult
LastModified 字符串 是 目标Object最后更新时间。
父元素：CopyObjectResult

  • 响应体

    无

示例

  • 请求

      GET /my-image.jpg? ?response-content-type=text%2fplain HTTP/1.1
  Host: oss-example.oss-cn-beijing.inspurcloud.com
  Date: Fri, 26 Dec 2014 06:52:15 GMT
  x-oss-storage-class: Archive
  x-oss-copy-source: /oss-example/oss.jpg 
  Authorization: authorization string

  • 响应

      HTTP/1.1 200 OK
  x-oss-request-id: 5a868ca0ebd74bcc8eff1f1a7c9bcd6c
  Date: Fri, 26 Dec 2014 06:48:46 GMT
  Last-Modified: Wed, 12 Oct 2009 17:50:00 GMT
  ETag: "fba9dede5f27731c9771645a39863328"
  Content-Length: 434234
  Content-Type: text/plain
  Connection: keep-alive
  CopyObjectResult: YES
  ETag: Normal
  LastModified: Fri, 26 Dec 2014 06:52:15 GMT
  Server: 
  [data]

错误码

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