文档首页/ OBS BrowserJS SDK/ API参考/ 对象相关接口/ 复制对象
更新时间：2022-02-10 GMT+08:00
查看PDF
分享

复制对象

功能说明

为指定桶中的对象创建一个副本。

方法定义

ObsClient.copyObject

请求参数

字段名

类型

约束

说明

Bucket

String

必选

目标桶名。

Key

String

必选

目标对象名。

RequestDate

String

或

Date

可选

指定请求时间。

说明：

当为String类型时，必须符合ISO8601或RFC822规范。

ACL

String

可选

创建对象时可指定的预定义访问策略。

StorageClass

String

可选

创建对象时可指定的对象的存储类型。

CopySource

String

必选

指定源桶、源对象和源对象版本号（可为空）的参数，格式：源桶名/源对象名?versionId=源对象版本号。

CopySourceIfMatch

String

可选

如果源对象的ETag值与该参数值相同，则进行复制，否则返回异常码。

CopySourceIfModifiedSince

String

可选

如果源对象的修改时间晚于该参数值指定的时间，则进行复制，否则返回异常码。该参数值必须符合http://www.ietf.org/rfc/rfc2616.txt规定的HTTP时间格式。

CopySourceIfNoneMatch

String

可选

如果源对象的ETag值与该参数值不相同，则进行复制，否则返回异常码。

CopySourceIfUnmodifiedSince

String

可选

如果源对象的修改时间早于该参数值指定的时间，则进行复制，否则返回异常码。该参数值必须符合http://www.ietf.org/rfc/rfc2616.txt规定的HTTP时间格式。

CacheControl

String

可选

复制时重写响应中的Cache-Control头。

ContentDisposition

String

可选

复制时重写响应中的Content-Disposition头。

ContentEncoding

String

可选

复制时重写响应中的Content-Encoding头。

ContentLanguage

String

可选

复制时重写响应中的Content-Language头。

ContentType

String

可选

复制时重写响应中的Content-Type头。

Expires

String

可选

复制时重写响应中的Expires头。

MetadataDirective

String

可选

复制策略。

Metadata

Object

可选

目标对象的自定义元数据。

WebsiteRedirectLocation

String

可选

当桶设置了Website配置，该参数指明对象的重定向地址。

SseKms

String

可选

以SSE-KMS方式加密目标对象，支持的值：

  • kms

SseKmsKey

String

可选

SSE-KMS方式下加密目标对象的主密钥，可为空。

SseC

String

可选

以SSE-C方式加密目标对象，支持的值：

  • AES256

SseCKey

String

可选

SSE-C方式下加密目标对象的密钥，由AES256算法算出。

CopySourceSseC

String

可选

以SSE-C方式解密源对象，支持的值：

  • AES256

CopySourceSseCKey

String

可选

SSE-C方式下解密源对象的密钥，由AES256算法算出。
  • 如果包含CopySourceIfUnmodifiedSince并且不符合，或者包含CopySourceIfMatch并且不符合，或者包含CopySourceIfModifiedSince并且不符合，或者包含CopySourceIfNoneMatch并且不符合，抛出异常中HTTP状态码为：412 precondition failed。
  • CopySourceIfModifiedSince和CopySourceIfNoneMatch可以一起使用；CopySourceIfUnmodifiedSince和CopySourceIfMatch可以一起使用。

返回结果（InterfaceResult）

字段名

类型

说明

RequestId

String

OBS服务端返回的请求ID。

ETag

String

目标对象的ETag值。

LastModified

String

目标对象的最近一次修改时间。

VersionId

String

目标对象的版本号，如果目标桶未开启多版本状态则该值为空。

CopySourceVersionId

String

源对象的版本号，如果源桶未开启多版本状态则该值为空。

代码样例

obsClient.copyObject({
       Bucket:'bucketname',
       Key:'objectkey',
       CopySource:'srcbucketname/srcobjectkey',
       Metadata:{meta1:'value1'}
},function (err, result) {
       if(err){
              console.error('Error-->' + err);
       }else{
              if(result.CommonMsg.Status < 300){
                     console.log('RequestId-->' + result.InterfaceResult.RequestId);
                     console.log('ETag-->' + result.InterfaceResult.ETag);
                     console.log('VersionId-->' + result.InterfaceResult.VersionId);
                     console.log('CopySourceVersionId-->' + result.InterfaceResult.CopySourceVersionId);
                     console.log('LastModified-->' + result.InterfaceResult.LastModified);             
              }else{
                     console.log('Code-->' + result.CommonMsg.Code);
                     console.log('Message-->' + result.CommonMsg.Message);
              }
       }
});
父主题： 对象相关接口