Mengkueri aturan replikasi data yang dikonfigurasi untuk sebuah bucket.
Sintaks permintaan
GET /?replication HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
Elemen respons
|
Name |
Type |
Example |
Description |
|
ReplicationConfiguration |
Container |
N/A |
Container untuk aturan replikasi bucket. Node induk: None Node anak: Rule |
|
Rule |
Container |
N/A |
Container untuk aturan replikasi. Node induk: ReplicationConfiguration Node anak: Destination, HistoricalObjectReplication, Status, ID, dan UserTaggings |
|
ID |
String |
test_replication_1 |
ID aturan replikasi. Node induk: Rule Node anak: None |
|
PrefixSet |
Container |
N/A |
Container untuk awalan. Hingga 10 awalan dapat ditentukan dalam setiap aturan replikasi. Node induk: Rule Node anak: Prefix |
|
Prefix |
String |
source1 |
Awalan objek yang direplikasi ke bucket tujuan. Node induk: PrefixSet Node anak: None |
|
Action |
String |
PUT |
Operasi yang direplikasi ke bucket tujuan. Action mendukung tipe operasi berikut. Anda dapat menentukan satu atau beberapa tipe.
Node induk: Rule Node anak: None |
|
Status |
String |
doing |
Status replikasi. Nilai valid:
Node induk: Rule Node anak: None |
|
Destination |
Container |
N/A |
Container untuk informasi bucket tujuan. Node induk: Rule Node anak: Bucket dan Location |
|
Bucket |
String |
destbucket |
Bucket tujuan tempat data direplikasi. Node induk: Destination Node anak: None |
|
Location |
String |
oss-cn-beijing |
Wilayah tempat bucket tujuan berada. Node induk: Destination Node anak: None |
|
TransferType |
String |
oss_acc |
Tipe transfer data yang digunakan untuk replikasi. Elemen ini disertakan dalam respons hanya ketika tipe transfer adalah oss_acc. Nilai valid:
|
|
HistoricalObjectReplication |
String |
disabled |
Menentukan apakah data historis direplikasi. Data historis mengacu pada objek yang sudah ada di bucket sumber sebelum aturan replikasi diterapkan. Nilai valid:
Node induk: Rule Node anak: None |
|
SyncRole |
String |
aliyunramrole |
Peran yang digunakan untuk replikasi lintas wilayah. Elemen ini disertakan dalam respons hanya ketika objek terenkripsi SSE-KMS direplikasi. |
|
RTC |
Container |
N/A |
Container untuk status Replication Time Control (RTC). Node induk: Rule Node anak: Status |
|
Status |
String |
enbaled |
Status RTC. Elemen ini disertakan dalam respons hanya ketika status RTC adalah enabling atau enabled. Nilai valid:
Node induk: RTC Node anak: None |
|
UserTaggings |
Container |
N/A |
Container untuk aturan filter berbasis tag. Elemen ini disertakan dalam respons hanya ketika aturan filter berbasis tag dikonfigurasi. Node induk: Rule Node anak: FilterType, UserTagging |
|
FilterType |
String |
OR |
Kebijakan pemfilteran tag. Sensitif terhadap huruf besar/kecil. Nilai valid:
Node induk: UserTaggings Node anak: None |
|
UserTagging |
Container |
N/A |
Container untuk satu pasangan kunci-nilai tag. Hingga 10 tag dapat ditentukan. Node induk: UserTaggings Node anak: Key, Value |
|
Key |
String |
key1 |
Kunci tag. Panjang maksimum: 128 karakter. Sensitif terhadap huruf besar/kecil. Karakter valid: huruf, angka, spasi, dan karakter khusus berikut: +‑=._:/ Node induk: UserTagging Node anak: None |
|
Value |
String |
value1 |
Nilai tag. Panjang maksimum: 256 karakter. Sensitif terhadap huruf besar/kecil. Karakter valid: huruf, angka, spasi, dan karakter khusus berikut: +‑=._:/ Node induk: UserTagging Node anak: None |
Contoh
-
Permintaan Contoh
GET /?replication HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 24 Sep 2015 15:39:15 GMT
Authorization: OSS qn6q**************:77Dv****************
-
Respons Contoh
HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Thu, 24 Sep 2015 15:39:15 GMT
Content-Length: 186
Content-Type: application/xml
Connection: close
Server: AliyunOSS
<?xml version="1.0" ?>
<ReplicationConfiguration>
<Rule>
<ID>test_replication_1</ID>
<PrefixSet>
<Prefix>source1</Prefix>
<Prefix>video</Prefix>
</PrefixSet>
<UserTaggings>
<FilterType>OR</FilterType>
<UserTagging>
<Key>key1</Key>
<Value>value1</Value>
</UserTagging>
<UserTagging>
<Key>key2</Key>
<Value>value2</Value>
</UserTagging>
</UserTaggings>
<Action>PUT</Action>
<Destination>
<Bucket>destbucket</Bucket>
<Location>oss-cn-beijing</Location>
<TransferType>oss_acc</TransferType>
</Destination>
<Status>doing</Status>
<HistoricalObjectReplication>enabled</HistoricalObjectReplication>
<SyncRole>aliyunramrole</SyncRole>
<RTC>
<Status>enabled</Status>
</RTC>
</Rule>
</ReplicationConfiguration>
SDK
SDK berikut tersedia untuk operasi ini:
Alat baris perintah ossutil
Untuk perintah ossutil yang sesuai dengan operasi GetBucketReplication, lihat get-bucket-replication.
Kode error
|
Error code |
HTTP status code |
Description |
|
NoSuchBucket |
404 NotFound |
Bucket yang ditentukan tidak ada. |
|
NoSuchReplicationConfiguration |
404 NotFound |
Tidak ada aturan replikasi data yang dikonfigurasi untuk bucket yang ditentukan. |