GetBucketReplicationProgress - Object Storage Service

Memeriksa kemajuan tugas replikasi data bucket.

Sintaks permintaan

GET /?replicationProgress&rule-id=RuleId HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Header permintaan

Semua header dalam permintaan GetBucketReplicationProgress merupakan header permintaan umum. Untuk informasi lebih lanjut, lihat Header Permintaan Umum.

Parameter permintaan

Parameter	Tipe	Diperlukan	Deskripsi
rule-id	String	Ya	ID aturan replikasi data. Anda dapat memanggil operasi GetBucketReplication untuk menanyakan ID tersebut.

Header respons

Semua header dalam respons terhadap permintaan GetBucketReplicationProgress merupakan header respons umum. Untuk informasi lebih lanjut, lihat Header Respons Umum.

Parameter respons

Parameter	Tipe	Deskripsi
ReplicationProgress	Container	Kontainer yang digunakan untuk menyimpan kemajuan tugas replikasi data. Node induk: tidak ada Node anak: Rule
Rule	Container	Kontainer yang menyimpan kemajuan tugas replikasi data yang sesuai dengan setiap aturan replikasi data. Node induk: ReplicationConfiguration Node anak: ID, Destination, Status, dan Progress
ID	String	ID aturan replikasi data. Node induk: Rule Node anak: tidak ada
PrefixSet	Container	Kontainer yang menyimpan prefiks. Anda dapat menentukan hingga 10 prefiks dalam setiap aturan replikasi data. Node induk: Rule Node anak: Prefix
Prefix	String	Prefiks yang digunakan untuk menentukan objek yang akan direplikasi. Hanya objek yang cocok dengan prefiks yang direplikasi ke bucket tujuan. Node induk: PrefixSet Node anak: tidak ada
Action	String	Operasi yang disinkronkan ke bucket tujuan. Anda dapat mengatur Action ke satu atau lebih dari jenis operasi berikut. Nilai default: ALL. ALL: Operasi PUT, DELETE, dan ABORT disinkronkan ke bucket tujuan. PUT: Operasi tulis disinkronkan ke bucket tujuan, termasuk PutObject, PostObject, AppendObject, CopyObject, PutObjectACL, InitiateMultipartUpload, UploadPart, UploadPartCopy, dan CompleteMultipartUpload. Node induk: Rule Node anak: tidak ada
Destination	Container	Kontainer yang menyimpan informasi tentang bucket tujuan. Node induk: Rule Node anak: Bucket dan Location
Bucket	String	Bucket tujuan ke mana data direplikasi. Node induk: Destination Node anak: tidak ada
Location	String	Wilayah tempat bucket tujuan berada. Node induk: Destination Node anak: tidak ada
TransferType	String	Jenis transfer data yang digunakan untuk mentransfer data dalam replikasi data. internal: jenis transfer data yang menggunakan tautan transfer data default Object Storage Service (OSS). oss_acc: tautan di mana transmisi data dipercepat. Anda hanya dapat mengatur parameter TransferType ke oss_acc saat membuat aturan CRR.
HistoricalObjectReplication	String	Menunjukkan apakah data historis dari bucket sumber direplikasi ke bucket tujuan sebelum replikasi data diaktifkan. Nilai default: enabled. Nilai valid: enabled: menunjukkan bahwa data historis direplikasi ke bucket tujuan. disabled: menunjukkan bahwa data historis tidak direplikasi ke bucket tujuan. Hanya data yang diunggah ke bucket sumber setelah replikasi data diaktifkan untuk bucket sumber yang direplikasi.
Progress	Container	Kontainer yang menyimpan kemajuan tugas replikasi data. Parameter ini dikembalikan hanya ketika tugas replikasi data dalam status doing. Node induk: Rule Node anak: HistoricalObject dan NewObject
HistoricalObject	String	Persentase data historis yang direplikasi. Elemen ini valid hanya ketika HistoricalObjectReplication diatur ke enabled. Node induk: Progress Node anak: tidak ada
NewObject	String	Waktu yang digunakan untuk menentukan apakah data direplikasi ke bucket tujuan. Data yang ditulis ke bucket sumber sebelum waktu tersebut direplikasi ke bucket tujuan. Nilai elemen ini dalam format GMT. Contoh: Thu, 24 Sep 2015 15:39:18 GMT. Node induk: Progress Node anak: tidak ada

Deskripsi

Contoh Permintaan

GET /?replicationProgress&rule-id=test_replication_1 HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 24 Sep 2015 15:39:15 GMT
Authorization: OSS qn6q**************:77Dv****************

Contoh Respons

Catatan

Parameter TransferType terkandung dalam body XML respons hanya jika nilai TransferType diatur ke oss_acc dalam permintaan.

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Thu, 24 Sep 2015 15:39:15 GMT
Content-Length: 234
Content-Type: application/xml
Connection: close
Server: AliyunOSS

<?xml version="1.0" ?>
<ReplicationProgress>
 <Rule>
   <ID>test_replication_1</ID>
   <PrefixSet>
    <Prefix>source_image</Prefix>
    <Prefix>video</Prefix>
   </PrefixSet>
   <Action>PUT</Action>
   <Destination>
    <Bucket>target-bucket</Bucket>
    <Location>oss-cn-beijing</Location>
    <TransferType>oss_acc</TransferType>
   </Destination>
   <Status>doing</Status>
   <HistoricalObjectReplication>enabled</HistoricalObjectReplication>
   <Progress>
    <HistoricalObject>0.85</HistoricalObject>
    <NewObject>2015-09-24T15:28:14.000Z </NewObject>
   </Progress>
 </Rule>
</ReplicationProgress>

OSS SDK

Anda dapat menggunakan OSS SDK untuk bahasa pemrograman berikut guna memanggil GetBucketReplicationProgress:

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi GetBucketReplicationProgress, lihat get-bucket-replication-progress.

Kode kesalahan

Kode kesalahan	Status HTTP	Deskripsi
NoSuchBucket	404 NotFound	Pesan kesalahan yang dikembalikan karena bucket yang ditentukan tidak ada.
NoSuchReplicationRule	404 NotFound	Pesan kesalahan yang dikembalikan karena ID aturan yang ditentukan tidak ada.
NoSuchReplicationConfiguration	404 NotFound	Pesan kesalahan yang dikembalikan karena tidak ada aturan replikasi data yang dikonfigurasikan untuk bucket yang ditentukan.
TooManyReplicationRules	400 BadRequest	Pesan kesalahan yang dikembalikan karena lebih dari satu aturan replikasi data dikonfigurasikan dalam permintaan. Anda hanya dapat mengonfigurasikan satu aturan replikasi data dalam satu permintaan.