All Products
Search
Document Center

Object Storage Service:GetBucketReplication

Last Updated:Mar 28, 2026

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.

  • ALL (default): Operasi PUT, DELETE, dan ABORT direplikasi ke bucket tujuan.

  • PUT: Operasi tulis direplikasi ke bucket tujuan, termasuk PutObject, PostObject, AppendObject, CopyObject, PutObjectACL, InitiateMultipartUpload, UploadPart, UploadPartCopy, dan CompleteMultipartUpload.

Node induk: Rule

Node anak: None

Status

String

doing

Status replikasi.

Nilai valid:

  • starting: Setelah aturan replikasi dikonfigurasi, OSS menyiapkan tugas replikasi. Status replikasi adalah starting selama fase ini.

  • doing: Aturan replikasi sedang berlaku dan data sedang direplikasi.

  • closing: Setelah aturan replikasi dihapus, OSS melakukan pembersihan. Status replikasi adalah closing selama fase ini.

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:

  • internal (default): Tautan transfer OSS standar.

  • oss_acc: Tautan akselerasi transfer. Tautan akselerasi transfer hanya tersedia untuk aturan replikasi lintas wilayah (CRR).

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:

  • enabled (default): Data historis direplikasi ke bucket tujuan.

  • disabled: Data historis tidak direplikasi. Hanya data yang ditulis setelah aturan replikasi diterapkan yang direplikasi.

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:

  • enabling: RTC sedang diaktifkan.

  • enabled: RTC diaktifkan.

  • disabled (default): RTC dinonaktifkan.

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:

  • AND: Hanya mereplikasi objek yang tag-nya sesuai dengan semua tag yang ditentukan dalam aturan filter.

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

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.