delete-bucket-replication

delete-bucket-replication接口用于停止某个存储空间(Bucket)的数据复制并删除Bucket的复制配置,此时源Bucket中的任何操作都不会被同步到目标Bucket。

注意事项

  • 要删除存储空间的数据复制规则,您必须有oss:DeleteBucketReplication权限。具体操作,请参见RAM用户授权自定义的权限策略

  • 调用此接口删除某个数据复制规则时,该复制规则不会立刻被删除。OSS需要一定的时间来执行清理操作,此时复制规则的状态为closing。当清理工作完成后,该复制规则才被删除。

  • 只有Bucket的拥有者才能删除Bucket的复制配置。该请求可以从任何一个OSSEndpoint发起。

命令格式

ossutil api delete-bucket-replication --bucket value --replication-rules value [flags]

参数

类型

说明

--bucket

string

Bucket名称。

--replication-rules

string

保存需要删除的数据复制规则的容器

说明

delete-bucket-replication命令对应API接口DeleteBucketReplication。关于API中的具体参数含义,请参见DeleteBucketReplication

--replication-rules

--replication-rules配置选项既支持XML语法也支持JSON语法,当选项值包含file://前缀时,表示从文件中读取配置。

  • XML语法:

    <ReplicationRules>
      <ID>string</ID>
    </ReplicationRules>
  • JSON语法:

    {
      "ID": "string"
    }
    说明

    关于支持的全局命令行选项,请参见支持的全局命令行选项

使用示例

  • 停止并删除存储空间examplebucket复制规则IDrule_id的复制配置。

    • 使用XML配置文件,replication-rules.xml 内容如下:

      <?xml version="1.0" encoding="UTF-8"?>
      <ReplicationRules>
        <ID>rule_id</ID>
      </ReplicationRules>

      命令示例如下:

      ossutil api delete-bucket-replication --bucket examplebucket --replication-rules file://replication-rules.xml
    • 使用JSON配置文件,replication-rules.json 内容如下:

      {
        "ID": "rule_id"
      }

      命令示例如下:

      ossutil api delete-bucket-replication --bucket examplebucket --replication-rules file://replication-rules.json
    • 使用JSON配置参数,命令示例如下:

      ossutil api delete-bucket-replication --bucket examplebucket --replication-rules "{\"ID\":\"rule_id\"}"