全部产品
Search
文档中心

Object Storage Service:GetBucketReplication

更新时间:Jul 02, 2025

Memeriksa aturan replikasi data yang dikonfigurasi untuk sebuah bucket.

Sintaks permintaan

GET /?replication HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com 
Date: Tanggal GMT
Authorization: NilaiTandaTangan

Parameter respons

Parameter

Tipe

Contoh

Deskripsi

ReplicationConfiguration

Container

Tidak tersedia

Kontainer yang menyimpan konfigurasi replikasi data.

Node induk: tidak ada

Node anak: Rule

Rule

Container

Tidak tersedia

Kontainer yang menyimpan aturan replikasi data.

Node induk: ReplicationConfiguration

Node anak: Destination, HistoricalObjectReplication, Status, dan ID

ID

String

test_replication_1

ID dari aturan replikasi data.

Node induk: Rule

Node anak: tidak ada

PrefixSet

Container

Tidak tersedia

Kontainer yang menyimpan prefiks. Anda dapat menentukan hingga 10 prefiks dalam setiap aturan replikasi data.

Node induk: Rule

Node anak: Prefix

Prefix

String

source1

Prefiks objek yang direplikasi ke bucket tujuan.

Node induk: PrefixSet

Node anak: tidak ada

Action

String

PUT

Operasi yang disinkronkan ke bucket tujuan.

Anda dapat mengatur parameter Action menjadi satu atau lebih tipe operasi berikut. Nilai default: ALL.

  • ALL: menunjukkan bahwa operasi PUT, DELETE, dan ABORT disinkronkan ke bucket tujuan.

  • PUT: menunjukkan bahwa operasi penulisan disinkronkan ke bucket tujuan, termasuk operasi PutObject, PostObject, AppendObject, CopyObject, PutObjectACL, InitiateMultipartUpload, UploadPart, UploadPartCopy, dan CompleteMultipartUpload.

Node induk: Rule

Node anak: tidak ada

Status

String

melakukan

Status tugas replikasi data.

Nilai valid:

  • memulai: OSS membuat tugas replikasi data setelah aturan replikasi data dikonfigurasi. Dalam hal ini, status tugas adalah memulai.

  • melakukan: Status tugas replikasi data setelah aturan replikasi data mulai berlaku. Dalam hal ini, status tugas adalah melakukan.

  • menutup: OSS membersihkan tugas replikasi data setelah aturan replikasi data yang sesuai dihapus. Dalam hal ini, status tugas adalah menutup.

Node induk: Rule

Node anak: tidak ada

Destination

Container

Tidak tersedia

Kontainer yang menyimpan informasi tentang bucket tujuan.

Node induk: Rule

Node anak: Bucket dan Location

Bucket

String

destbucket

Bucket tujuan ke mana 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

Jenis transfer data yang digunakan untuk mentransfer data dalam replikasi data. Parameter TransferType terdapat dalam respons hanya ketika nilai parameter TransferType diatur ke oss_acc dalam permintaan.

Nilai default: internal. Nilai valid:

  • internal: jenis transfer data yang menggunakan tautan transfer data default OSS.

  • oss_acc: tautan di mana transmisi data dipercepat. Anda dapat mengatur parameter TransferType ke oss_acc hanya saat membuat aturan CRR.

HistoricalObjectReplication

String

disabled

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

Nilai default: disabled. 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.

Node induk: Rule

Node anak: tidak ada

SyncRole

String

aliyunramrole

Peran yang digunakan untuk replikasi data. Parameter ini terdapat dalam respons hanya ketika objek tujuan dienkripsi menggunakan enkripsi sisi server (SSE) yang menggunakan kunci master pelanggan (CMK) yang dikelola oleh Key Management Service (KMS) untuk enkripsi (SSE-KMS).

RTC

Container

Tidak tersedia

Kontainer yang menyimpan status fitur RTC.

Node induk: Rule

Node anak: Status

Status

String

diaktifkan

Status fitur RTC. Parameter ini termasuk dalam respons hanya ketika fitur RTC dalam keadaan mengaktifkan atau diaktifkan.

Nilai default: disabled. Nilai valid:

  • mengaktifkan

  • diaktifkan

  • dimatikan

Node induk: RTC

Node anak: tidak ada

Contoh

  • Contoh Permintaan

GET /?replication HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com 
Date: Kam, 24 Sep 2015 15:39:15 GMT
Authorization: OSS qn6q**************:77Dv****************
  • Contoh Respons

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906**** 
Date: Kam, 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>
    <Action>PUT</Action>
    <Destination>
      <Bucket>destbucket</Bucket>
      <Location>oss-cn-beijing</Location>
      <TransferType>oss_acc</TransferType>
    </Destination>
    <Status>melakukan</Status>
    <HistoricalObjectReplication>enabled</HistoricalObjectReplication>
    <SyncRole>aliyunramrole</SyncRole>
    <RTC>
      <Status>enabled</Status>
    </RTC>
  </Rule>  
</ReplicationConfiguration>

SDK OSS

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

ossutil

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

Kode kesalahan

Kode kesalahan

Kode status HTTP

Deskripsi

NoSuchBucket

404 NotFound

Pesan kesalahan yang dikembalikan karena bucket yang ditentukan tidak ada.

NoSuchReplicationConfiguration

404 NotFound

Pesan kesalahan yang dikembalikan karena tidak ada aturan replikasi data yang dikonfigurasi untuk bucket yang ditentukan.