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

バケットのデータ複製タスクの進行状況を照会します。

リクエスト構文

GET /?replicationProgress&rule-id=RuleId HTTP/1.1
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
日付: GMT日付
権限付与: SignatureValue

リクエストヘッダー

このリクエストには、共通リクエストヘッダーのみが含まれます。詳細については、「共通HTTPヘッダー」をご参照ください。

リクエストパラメーター

パラメーター	データ型	必須	説明
rule-id	String	必須	データレプリケーションルールのID。 GetBucketReplication操作を呼び出してIDを照会できます。

レスポンスヘッダー

このリクエストには、共通のレスポンスヘッダーのみが含まれます。詳細については、「共通HTTPヘッダー」をご参照ください。

レスポンスパラメーター

パラメーター	データ型	説明
ReplicationProgress	Container	データ複製タスクの進行状況を格納するために使用されるコンテナー。親ノード: なし子ノード: ルール
ルール	Container	各データレプリケーションルールに対応するデータレプリケーションタスクの進行状況を格納するコンテナー。親ノード: ReplicationConfiguration 子ノード: ID、宛先、ステータス、および進行状況
ID	String	データレプリケーションルールのID。親ノード: ルール子ノード: なし
PrefixSet	Container	プレフィックスを格納するコンテナー。各データレプリケーションルールには、最大10個のプレフィックスを指定できます。親ノード: ルール子ノード: プレフィックス
接頭辞	String	レプリケートするオブジェクトを指定するために使用されるプレフィックス。プレフィックスと一致するオブジェクトのみが、宛先バケットにレプリケートされます。親ノード: PrefixSet 子ノード: なし
Action	String	宛先バケットに同期される操作。アクションは、次の1つ以上の操作タイプに設定できます。デフォルト値: ALL。 ALL: PUT、DELETE、およびABORT操作は、宛先バケットに同期されます。 PUT: 書き込み操作は、PutObject、PostObject、AppendObject、CopyObject、PutObjectACL、InitiateMultipartUpload、UploadPart、UploadPartCopy、CompleteMultipartUploadなどの宛先バケットに同期されます。親ノード: ルール子ノード: なし
目的地	Container	宛先バケットに関する情報を格納するコンテナー。親ノード: ルール子ノード: バケットと場所
バケット	String	データがレプリケートされる宛先バケット。親ノード: 宛先子ノード: なし
位置	String	宛先バケットが配置されているリージョン。親ノード: 宛先子ノード: なし
TransferType	String	データレプリケーションでデータを転送するために使用されるデータ転送タイプ。 internal: Object Storage Service (OSS) のデフォルトのデータ転送リンクを使用するデータ転送タイプ。 oss_acc: データ送信が加速されるリンク。 CRRルールを作成する場合にのみ、TransferTypeパラメーターをoss_accに設定できます。
HistoricalObjectReplication	String	データレプリケーションを有効にする前に、ソースバケットの履歴データをターゲットバケットにレプリケートするかどうかを示します。デフォルト値：enabled。有効な値： enabled: 履歴データが宛先バケットにレプリケートされることを示します。 disabled: 履歴データが宛先バケットにレプリケートされないことを示します。ソースバケットのデータレプリケーションが有効になった後にソースバケットにアップロードされたデータのみがレプリケートされます。
進捗	Container	データレプリケーションタスクの進行状況を格納するコンテナー。このパラメーターは、データ複製タスクが実行中状態の場合にのみ返されます。親ノード: ルール子ノード: HistoricalObjectおよびNewObject
HistoricalObject	String	複製された履歴データの割合。この要素は、HistoricalObjectReplicationが有効に設定されている場合にのみ有効です。親ノード: 進行状況子ノード: なし
NewObject	String	データが宛先バケットにレプリケートされるかどうかを判断するために使用される時間。時刻より前にソースバケットに書き込まれたデータは、ターゲットバケットにレプリケートされます。この要素の値はGMT形式です。例: 9月24日木曜日2015 15:39:18 GMT。親ノード: 進行状況子ノード: なし

説明

サンプルリクエスト

GET /?replicationProgress&rule-id=test_replication_1 HTTP/1.1
ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com
日付: 9月2015日木曜日15:39:15 GMT
承認: OSS qn6qrrqxo2oawuk53otf ****:CTkuxpLAi4XZ + WwIfNm0Fmgb ****

レスポンスの例

説明 TransferTypeパラメーターは、リクエストでTransferTypeの値がoss_accに設定されている場合にのみ、レスポンスのXMLボディに含まれます。

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906 ****
日付: 9月2015日木曜日15:39:15 GMT
コンテンツ-長さ: 234
Content-Type: application/xml
接続: 閉じる
サーバー: AliyunOSS

<?xml version="1.0" ?>
<ReplicationProgress>
 <Rule>
   <ID>test_replication_1</ID>
   <PrefixSet>
    <プレフィックス> source_image</プレフィックス>
    <Prefix> ビデオ </Prefix>
   </PrefixSet>
   <アクション> PUT</Action>
   <宛先>
    <Bucket>target-bucket</Bucket>
    <Location>oss-cn-beijing</Location>
    <TransferType>oss_acc</TransferType>
   </宛先>
   <ステータス> 実行中 </ステータス>
   <HistoricalObjectReplication>enabled</HistoricalObjectReplication>
   <進行状況>
    <HistoricalObject>0.85</HistoricalObject>
    <NewObject>2015-09-24T15:28:14.000Z </NewObject>
   </進行状況>
 </ルール>
</ReplicationProgress>

エラーコード

エラーコード	HTTPステータスコード	説明
NoSuchBucket	404 NotFound	指定されたバケットが存在しない場合に返されるエラーメッセージ。
NoSuchReplicationRule	404 NotFound	指定されたルールIDが存在しない場合に返されるエラーメッセージ。
NoSuchReplicationConfiguration	404 NotFound	指定されたバケットにデータレプリケーションルールが設定されていない場合に返されるエラーメッセージ。
TooManyReplicationRules	400 BadRequest	リクエストで複数のデータレプリケーションルールが設定されている場合に返されるエラーメッセージ。 1回のリクエストで設定できるデータレプリケーションルールは1つだけです。