全部產品
Search
文件中心

Object Storage Service:DeleteBucketReplication

更新時間:Jun 08, 2024

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

<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>TransferAccAlreadyInUse</Code>
  <Message>The transfer acceleration is already used by cross-region replication.</Message>
  <SourceBucket>srcBucket</SourceBucket>
  <DestinationBucket>destBucket</DestinationBucket>
  <RequestId>5F1E76142A535D373683****</RequestId>
  <HostId>oss-cn-hangzhou.aliyuncs.com</HostId>
</Error>