PutBucketRTC - Object Storage Service - Alibaba Cloud ドキュメントセンター

既存のクロスリージョンレプリケーション (CRR) ルールに対して、レプリケーション時間制御 (RTC) 機能を有効または無効にします。

リクエスト構文

PUT /?rtc 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"?>
<ReplicationRule>
    <RTC>
        <Status>enabled or disabled</Status>
    </RTC>
    <ID>rule id</ID>
</ReplicationRule>

リクエストヘッダー

PutBucketRTC リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。詳細については、「共通のリクエストヘッダー」をご参照ください。

リクエストパラメーター

パラメーター	タイプ	必須	例	説明
ReplicationRule	コンテナー	はい	該当なし	RTC 構成を格納するコンテナー。親ノード: なし子ノード: RTC および RuleID
RTC	コンテナー	はい	該当なし	RTC 機能のステータスを格納するコンテナー。親ノード: ReplicationRule 子ノード: Status
Status	文字列	はい	enabled	RTC 機能のステータス。デフォルト値: disabled。有効な値: enabled: RTC 機能が有効です。重要 RTC 機能が有効になっている場合、既存データのレプリケーションが進行中であるか、レプリケーションルールが有効でない場合、RTC 機能のステータスは enabling になります。既存データのレプリケーションが完了しているか、既存データのレプリケーションが選択されておらず、レプリケーションルールが有効な場合、RTC 機能のステータスは enabled になります。 disabled: RTC 機能が無効です。親ノード: RTC 子ノード: なし
ID	文字列	はい	test_replication_rule_1	RTC 機能のステータスを構成する CRR ルールの ID。 DeleteBucketReplication 操作を呼び出して、CRR ルールの ID を取得できます。親ノード: ReplicationRule 子ノード: Status

レスポンスヘッダー

PutBucketRTC リクエストへのレスポンスのすべてのヘッダーは、共通のレスポンスヘッダーです。詳細については、「共通のレスポンスヘッダー」をご参照ください。

例

リクエストの例

PUT /?rtc HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 21 Jul 2022 15:39:18 GMT
Content-Length: 46
Content-Type: application/xml
Authorization: OSS qn6q**************:77Dv****************


<?xml version="1.0" encoding="UTF-8"?>
<ReplicationRule>
    <RTC>
        <Status>enabled</Status>
    </RTC>
    <ID>test_replication_rule_1</ID>
</ReplicationRule>

レスポンスの例

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Thu, 21 Jul 2022 15:39:18 GMT
Content-Length: 0
Connection: close
Server: AliyunOSS

OSS SDK

以下のプログラミング言語の OSS SDK を使用して、PutBucketRTC 操作を呼び出すことができます。

ossutil

PutBucketRTC 操作に対応する ossutil コマンドについては、「put-bucket-rtc」をご参照ください。

エラーコード

エラーコード	HTTP ステータスコード	説明
ReplicationLocationNotSupportRtc	400 Bad Request	このリージョンでは RTC 機能は使用できません。RTC 機能が使用可能なリージョンについては、「概要」をご参照ください。
BucketReplicationInClosingStatus	400 Bad Request	CRR ルールが無効になっている場合、RTC 機能を有効または無効にすることはできません。
BucketReplicationNotSupportRtc	400 Bad Request	現在の CRR ルールは RTC 機能をサポートしていません。テクニカルサポートに連絡して、問題のトラブルシューティングと解決を行ってください。