列举Bucket的所有replication同步规则
更新时间：2021-12-29
接口说明
本接口用来获取bucket所有的replication同步规则。
请求URI
GET /v1/{bucketName}/?replication&list
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 | 参数位置 |
|---|---|---|---|---|---|
| bucketName | String | 是 | bucket的名称 | "bucketName_example" | Path |
请求体参数
请求体字段数据结构说明
响应体参数
响应体字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| rules | List<Rules> | replication规则列表 |
Rules字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| status | String | 是否生效 | enabled |
| resource | List<String> | replication生效前缀 | |
| destination | Destination | 复制的目的端配置 | |
| replicateHistory | ReplicateHistory | 历史文件复制，有该项则认为是开启 | |
| replicateDeletes | String | 是否开启删除同步,可以为enabled,disabled | enabled |
| id | String | replication规则名 | sample-bucket-replication-config |
| create_time | Integer | replication规则创建时间 | 1583060606 |
| destRegion | String | 目的region | bj |
Destination字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| bucket | String | 目的Bucket name | dst-bucket-name |
| storageClass | String | 目的Object的存储类型。如果保持和源Bucket的存储类型一致，则该参数为空；STANDARD表示标准存储类型，STANDARD_IA表示低频存储类型，COLD表示冷存储类型；如果是多AZ类型bucket，MAZ_STANDARD_IA代表多AZ低频存储，MAZ_STANDARD表示多AZ标准存储类型，不能是其它取值。 | COLD |
ReplicateHistory字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| storageClass | String | 目的Object的存储类型，默认为REMAIN,可以为STANDARD,STANDARD_IA,COLD,MAZ_STANDARD,MAZ_STANDARD_IA | COLD |
请求示例
JSON
1GET /v1/bucketName_example/?replication&list
2<公共请求头>
3
4
5{ }响应示例
JSON
1HTTP/1.1 200 OK
2<公共响应头>
3
4{
5 "rules" : [ {
6 "destRegion" : "bj",
7 "create_time" : 1583060606,
8 "resource" : [ "src-bucket-name/abc", "src-bucket-name/abc" ],
9 "destination" : {
10 "bucket" : "dst-bucket-name",
11 "storageClass" : "COLD"
12 },
13 "id" : "sample-bucket-replication-config",
14 "replicateHistory" : {
15 "storageClass" : "COLD"
16 },
17 "replicateDeletes" : "enabled",
18 "status" : "enabled"
19 }, {
20 "destRegion" : "bj",
21 "create_time" : 1583060606,
22 "resource" : [ "src-bucket-name/abc", "src-bucket-name/abc" ],
23 "destination" : {
24 "bucket" : "dst-bucket-name",
25 "storageClass" : "COLD"
26 },
27 "id" : "sample-bucket-replication-config",
28 "replicateHistory" : {
29 "storageClass" : "COLD"
30 },
31 "replicateDeletes" : "enabled",
32 "status" : "enabled"
33 } ]
34}错误码
请参考通用错误码