设置Bucket数据同步
所有文档

          对象存储 BOS

          设置Bucket数据同步

          接口说明

          本接口用来创建数据同步。每个id唯一确定一条replication规则,对一个id首次put会认为是创建一条replication规则,对同一个id的再次put认为是覆盖,如果原先status是enable,则不允许覆盖成disable;如果原先是enable,再次put成enable,replication会重新开始执行;不允许两个replication规则除了id一致以外其他项均一致。

          说明:

          • 用户必须是源Bucket的owner且拥有FULL_CONTROL权限,且有目标Bucket的写权限。
          • 目标Bucket和源Bucket必须存在。
          • 目标Bucket和源Bucket可以是同region下的Bucket,也可以是不同Region下的Bucket。
          • 目标Bucket和源Bucket可以是同账户下的bucket,也可以是不同账户下的bucket,但是源账户需要有目的bucket的写权限
          • 整个配置的大小不能超过128k,当前bucket下所有规则长度不得超过200KB 数据同步暂时不支持归档类型文件的同步,进行数据同步时会忽略归档类型文件。
          • 用户最多配置10条replication规则
          • 单个规则,最多20个resource
          • id 由数字字母 - _ 组成,不得超过20个字符

          请求URI

          PUT /v1/{bucketName}/?replication

          参数名称 参数类型 是否必须 描述 示例值 参数位置
          bucketName String bucket的名称 "bucketName_example" Path
          id String replication规则名,id 由数字字母 - _ 组成,不得超过20个字符 "id_example" Query

          请求体参数

          请求体字段数据结构说明

          参数名称 参数类型 是否必须 描述 示例值
          status String 是否生效 enabled
          resource List<String> replication生效前缀,resource的配置形式为{$bucket_name/<生效的对象前缀>},必须要以$bucket_name+/开头
          destination Destination 复制的目的端配置
          replicateHistory ReplicateHistory 历史文件复制,有该项则认为是开启。开启历史文件复制后,存量的全部Object都同步复制到目的Bucket,复制范围共用resource。
          replicateDeletes String 是否开启删除同步,可以为enabled,disabled 。 enabled
          id String replication规则名,id 由数字字母 - _ 组成,不得超过20个字符 sample-bucket

          Destination字段数据结构说明

          参数名称 参数类型 是否必须 描述 示例值
          bucket String 目的Bucket name dst-bucket-name
          storageClass String 目的Object的存储类型。如果保持和源Bucket的存储类型一致,则该参数不需要配置;如果需要单独指定存储类型可以为STANDARD,STANDARD_IA,COLD;如果是多AZ类型bucket,可取值为MAZ_STANDARD_IA和MAZ_STANDARD。 COLD

          ReplicateHistory字段数据结构说明

          参数名称 参数类型 是否必须 描述 示例值
          storageClass String 目的Object的存储类型。如果保持和源Bucket的存储类型一致,则该参数不需要配置;如果需要单独指定存储类型可以为STANDARD,STANDARD_IA,COLD;如果是多AZ类型bucket,可取值为MAZ_STANDARD_IA和MAZ_STANDARD。 COLD

          响应体参数

          响应体字段数据结构说明

          请求示例

          PUT /v1/bucketName_example/?replication&id=id_example
          <公共请求头>
          
          
          {
            "resource" : [ "src-bucket-name/abc" ],
            "destination" : {
              "bucket" : "dst-bucket-name",
              "storageClass" : "COLD"
            },
            "id" : "sample-bucket",
            "replicateHistory" : {
              "storageClass" : "COLD"
            },
            "replicateDeletes" : "enabled",
            "status" : "enabled"
          }

          响应示例

          HTTP/1.1 200 OK
          <公共响应头>
          
          { }

          错误码

          请参考通用错误码

          上一篇
          Bucket相关接口
          下一篇
          列举Bucket的所有replication同步规则