租户端 存储 对象存储（COS） API参考 设置跨云复制规则

设置跨云复制规则

最近更新时间: 2026-03-13 09:03:00

功能描述

PUT Bucket CrossCloudReplication 用于创建、更新和删除源存储桶跨云复制规则。如果存储桶已经配置了跨云复制规则，那么该请求会更新对应的规则信息。

请求

需先获取跨云复制请求域名，在私有云环境下，需登录平台机器，执行如下命令获取:

请求示例 

POST /capi HTTP/1.1
Host: ocloud-cos-lazarus.xxxx.fsphere.cn
Accept: */*
Content-Type: application/json
request body

请求体

用户在请求体中设置跨云复制的具体配置信息。配置信息包括跨云复制规则的启用状态、复制内容、目标存储桶的存储桶名和AK/SK等信息。

{
  "Action": "PutBucketCrossCloudReplication",
  "Params": {
    "Bucket": "test-1-1255000000",
    "Region": "region",
    "Configuration": [
      {
        "Destination": {
          "Bucket": "test-2-1255000000",
          "Endpoint": "http://cos.region.domain",
          "SecretID": "AKIDQDXxxxxxxxxxxxxxxxxxxqc5ltHpjJf",
          "SecretKey": "nyxljpwoxxxxxxxxxxxxxxxxxxTRwkgLU"
        },
        "DestinationPrefix": "test",
        "SourcePrefix": "test/",
        "Status": "Enabled",
        "PrefixType": true
      }
    ]
  }
}

具体内容描述如下：

字段名称 描述 类型 必选
Action 跨云复制规则操作类型 String 是
Params 跨云复制规则配置信息 Dict 是

Params包含字段信息

字段名称 描述 类型 必选
Bucket 源存储桶名称 String 是
Region 源存储桶Region信息 String 是
Configuration 具体规则配置信息 Array 是

Configuration包含字段信息

字段名称 描述 类型 必选
Destination 目标存储桶配置信息 Dict 是
DestinationPrefix 目标存储桶配置的前缀信息 String 是
SourcePrefix 源存储桶配置的前缀信息 Dict 是
PrefixType 源存储桶配置的黑白名单类型，true表示开启黑名单，false表示开启白名单，黑名单表示不复制对应SourcePrefix指定的前缀对象，白名单则表示只复制SourcePrefix指定的前缀对象 bool 是
Status 跨云复制规则是否开启 String 是

Destination包含字段信息

字段名称 描述 类型 必选
Bucket 目标存储桶名称 String 是
Endpoint 目标存储桶的访问域名，不包含存储桶名称 String 是
SecretID 目标存储桶的AK信息 String 是
SecretKey 目标存储桶的SK信息 String 是

响应

响应头 

HTTP/1.1 200 OK
Date: Tue, 23 Sep 2025 07:58:40 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 810
Connection: keep-alive

响应体 

{
  "RequestId": "",
  "Code": "ok",
  "Message": "",
  "Data": [
    {
      "Status": "Enabled",
      "Destination": {
        "Endpoint": "http://cos.region.domain",
        "Bucket": "test-2-1255000000",
        "SecretID": "AKIDQDXnxxxxxxxxxxxxxxxqc5ltHpjJf",
        "SecretKey": "nyxljpwolxxxxxxxxxxxxx50pTRwkgLU",
        "SecretToken": ""
      },
      "SourcePrefix": "test/",
      "DestinationPrefix": "test/",
      "Concurrency": 0,
      "RequestLimit": 0,
      "TrafficLimit": 0,
      "PrefixType": false
    }
  ]
}