九游平台/ 对象存储服务 obs/ api参考/ api/ 桶的高级配置/ 设置桶的跨区域复制配置
更新时间：2024-11-15 gmt 08:00
查看pdf

设置桶的跨区域复制配置-九游平台

功能介绍

跨区域复制是指跨不同区域中的桶自动、异步地复制对象。通过激活跨区域复制，obs可将新创建的对象及修改的对象从一个源桶复制到不同区域中的目标桶。

配置跨区域复制需要选择iam委托，配置方法请参见创建iam委托。

设置桶的跨区域复制，需要满足以下两个要求：

  1. 要求源桶和目标桶多版本状态保持一致，否则不能设置replication。如何设置桶的多版本，请参见设置桶的多版本状态。
  2. 源桶的拥有者和代理人（obs）必须要有目标桶的写权限（目标桶需要配置bucketpolicy），同时代理人（obs）还要有源桶的读权限。这需要通过“bucketpolicy”来实现这个权限委托。

如何设置桶策略，请参见。设置桶策略后，代理人（obs）就有权限可以读取源桶的对象，也有权限将对象复制到目标桶中。

请求消息样式

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
 
put/?replicationhttp/1.1
host:bucketname.obs.cn-north-4.myhuaweicloud.com
x-obs-date:date
content-md5:md5
authorization:authorizationstring
content-length:contentlength

testacy

rule1
key-prefix
rule-status

targetbucketname
standard
enabled
enabled

请求消息参数

该请求消息中不使用消息参数。

请求消息头

该请求使用的消息头如下所示。

表1 设置桶的复制配置请求消息头

名称

描述

是否必选

content-md5

按照rfc 1864标准计算出消息体的md5摘要字符串，即消息体128-bit md5值经过base64编码后得到的字符串。如何计算content-md5可参考java中content-md5的计算方法示例。也支持设置content-sha256头域，其值为消息体256-bit sha256值经过base64编码后得到的字符串，content-md5和content-sha256二选一。

是

请求消息元素

在此请求中，需要在请求的消息体中配置桶的复制配置，通知的配置信息以xml格式上传。具体的配置元素如下描述。

表2 设置桶的复制配置元素

名称

描述

是否必须

replicationconfiguration

复制规则的容器，最多可以达到100条规则，所有的复制配置大小可达到50kb。

类型：container

子节点:rule

父节点:无

是

agency

用户创建的委托名字，最大长度为64字符。

类型：string

父节点：replicationconfiguration

是

rule

一条特定复制规则信息的容器。

复制配置必须至少配置一条规则，最多能达到100条规则。

类型：container

父节点:

replicationconfiguration

是

id

规则的特殊辨识符，最大长度为255字符。

类型：string

父节点:rule

否

status

如果status为disabled，这条规则会被忽略。

类型：string

父节点：rule

有效值：enabled,disabled

是

prefix

对象键值名的前缀，适配于一个或者多个对象。如果前缀配置为空，则跨区域复制规则将作用于整个桶。

经过utf-8编码的长度大于0且不超过1024的字符序列，不支持重叠的前缀。

类型：string

父节点:rule

是

destination

目标桶信息的容器。

类型：container

父节点:rule

是

bucket

存储被规则标识的对象副本的桶名称。

如果在复制配置中有多条规则，这些规则必须都要标识同一个桶作为目标桶。

类型：string

父节点：destination

是

storageclass

对象的存储类型。

类型：string

父节点：destination

有效值：standard|warm|cold

否

deletedata

删除同步复制关键字，如果为enabled，源桶的对象删除操作会复制到目标端。

类型：string

父节点：destination

有效值：enabled,disabled（如果不设置，则默认为disabled）

否

historicalobjectreplication

历史对象复制关键字，如果为enabled，会复制符合这条规则的历史对象。

类型：string

父节点：rule

有效值：enabled, disabled（如果不设置，则默认为disabled）

否

响应消息样式

1
2
3
4
 
http/1.1status_code
server:obs
date:date
content-length:contentlength

响应消息头

该请求的响应消息使用公共消息头，具体请参考表1。

响应消息元素

该请求的响应消息中不带有响应元素。

错误响应消息

在此请求的响应中不会返回特殊错误。

请求示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
 
put/?replicationhttp/1.1
user-agent:curl/7.29.0
host:examplebucket.obs.cn-north-4.myhuaweicloud.com
accept:*/*
date:wed,27jun201813:39:15 0000
authorization:obsh4ipjx0tqththebqqcec:cdequ0vg9xndjmz0pgpgh5enko0=
content-md5:l/z8mfsx vyv8k5ehiqz5q==
content-length:330

testacy

rule-1
enabled


dstbucket
standard
enabled
enabled

响应示例

1
2
3
4
5
6
 
http/1.1200ok
server:obs
x-obs-request-id:b59500000164417839932e5a2295674c
x-obs-id-2:32aaaqaaeaabkaaqaaeaabaaaqaaeaabcstv51t2nmmx ou ow7iwv4sxo231fke
date:wed,27jun201813:39:15gmt
content-length:0
父主题： 桶的高级配置

相关文档

网站地图