最近更新时间:2024.01.15 15:20:45
首次发布时间:2023.03.14 21:02:15
此接口用于为存储桶(Bucket)设置跨区域复制规则或同区域复制规则。通过 PutBucketReplication 接口,您可以将新创建的对象及修改的对象从一个源桶复制到相同地域或不同地域的目标桶中。
PUT /?replication HTTP/1.1 Host: bucketname.tos-cn-beijing.volces.com Date: Fri, 30 Jul 2021 08:05:36 +0000 Authorization: authorization string Content-Length: 120 Content-MD5: XrY7u+Ae7tCTyyK7j1rNww== { "Role": "Your role", "Rules":[{ "ID": "1", "Status": "Enabled", "PrefixSet": ["prefix_1", "prefix_2"], "Destination":{ "Bucket":"Target Bucket Name", "Location": "Target Bucket Location", "StorageClass": "STANDARD" }, "HistoricalObjectReplication": "Enabled" }] }
该请求使用的公共请求消息头,请参见公共参数。
名称 | 位置 | 参数类型 | 是否必选 | 示例值 | 说明 |
---|---|---|---|---|---|
replication | Query | String | 是 | - | 代表 PutBucketReplication 请求的特殊标识。 |
名称 | 参数类型 | 是否必选 | 示例值 | 说明 |
---|---|---|---|---|
Role | String | 是 | ServiceRoleforReplicationAccessTOS | 角色名称。该角色必须具有 TOS 的读写权限及服务访问权限,您也可以使用 TOS 默认角色 |
Rules | Array | 是 | - | 复制规则信息。 |
ID | String | 否 | 1 | 规则的唯一标识符,小于 255 字符。 |
Status | String | 是 | Enabled | 指定是否启用该规则,取值说明如下:
|
PrefixSet | Array | 否 | prefix_1 | 适用该规则的对象名前缀。 |
Destination | Object | 是 | - | 目标桶信息。 |
Bucket | String | 是 | Target Bucket Name | 目标桶名称。 |
Location | String | 是 | cn-beijing | 目标桶所在的地域。 |
StorageClass | String | 否 | STANDARD | 指定复制到目标存储桶的对象的存储类型,取值说明如下:
如果同时设置了 |
StorageClassInheritDirective | String | 否 | DESTINATION_BUCKET | 设置复制到目标存储桶的对象存储类型,取值说明如下:
|
HistoricalObjectReplication | String | 是 | Enabled | 是否开启复制历史对象,如果开启,会复制符合这条规则的历史对象,取值说明如下:
|
该请求返回的公共响应消息头,请参见公共参数。
该请求响应中无消息元素。
PUT /?replication HTTP/1.1 Host: bucketname.tos-cn-beijing.volces.com Date: Fri, 30 Jul 2021 08:05:36 +0000 Authorization: authorization string Content-Length: 120 Content-MD5: XrY7u+Ae7tCTyyK7j1rNww== { "Role": "Your role", "Rules":[{ "ID": "1", "Status": "Enabled", "PrefixSet": ["prefix_1", "prefix_2"], "Destination":{ "Bucket":"Target Bucket Name", "Location": "cn-beijing", "StorageClass": "STANDARD" }, "HistoricalObjectReplication": "Enabled" }] }
HTTP/1.1 200 OK x-tos-id-2: f91b0c03a01300c1-a444ed0 x-tos-request-id: f91b0c03a01300c1-a444ed0 Date: Fri, 30 Jul 2021 06:45:39 GMT server: TosServer