描述： 管理 bucket 的跨区域复制规则。开启后，源 bucket 中的对象会自动复制到目标 bucket。

命令格式：

1bcecmd bosapi bucket-replication --bucket-name BUCKET-NAME --method METHOD [--config CONFIG] [--rule-id RULE-ID]

说明：

• --method 支持以下 5 种：

  • put : 创建或更新复制规则，需配合 --config 使用，可选 --rule-id。
  • get : 获取指定复制规则详情，可选 --rule-id。
  • list : 列出 bucket 所有复制规则。
  • delete : 删除指定复制规则，可选 --rule-id。
  • progress : 查询复制进度，需配合 --rule-id 使用。
• --config 指定复制规则的 json 配置。
• --rule-id 指定规则 ID。

示例：

• 创建复制规则

  操作示例：

  Plain Text 复制

  1$ bcecmd bosapi bucket-replication --bucket-name bucket1 --method put --config file://replication.json --rule-id rule1

  配置文件 replication.json 示例：

  Plain Text 复制

  1{
  2  "status": "enabled",
  3  "resource": ["bucket1/prefix/*"],
  4  "destination": {
  5    "bucket": "bucket2",
  6    "storageClass": "STANDARD"
  7  },
  8  "replicateDeletes": "disabled"
  9}

  返回示例： 无

• 获取复制规则

  操作示例：

  Plain Text 复制

  1$ bcecmd bosapi bucket-replication --bucket-name bucket1 --method get --rule-id rule1

  返回示例：

  Plain Text 复制

  1{
  2  "status": "enabled",
  3  "resource": ["bucket1/prefix/*"],
  4  "destination": {
  5    "bucket": "bucket2",
  6    "storageClass": "STANDARD"
  7  },
  8  "replicateDeletes": "disabled",
  9  "id": "rule1"
  10}

• 列出所有复制规则

  操作示例：

  Plain Text 复制

  1$ bcecmd bosapi bucket-replication --bucket-name bucket1 --method list

  返回示例：

  Plain Text 复制

  1{
  2  "rules": [...]
  3}

• 删除复制规则

  操作示例：

  Plain Text 复制

  1$ bcecmd bosapi bucket-replication --bucket-name bucket1 --method delete --rule-id rule1

  返回示例： 无

• 查询复制进度

  操作示例：

  Plain Text 复制

  1$ bcecmd bosapi bucket-replication --bucket-name bucket1 --method progress --rule-id rule1

  返回示例：

  Plain Text 复制

  1{
  2  "status": "enabled",
  3  "historyReplicationPercent": 0.5,
  4  "latestReplicationTime": "2024-01-01T00:00:00Z"
  5}