この操作を呼び出すと、バケットのデータレプリケーションを無効にし、バケットに設定されているデータレプリケーションルールを削除できます。データレプリケーションルールが削除されると、ソースバケットで実行されたすべての操作は宛先バケットに同期されません。
使用上の注意
データレプリケーションルールが設定されていない場合は、200 OK が返されます。
DeleteBucketReplication は、データレプリケーションルールをすぐに削除するわけではありません。OSS は、ルールに基づいて実行されたデータレプリケーションタスクをクリアするのに時間がかかります。このプロセス中、データレプリケーションタスクは終了状態になります。データレプリケーションタスクがクリアされると、データレプリケーションルールは削除されます。
終了状態のデータレプリケーションタスクに対応するデータレプリケーションルールを削除するために DeleteBucketReplication を呼び出すと、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。GetBucketReplication を呼び出して ID を取得できます。 親ノード: ReplictionRules 子ノード: なし |
例
リクエストの例
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
OSS SDK
次のプログラミング言語の OSS SDK を使用して DeleteBucketReplication を呼び出すことができます。
ossutil
DeleteBucketReplication 操作に対応する ossutil コマンドについては、「delete-bucket-replication」をご参照ください。
エラーコード
エラーコード | HTTP ステータスコード | 説明 |
NoSuchBucket | 404 NotFound | 指定されたバケットが存在しないために返されるエラーメッセージ。 |
TooManyReplicationRules | 400 BadRequest | リクエストに複数のデータレプリケーションルールが設定されているために返されるエラーメッセージ。 1 つのリクエストで設定できるデータレプリケーションルールは 1 つだけです。 |
TransferAccAlreadyInUse | 409Conflict | CRR ルールで指定された宛先バケットの転送アクセラレーションが無効になっているために返されるエラーメッセージ。この場合、レスポンスの XML 本文には、ソースバケットと宛先バケットに関する以下の情報が含まれます。
|