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\"}"