GetBucketOverwriteConfig - Object Storage Service

Panggil operasi GetBucketOverwriteConfig untuk mengambil konfigurasi overwrite bucket.

Catatan

Jika bucket tidak memiliki konfigurasi overwrite, operasi ini mengembalikan kode status 404.

Izin

Secara default, akun Alibaba Cloud memiliki semua izin. Pengguna Resource Access Management (RAM) dan peran RAM tidak memiliki izin secara default. Pemilik akun Alibaba Cloud atau administrator harus memberikan izin melalui kebijakan RAM atau kebijakan bucket.

API	Action	Deskripsi
GetBucketOverwriteConfig	`oss:GetBucketOverwriteConfig`	Mengambil konfigurasi overwrite bucket.

Sintaksis permintaan

GET /?overwriteConfig HTTP/1.1
Host: bucket-name.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

Header permintaan

Operasi ini hanya menggunakan header permintaan umum. Untuk informasi selengkapnya, lihat Header permintaan umum.

Elemen permintaan

Operasi ini tidak memiliki elemen permintaan.

Elemen respons

Nama	Tipe	Contoh	Deskripsi
OverwriteConfiguration	Container	None	Node root aturan yang tidak dapat di-overwrite. Node anak: Rule Node induk: None
Rule	Container	None	Aturan overwrite. Node anak: ID, Action, Prefix, Suffix, dan Principals Node induk: OverwriteConfiguration
ID	String	rule-001	Pengidentifikasi unik aturan. Node anak: None Node induk: Rule
Action	String	forbid	Tipe operasi. Hanya `forbid` yang didukung. `forbid` mencegah objek di-overwrite. Node anak: None Node induk: Rule
Prefix	String	a/	Awalan nama objek. Node anak: None Node induk: Rule
Suffix	String	.txt	Akhiran nama objek. Node anak: None Node induk: Rule
Principals	Container	None	Kumpulan entitas yang berwenang. Node anak: Principal Node induk: Rule
Principal	String	27737962156157xxxx	Entitas yang berwenang. Node anak: None Node induk: Principals

Header respons

Operasi ini hanya menggunakan header respons umum. Untuk informasi selengkapnya, lihat Header respons umum.

Contoh

Contoh permintaan

GET /?overwriteConfig HTTP/1.1
Host: bucket-name.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

Contoh respons

Respons sukses (aturan telah dikonfigurasi)

HTTP/1.1 200 OK
x-oss-request-id: 5C4E5B5C5E5F5A5B5C5D5E5F
Date: Mon, 25 Nov 2024 15:00:59 GMT
Content-Type: application/xml
Content-Length: 512

<?xml version="1.0" encoding="UTF-8"?>
<OverwriteConfiguration>
  <Rule>
    <ID>rule-001</ID>
    <Action>forbid</Action>
    <Prefix>a/</Prefix>
    <Suffix>.txt</Suffix>
    <Principals>
      <Principal>27737962156157xxxx</Principal>
    </Principals>
  </Rule>
  <Rule>
    <ID>rule-002</ID>
    <Action>forbid</Action>
    <Prefix>images/</Prefix>
    <Suffix/>
    <Principals/>
  </Rule>
  <Rule>
    <ID>rule-003</ID>
    <Action>forbid</Action>
    <Prefix/>
    <Suffix>.jpg</Suffix>
    <Principals/>
  </Rule>
  <Rule>
    <ID>rule-004</ID>
    <Action>forbid</Action>
    <Prefix/>
    <Suffix/>
    <Principals>
      <Principal>27737962156157xxxx</Principal>
    </Principals>
  </Rule>
</OverwriteConfiguration>

Contoh ini menunjukkan beberapa format aturan yang mungkin:

Rule1 mencakup awalan, akhiran, dan principal tertentu. Aturan ini melarang pengguna RAM 27737962156157xxxx melakukan overwrite terhadap objek dengan awalan `a/` dan akhiran `.txt`.
Rule2 hanya menentukan awalan. Aturan ini melarang semua pengguna melakukan overwrite terhadap objek dengan awalan `images/`.
Rule3 hanya menentukan akhiran. Aturan ini melarang semua pengguna melakukan overwrite terhadap objek dengan akhiran `.jpg`.
Rule4 hanya menentukan principal. Aturan ini melarang pengguna yang ditentukan melakukan overwrite terhadap objek apa pun dalam bucket.
Respons ketika tidak ada aturan yang dikonfigurasi (404)

HTTP/1.1 404 Not Found
x-oss-request-id: 5C4E5B5C5E5F5A5B5C5XXXX
Date: Mon, 25 Nov 2025 15:00:59 GMT
Content-Type: application/xml
Content-Length: 200

<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>NoSuchOverwriteConfiguration</Code>
  <Message>The specified overwrite configuration does not exist.</Message>
  <RequestId>5C4E5B5C5E5F5A5B5C5XXXX</RequestId>
  <HostId>bucket-name.oss-cn-hangzhou.aliyuncs.com</HostId>
</Error>