DeleteBucketReplication接口用來停止某個存儲空間(Bucket)的數據復制并刪除Bucket的復制配置,此時源Bucket中的任何操作都不會被同步到目標Bucket。
注意事項
當請求的Bucket沒有配置數據復制規則時,調用此接口將返回200 HTTP OK。
調用此接口刪除某個數據復制規則時,該復制規則不會立刻被刪除。OSS需要一定的時間來執行清理操作,此時復制規則的狀態為closing。當清理工作完成后,該復制規則才被刪除。
當請求的Bucket的數據復制規則處于closing狀態時,調用此接口將返回204 NoContent。
請求語法
POST /?replication&comp=delete HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Content-Length:ContentLength
Content-Type: application/xml
Authorization: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<ReplicationRules>
<ID>rule id</ID>
</ReplicationRules>
請求元素
名稱 | 類型 | 是否必選 | 描述 |
ReplicationRules | 容器 | 是 | 保存需要刪除的數據復制規則的容器。 父節點:無 子節點:ID |
ID | 字符串 | 是 | 需要刪除的復制規則對應的ID。規則ID可從GetBucketReplication中獲取。 父節點:ReplicationRules 子節點:無 |
示例
請求示例
POST /?replication&comp=delete HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 24 Sep 2015 15:39:18 GMT
Content-Length:46
Content-Type: application/xml
Authorization: OSS qn6q**************:77Dv****************
<?xml version="1.0" encoding="UTF-8"?>
<ReplicationRules>
<ID>test_replication_1</ID>
</ReplicationRules>
返回示例
HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Thu, 24 Sep 2015 15:39:18 GMT
Connection: close
Content-Length: 0
Server: AliyunOSS
錯誤碼
錯誤碼 | 狀態碼 | 描述 |
NoSuchBucket | 404 NotFound | 請求的Bucket不存在。 |
TooManyReplicationRules | 400 BadRequest | 請求中配置的數據復制規則超過一條。 單次請求中只能配置一條數據復制規則。 |
TransferAccAlreadyInUse | 409Conflict | 對跨區域復制指定的目標Bucket關閉了傳輸加速,此時錯誤XML中返回跨區域復制的源Bucket和目標Bucket信息如下:
|
文檔內容是否對您有幫助?