delete-bucket-replication接口用于停止某个存储空间(Bucket)的数据复制并删除Bucket的复制配置,此时源Bucket中的任何操作都不会被同步到目标Bucket。
注意事项
要删除存储空间的数据复制规则,您必须有
oss:DeleteBucketReplication
权限。具体操作,请参见为RAM用户授权自定义的权限策略。调用此接口删除某个数据复制规则时,该复制规则不会立刻被删除。OSS需要一定的时间来执行清理操作,此时复制规则的状态为closing。当清理工作完成后,该复制规则才被删除。
只有Bucket的拥有者才能删除Bucket的复制配置。该请求可以从任何一个OSS的Endpoint发起。
命令格式
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复制规则ID为rule_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\"}"
文档内容是否对您有帮助?