复制对象-九游平台

x-obs-acl

string

否

参数解释：

复制对象时，可以加上此消息头设置对象的权限控制策略，使用的策略为预定义的常用策略。

示例：x-obs-acl: acl

约束限制：

预定义策略为字符串形式。

取值范围：

• private
• public-read
• public-read-write

各策略详细说明见acl章节的“使用头域设置acl”。

默认取值：

private

x-obs-grant-read

string

否

参数解释：

复制对象时，使用此头域授权读对象和获取对象元数据的权限给domain下的所有用户。

约束限制：

无

取值范围：

无

默认取值：

无

x-obs-grant-read-acp

string

否

参数解释：

复制对象时，使用此头域授权获取对象acl的权限给domain下的所有用户。

约束限制：

无

取值范围：

无

默认取值：

无

x-obs-grant-write-acp

string

否

参数解释：

复制对象时，使用此头域授权写对象acl的权限给domain下的所有用户。

约束限制：

无

取值范围：

无

默认取值：

无

x-obs-grant-full-control

string

否

参数解释：

复制对象时，使用此头域授权以下权限给domain下的所有用户：

读对象、获取对象元数据、获取对象acl、写对象acl的权限。

约束限制：

无

取值范围：

无

默认取值：

无

x-obs-copy-source

string

是

参数解释：

用来指定复制对象操作的源桶名以及源对象名。当源对象存在多个版本时，通过versionid参数指定版本源对象。

示例：x-obs-copy-source: /source_bucket/sourceobject

约束限制：

中文字符与%，需要进行url编码。

取值范围：

无

默认取值：

无

x-obs-metadata-directive

string

否

参数解释：

此参数用来指定新对象的元数据是从源对象中复制，还是用请求中的元数据替换。

示例：x-obs-metadata-directive: metadata_directive

约束限制：

如果此参数的值不是copy或replace，则obs立即返回400错误；如果用户进行修改元数据操作（源对象与目标对象相同），则此参数只能为replace，否则此请求作为无效请求，服务端响应400。此参数不支持将加密的对象更改成非加密对象（源对象与目标对象相同）。如果用户使用此参数更改加密的对象，系统将返回400。

取值范围：

• copy
• replace

默认取值：

copy

x-obs-copy-source-if-match

string

否

参数解释：

只有当源对象的etag与此参数指定的值相等时才进行复制对象操作，否则返回412（前置条件不满足）。

示例：x-obs-copy-source-if-match: etag

约束限制：

此参数可与x-obs-copy-source-if-unmodified-since一起使用，但不能与其它条件复制参数一起使用。

取值范围：

无

默认取值：

无

x-obs-copy-source-if-none-match

string

否

参数解释：

只有当源对象的etag与此参数指定的值不相等时才进行复制对象操作，否则返回412（前置条件不满足）。

示例：x-obs-copy-source-if-none-match: etag

约束限制：

此参数可与x-obs-copy-source-if-modified-since一起使用，但不能与其它条件复制参数一起使用。

取值范围：

无

默认取值：

无

x-obs-copy-source-if-unmodified-since

string

否

参数解释：

只有当源对象在此参数指定的时间之后没有修改过才进行复制对象操作，否则返回412（前置条件不满足）。

约束限制：

• 此参数指定的时间不能晚于当前的服务器时间（gmt时间），否则参数不生效。
• 此参数可与x-obs-copy-source-if-match一起使用，但不能与其它条件复制参数一起使用
• 格式：符合http://www.ietf.org/rfc/rfc2616.txt规定格式的http时间字符串。
  1. eee, dd mmm yyyy hh:mm:ss z
  2. eeee, dd-mmm-yy hh:mm:ss z
  3. eee mmm dd hh:mm:ss yyyy

  对应示例：

  1. x-obs-copy-source-if-unmodified-since: sun, 06 nov 1994 08:49:37 gmt
  2. x-obs-copy-source-if-unmodified-since: sunday, 06-nov-94 08:49:37 gmt
  3. x-obs-copy-source-if-unmodified-since: sun nov 6 08:49:37 1994

取值范围：

无

默认取值：

无

x-obs-copy-source-if-modified-since

string

否

参数解释：

只有当源对象在此参数指定的时间之后修改过才进行复制对象操作，否则返回412（前置条件不满足）。

约束限制：

• 此参数指定的时间不能晚于当前的服务器时间（gmt时间），否则参数不生效。
• 此参数可与x-obs-copy-source-if-none-match一起使用，但不能与其它条件复制参数一起使用
• 格式：符合http://www.ietf.org/rfc/rfc2616.txt规定格式的http时间字符串。
  1. eee, dd mmm yyyy hh:mm:ss z
  2. eeee, dd-mmm-yy hh:mm:ss z
  3. eee mmm dd hh:mm:ss yyyy

  对应示例：

  1. x-obs-copy-source-if-modified-since: sun, 06 nov 1994 08:49:37 gmt
  2. x-obs-copy-source-if-modified-since: sunday, 06-nov-94 08:49:37 gmt
  3. x-obs-copy-source-if-modified-since: sun nov 6 08:49:37 1994

取值范围：

无

默认取值：

无

x-obs-storage-class

string

否

参数解释：

复制对象时，可以加上此头域设置目的对象的存储类型。如果未设置此头域，则以目的对象所在桶的默认存储类型作为对象的存储类型。

示例：x-obs-storage-class: standard

约束限制：

设置该参数的值时请注意大小写敏感。

取值范围：

• standard
• warm
• cold
• deep_archive

默认取值：

默认继承桶的存储类型。

x-obs-persistent-headers

string

否

参数解释：

复制对象时，可以在http请求中加入“x-obs-persistent-headers”消息头，用来加入一个或多个自定义的响应头，当用户获取目标对象或查询目标对象元数据时，加入的自定义响应头将会在返回消息的头域中出现。

约束限制：

• 通过该方式指定的自定义响应头不能以“x-obs-”为前缀，比如可以指定“key1”，但是不能指定“x-obs-key1”。
• 不能指定http标准头，例如host/content-md5/origin/range/content-disposition等。
• 此头域和自定义元数据总长度不能超过8kb。
• 如果传入相同key，将value以“,”拼接后放入同一个key中返回。
• 如果源对象中已经存在自定义响应头，复制的时候不会拷贝到目标对象中。
• 如果value解码后存在非us-ascii值或不可识别字符，则服务端只会作为字符串处理并通过“?utf-8?b?<(str)>?=”包装，而不会做解码，例如key1:abbc，会返回key1: =?utf-8?b?abbc?=。
• value不支持包含的字符“空格”、“=”、“,”、“;”、“:”、"."，如果需要包含，请使用url编码或者base64编码。
• 格式：x-obs-persistent-headers: key1:base64_encode(value1),key2:base64_encode(value2)....

  说明：其中key1/key2等为自定义header，如果含有非ascii码或不可识别字符，可以采用url编码或者base64编码，服务端只会作为字符串处理，不会做解码。value1/value2等为对应自定义header的值，base64_encode指做base64编码，即将自定义header和对应值的base64编码作为一个key-value对用“:”连接，然后用“,”将所有的key-value对连接起来，放在x-obs-persistent-headers这个header中即可，服务端会对上传的value做解码处理。

  示例：x-obs-persistent-headers: key1:dmfsdwux,key2:dmfsdwuy

  在下载目标对象或获取目标对象元数据时：返回两个头域为“key1:value1”与“key2:value2”

取值范围：

无

默认取值：

无

x-obs-website-redirect-location

string

否

参数解释：

当桶设置了website配置，可以将获取这个对象的请求重定向到桶内另一个对象或一个外部的url，obs将这个值从头域中取出，保存在对象的元数据中。

约束限制：

必须以“/”、“http://”或“https://”开头，长度不超过2k。

取值范围：

无

默认取值：

无

x-obs-server-side-encryption

string

否。当使用sse-kms方式时，必选。

参数解释：

使用该头域表示服务端加密是sse-kms方式。目标对象使用sse-kms方式加密。

示例：x-obs-server-side-encryption: kms

约束限制：

无

取值范围：

• kms
• aes256

默认取值：

无

x-obs-server-side-data-encryption

string

否

参数解释：

该头域表示目标对象使用的数据加密算法。

示例：x-obs-server-side-data-encryption：sm4

约束限制：

仅在sse-kms加密方式下使用该头域。

取值范围：

• sm4
• aes256

默认取值：

无

x-obs-server-side-encryption-kms-key-id

string

否

参数描述：

当加密方式为sse-kms且使用指定密钥加密时，需输入密钥id。密钥id获取方法请参见查看密钥。

约束限制：

当您设置了x-obs-server-side-encryption头域且赋值为“kms”，即选择kms加密方式时，才能使用该头域指定加密密钥。

默认取值：

当您选择使用kms加密方式，但未设置此头域时，默认的主密钥将会被使用。如果默认主密钥不存在，系统将默认创建并使用。

x-obs-server-side-encryption-customer-algorithm

string

否。当使用sse-c方式时，必选。

参数解释：

该头域表示加密目标对象使用的算法。

示例：x-obs-server-side-encryption-customer-algorithm: aes256

约束限制：

• 仅在sse-c加密方式下使用该头域。
• 需要和x-obs-server-side-encryption-customer-key， x-obs-server-side-encryption-customer-key-md5一起使用。

取值范围：

aes256

默认取值：

无

x-obs-server-side-encryption-customer-key

string

否。当使用sse-c方式时，必选。

参数解释：

该头域表示加密目标对象使用的密钥。

示例：x-obs-server-side-encryption-customer-key:k7qkypbkm5 hca27fsnkunnvaobncnlht/rcb2o/9cw=

约束限制：

• 仅在sse-c加密方式下使用该头域。
• 该头域由256-bit的密钥经过base64-encoded得到，需要和x-obs-server-side-encryption-customer-algorithm，x-obs-server-side-encryption-customer-key-md5一起使用。

取值范围：

无

默认取值：

无

x-obs-server-side-encryption-customer-key-md5

string

否。当使用sse-c方式时，必选。

参数解释：

该头域表示加密目标对象使用的密钥的md5值。md5值用于验证密钥传输过程中没有出错。

示例：x-obs-server-side-encryption-customer-key-md5:4xvb3tbntn tieva0/fgaq==

约束限制：

• 仅在sse-c加密方式下使用该头域。
• 该头域由密钥的128-bit md5值经过base64-encoded得到，需要和x-obs-server-side-encryption-customer-algorithm，x-obs-server-side-encryption-customer-key一起使用。

取值范围：

密钥的md5值。

默认取值：

无

x-obs-copy-source-server-side-encryption-customer-algorithm

string

否。当拷贝源对象使用sse-c方式时，必选。

参数解释：

该头域表示解密源对象使用的算法。

示例：x-obs-copy-source-server-side-encryption-customer-algorithm: aes256

约束限制：

• 仅在sse-c加密方式下使用该头域。
• 需要和x-obs-copy-source-server-side-encryption-customer-key，x-obs-copy-source-server-side-encryption-customer-key-md5一起使用。

取值范围：

aes256

默认取值：

无

x-obs-copy-source-server-side-encryption-customer-key

string

否。当拷贝源对象使用sse-c方式时，必选。

参数解释：

该头域表示解密源对象使用的密钥。

示例：x-obs-copy-source-server-side-encryption-customer-key: k7qkypbkm5 hca27fsnkunnvaobncnlht/rcb2o/9cw=

约束限制：

• 仅在sse-c加密方式下使用该头域。
• 该头域由256-bit的密钥经过base64-encoded得到，需要和x-obs-copy-source-server-side-encryption-customer-algorithm，x-obs-copy-source-server-side-encryption-customer-key-md5一起使用。

取值范围：

无

默认取值：

无

x-obs-copy-source-server-side-encryption-customer-key-md5

string

否。当拷贝源对象使用sse-c方式时，必选。

参数解释：

该头域表示解密源对象使用的密钥的md5值。md5值用于验证密钥传输过程中没有出错。

示例：x-obs-copy-source-server-side-encryption-customer-key-md5:4xvb3tbntn tieva0/fgaq==

约束限制：

• 仅在sse-c加密方式下使用该头域。
• 该头域由密钥的128-bit md5值经过base64-encoded得到，需要和x-obs-copy-source-server-side-encryption-customer-algorithm，x-obs-copy-source-server-side-encryption-customer-key一起使用。

取值范围：

密钥的md5值。

默认取值：

无

success-action-redirect

string

否

参数解释：

用于指定当此次请求操作成功响应后的重定向的地址。

• 如果此参数值有效且操作成功，响应码为303，location头域由此参数以及桶名、对象名、对象的etag组成。
• 如果此参数值无效，则obs忽略此参数的作用，location头域为对象地址，响应码根据操作成功或失败正常返回。

约束限制：

需要为url格式，如http://domainname、https://domainname。

取值范围：

url

默认取值：

无

x-obs-tagging-directive

string

否

参数解释：

通过携带头域x-obs-tagging-directive指定对象标签的复制策略。不带该头域默认不复制。

示例：x-obs-tagging-directive:copy

约束限制：

无

取值范围：

• copy：复制源对象的对象标签到目标对象。
• replace：忽略源对象的对象标签，直接采用请求中指定的对象标签。

默认取值：

replace

x-obs-object-lock-mode

string

否，携带x-obs-object-lock-retain-until-date头域时必带

参数解释：

要应用于此对象的worm模式。

示例：x-obs-object-lock-mode:compliance

约束限制：

该参数需要和x-obs-object-lock-retain-until-date一同使用。

取值范围：

compliance

默认取值：

无

x-obs-object-lock-retain-until-date

string

否，携带x-obs-object-lock-mode头域时必带

参数解释：

此对象的worm策略过期的截止时间。

示例：x-obs-object-lock-retain-until-date:2015-07-01t04:11:15z

约束限制：

• 格式要求为utc时间，并符合iso 8601标准。如：2015-07-01t04:11:15z
• 该参数需要和x-obs-object-lock-mode一同使用。

取值范围：

需要大于当前时间。

默认取值：

无

x-obs-tagging

string

否

参数解释：

以键值对（key-value）的形式指定object的标签信息，可同时设置多个标签。

示例：x-obs-tagging:taga=a&tagb&tagc

约束限制：

• key或value包含特殊字符以及“=”、中文字符时，需要进行url编码处理。
• 如果某项没有“=”，则看作value为空字符串。

取值范围：

无

默认取值：

无

x-obs-copy-source-version-id

string

参数解释：

源对象的版本号。

约束限制：

无

取值范围：

无

默认取值：

无

x-obs-version-id

string

参数解释：

目标对象的版本号。

约束限制：

无

取值范围：

无

默认取值：

无

x-obs-server-side-encryption

string

参数解释：

该头域表示服务端的加密方式。

示例：x-obs-server-side-encryption: kms

约束限制：

如果服务端加密是sse-kms方式，响应包含该头域。

取值范围：

• kms
• aes256

默认取值：

无

x-obs-server-side-encryption-kms-key-id

string

参数描述：

当加密方式为sse-kms且使用指定密钥加密时，需输入密钥id。密钥id获取方法请参见查看密钥。

约束限制：

当您设置了x-obs-server-side-encryption头域且赋值为“kms”，即选择kms加密方式时，才能使用该头域指定加密密钥。

默认取值：

当您选择使用kms加密方式，但未设置此头域时，默认的主密钥将会被使用。如果默认主密钥不存在，系统将默认创建并使用。

x-obs-server-side-encryption-customer-algorithm

string

参数解释：

该头域表示加密使用的算法。

示例：x-obs-server-side-encryption-customer-algorithm: aes256

约束限制：

如果服务端加密是sse-c方式，响应包含该头域。

取值范围：

aes256

默认取值：

无

x-obs-server-side-encryption-customer-key-md5

string

参数解释：

该头域表示加密使用的密钥的md5值。

示例：x-obs-server-side-encryption-customer-key-md5:4xvb3tbntn tieva0/fgaq==

约束限制：

如果服务端加密是sse-c方式，响应包含该头域。

取值范围：

密钥id md5的base64值。

默认取值：

无

x-obs-storage-class

string

参数解释：

对象的存储类型。

约束限制：

对象为非标准存储对象时，会返回此头域。

取值范围：

• warm
• cold
• deep_archive

默认取值：

返回对象的存储类型。

copyobjectresult

xml

参数解释：

复制对象结果的容器。

约束限制：

无

取值范围：

无

默认取值：

无

lastmodified

string

参数解释：

对象最近一次被修改的时间（utc时间）。

约束限制：

日期格式为iso8601的格式。

例如：2018-01-01t00:00:00.000z，表示最后一次修改时间为2018-01-01t00:00:00.000z。

取值范围：

无

默认取值：

无

etag

string

参数解释：

新对象的base64编码的128位md5摘要。etag是对象内容的唯一标识，可以通过该值识别对象内容是否有变化。比如上传对象时etag为a，下载对象时etag为b，则说明对象内容发生了变化。

约束限制：

当对象是服务端加密的对象时，etag值不是对象的md5值。

取值范围：

长度为32的字符串。

默认取值：

无