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資訊如下:
|