腾讯云对象存储PutObjectCopy

PutObject-Copy描述

创建一个已存在的Object的副本,该copy操作等同于先执行GET操作再执行PUT操作。可通过x-amz-copy-source头指定要复制的源Bucket及源Object。在腾讯云对象存储中可以操作的最大的单个Object为5G,超过5G,请使用分片上传UploadPart-Copy操作。要执行此操作,你需要有源Bucket的READ权限及目标Bucket的WRITE权限。

腾讯云对象存储开通地址 https://cloud.tencent.com/product/cos
腾讯云对象存储最新官方文档 https://cloud.tencent.com/document/product/213/4961

当腾讯云对象存储收到PutObject-Copy请求或腾讯云对象存储正在执行Copy时,该请求可能返回错误。如果在Copy执行之前发生错误,则会收到标准的腾讯云对象存储错误;如果在执行Copy的过程中发生错误,则Copy的错误会嵌入200OK的响应中,所以200OK响应的Copy结果可能是成功或失败。

请求语法PUT/destinationObjectHTTP/1.1Host:destinationBucket.s3.region.jdcloud-oss.comx-amz-copy-source:/source_bucket/sourceObjectAuthorization:authorizationstring(seeAuthenticatingRequests(AWSSignatureVersion4))Date:date
请求参数

无请求参数

请求Header

除公共请求Header,还可使用以下Header

名称描述必须x-amz-copy-source源Bucket和源Object名称,通过"/"分隔。
Type:String
Default:None
字符串必须使用URL编码是x-amz-storage-class如果没有指定该header,存储类型默认为Standard标准存储。
Type:Enum
Default:STANDARD
ValidValues:STANDARD、GLACIER、REDUCED_REDUNDANCY、STANDARD_IA否x-amz-metadata-directive如果该header值指定为COPY,则原文件除x-amz-storage-class外的metadata将复制到目标文件。这时PutObjectCopy指定的自定义metadata将会被忽略。
如果指定为REPLACE,目标文件的metadata取决于PutObjectCopy请求指定的metadata。
Type:String
Default:COPY
Validvalues:COPY、REPLACE否x-amz-meta-以x-amz-meta-前缀开头的Header为用户自定义Header。自定义Header的大小(包括key、value)UTF-8编码下不能超过2K。否请求元素

无请求元素

响应响应Header

除公共响应Header外,该操作还可使用以下Header

名称描述x-amz-storage-class提供Object的存储类型信息。非标准存储情况下,腾讯云对象存储将会返回该Header响应元素名称描述CopyObjectResult响应元素信息集合。
Type:Container
Ancestor:NoneETag返回新Object的ETag。
Type:String
Ancestor:CopyObjectResultLastModified返回Object的最后修改时间。
Type:String
Ancestor:CopyObjectResult示例请求示例PUT/my-second-image.jpgHTTP/1.1Host:oss-example.s3.region.jdcloud-oss.comDate:Wed,28Oct200922:32:00GMTx-amz-copy-source:/bucket/my-image.jpgAuthorization:authorizationstring响应示例HTTP/1.1200OKx-amz-request-id:318BC8BC148832E5Date:Wed,28Oct200922:32:00GMTConnection:closeServer:JDCloud腾讯云对象存储CopyObjectResultLastModified2009-10-28T22:32:00/LastModifiedETag"9b2cf535f27731c974343645a3985328"/ETag/CopyObjectResult