全部产品
Search
文档中心

Object Storage Service:GetBucketReplicationLocation

更新时间:Jul 02, 2025

Anda dapat memanggil operasi ini untuk menanyakan wilayah di mana bucket tujuan dapat berada. Wilayah bucket tujuan dapat ditentukan berdasarkan respons yang diberikan untuk operasi tersebut.

Struktur permintaan

GET /?replicationLocation HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com 
Date: GMT Date
Authorization: SignatureValue

Elemen respons

Elemen

Tipe

Deskripsi

ReplicationLocation

Container

Kontainer yang menyimpan wilayah di mana bucket tujuan dapat berada.

Location

String

Wilayah di mana bucket tujuan dapat berada. Contoh: oss-cn-beijing.

Node induk: ReplicationLocation

Node anak: tidak ada

Catatan

Jika bucket tujuan dapat berada di beberapa wilayah, beberapa wilayah akan tercantum dalam respons. Jika wilayah tempat bucket tujuan dapat berada tidak ada, nilai Location adalah null.

LocationTransferTypeConstraint

Container

Kontainer yang menyimpan wilayah di mana bucket tujuan dapat berada dengan TransferType yang ditentukan.

LocationTransferType

Container

Kontainer yang menyimpan wilayah di mana bucket tujuan dapat berada dengan informasi TransferType.

TransferTypes

Container

Kontainer yang menyimpan tipe transmisi.

Type

String

Tautan yang digunakan untuk mentransfer data dalam replikasi data. Nilai default: internal.

Nilai valid:

  • internal: tautan default.

  • oss_acc: tautan di mana transmisi data dipercepat. TransferType hanya dapat diatur ke oss_acc untuk aturan replikasi lintas wilayah (CRR).

Contoh

  • Contoh Permintaan

GET /?replicationLocation 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

    Elemen TransferType hanya terdapat dalam body XML dari respons ketika 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: 84
Content-Type: application/xml 
Connection: close
Server: AliyunOSS

<?xml version="1.0" ?>
<ReplicationLocation>
  <Location>oss-cn-beijing</Location>
  <Location>oss-cn-qingdao</Location>
  <Location>oss-cn-shenzhen</Location>
  <Location>oss-cn-hongkong</Location>
  <Location>oss-us-west-1</Location>
  <LocationTransferTypeConstraint>
    <LocationTransferType>
      <Location>oss-cn-hongkong</Location>
        <TransferTypes>
          <Type>oss_acc</Type>          
        </TransferTypes>
      </LocationTransferType>
      <LocationTransferType>
        <Location>oss-us-west-1</Location>
        <TransferTypes>
          <Type>oss_acc</Type>
        </TransferTypes>
      </LocationTransferType>
    </LocationTransferTypeConstraint>
  </ReplicationLocation>

OSS SDKs

Anda dapat menggunakan OSS SDKs untuk bahasa pemrograman berikut guna memanggil GetBucketReplicationLocation:

ossutil

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

Kode kesalahan

Kode kesalahan

Status HTTP

Deskripsi

NoSuchBucket

404 NotFound

Pesan kesalahan yang dikembalikan karena bucket yang ditentukan tidak ada.