全部產品
Search
文件中心

Object Storage Service:delete-bucket-replication

更新時間:Aug 15, 2024

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