All Products
Search
Document Center

Object Storage Service:GetBucketReplication

Last Updated:May 25, 2026

Mendapatkan 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

Parameter respons

Parameter

Tipe

Contoh

Deskripsi

ReplicationConfiguration

Container

N/A

Container untuk konfigurasi replikasi data.

Node induk: tidak ada

Node anak: Rule

Rule

Container

N/A

Container untuk aturan replikasi data.

Node induk: ReplicationConfiguration

Node anak: Destination, HistoricalObjectReplication, Status, ID, dan UserTaggings

ID

String

test_replication_1

ID aturan replikasi data.

Node induk: Rule

Node anak: tidak ada

PrefixSet

Container

N/A

Container untuk prefix. Anda dapat menentukan hingga 10 prefix dalam setiap aturan replikasi data.

Node induk: Rule

Node anak: Prefix

Prefix

String

source1

Prefix objek yang direplikasi ke bucket tujuan.

Node induk: PrefixSet

Node anak: tidak ada

Action

String

PUT

Operasi yang disinkronkan ke bucket tujuan.

Tentukan satu atau beberapa tipe 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

Status

String

doing

Status tugas replikasi data.

Nilai valid:

  • starting: OSS membuat tugas replikasi data setelah aturan replikasi data dikonfigurasi. Pada fase ini, status tugas adalah starting.

  • doing: Status tugas replikasi data setelah aturan replikasi data aktif. Pada fase ini, status tugas adalah doing.

  • closing: OSS membersihkan tugas replikasi data setelah aturan replikasi data dihapus. Pada fase ini, status tugas adalah closing.

Node induk: Rule

Node anak: tidak ada

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: tidak ada

Location

String

oss-cn-beijing

Wilayah tempat bucket tujuan berada.

Node induk: Destination

Node anak: tidak ada

TransferType

String

oss_acc

Tipe transfer data untuk replikasi data. Elemen ini disertakan dalam respons hanya jika TransferType pada permintaan diatur ke oss_acc.

Nilai default: internal. Nilai valid:

  • internal: tipe transfer yang menggunakan tautan transfer default OSS.

  • oss_acc: tautan dengan akselerasi transmisi data. Anda hanya dapat mengatur TransferType ke oss_acc saat membuat aturan CRR.

HistoricalObjectReplication

String

disabled

Menentukan apakah data historis dari bucket sumber direplikasi ke bucket tujuan sebelum replikasi data diaktifkan. Nilai default: enabled.

Nilai default: disabled. Nilai valid:

  • enabled: data historis direplikasi ke bucket tujuan.

  • disabled: data historis tidak direplikasi ke bucket tujuan. Hanya data yang diunggah ke bucket sumber setelah replikasi data aktif yang direplikasi.

Node induk: Rule

Node anak: tidak ada

SyncRole

String

aliyunramrole

Role yang digunakan untuk replikasi data. Parameter ini disertakan dalam respons hanya jika objek tujuan dienkripsi menggunakan server-side encryption (SSE) dengan customer master keys (CMK) yang dikelola Key Management Service (KMS), yaitu SSE-KMS.

RTC

Container

N/A

Container untuk status fitur RTC.

Node induk: Rule

Node anak: Status

Status

String

enbaled

Status fitur RTC. Parameter ini disertakan dalam respons hanya jika fitur RTC berada pada state enabling atau enabled.

Nilai default: disabled. Nilai valid:

  • enabling

  • enabled

  • disabled

Node induk: RTC

Node anak: tidak ada

UserTaggings

Container

N/A

Container untuk aturan filter berbasis tag. Elemen ini disertakan dalam respons hanya jika 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:

  • AND: hanya mereplikasi objek yang seluruh tag-nya sesuai dengan tag dalam aturan filter.

  • OR: mereplikasi objek yang salah satu tag-nya sesuai dengan tag dalam aturan filter.

Node induk: UserTaggings

Node anak: tidak ada

UserTagging

Container

N/A

Container untuk satu pasangan kunci-nilai tag. Anda dapat menentukan hingga 10 tag.

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: tidak ada

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: tidak ada

Contoh

  • Contoh permintaan

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****************
  • Contoh respons

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>

OSS SDKs

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

ossutil

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

Kode error

Kode error

Kode status HTTP

Deskripsi

NoSuchBucket

404 NotFound

Pesan error yang dikembalikan karena bucket yang ditentukan tidak ada.

NoSuchReplicationConfiguration

404 NotFound

Pesan error yang dikembalikan karena tidak ada aturan replikasi data pada bucket yang ditentukan.