PutBucketOverwriteConfig - Object Storage Service

Panggil operasi PutBucketOverwriteConfig untuk mengonfigurasi perlindungan terhadap overwrite pada bucket. Konfigurasi ini mencegah objek tertentu ditimpa.

Perhatian

Jika Anda hanya mengonfigurasi forbid, overwrite dilarang dalam semua kasus. Konfigurasi ini memiliki risiko tinggi.
Operasi PutBucketOverwriteConfig menggunakan semantik overwrite. Misalnya, jika sebuah bucket telah dikonfigurasi dengan aturan perlindungan overwrite bernama Rule1 dan Anda ingin menambahkan aturan lain bernama Rule2, lakukan langkah-langkah berikut:
- Panggil operasi GetBucketOverwriteConfig untuk mengambil konfigurasi saat ini yang berisi Rule1.
- Tambahkan Rule2 ke konfigurasi yang telah diambil.
- Panggil operasi PutBucketOverwriteConfig untuk mengunggah konfigurasi baru yang berisi Rule1 dan Rule2.
Jika GetBucketOverwriteConfig mengembalikan error 404, artinya tidak ada konfigurasi perlindungan overwrite untuk bucket tersebut. Anda dapat langsung memanggil PutBucketOverwriteConfig untuk menetapkan aturan baru.
Satu bucket dapat memiliki maksimal 100 aturan perlindungan overwrite.
Panjang maksimum untuk Prefix dan Suffix adalah 1.023 karakter.
Setiap aturan dapat memiliki paling banyak satu prefix dan satu suffix. Prefix dan suffix tidak mendukung ekspresi reguler. Jika Anda memasukkan tanda bintang (*), karakter tersebut diperlakukan sebagai string.
ID bersifat opsional. Jika tidak ditentukan, sistem akan menghasilkan universally unique identifier (UUID) secara acak. Jika Anda menentukan ID, nilainya harus unik—aturan yang berbeda tidak boleh memiliki ID yang sama.
Principal mendukung karakter wildcard asterisk (*). Untuk informasi selengkapnya tentang cara mengonfigurasi Principal, lihat Contoh kebijakan bucket.
Sebuah aturan hanya cocok jika semua kondisi filternya (Prefix, Suffix, dan Principals) terpenuhi. Jika terdapat aturan yang cocok, perlindungan overwrite dipicu dan permintaan overwrite ditolak.

Izin

Akun Alibaba Cloud memiliki semua izin secara default. Pengguna Resource Access Management (RAM) atau Peran RAM di bawah akun Alibaba Cloud tidak memiliki izin secara default. Anda harus memberikan izin kepada pengguna RAM atau peran RAM tersebut melalui kebijakan RAM atau kebijakan bucket.

API	Action	Deskripsi
PutBucketOverwriteConfig	`oss:PutBucketOverwriteConfig`	Mengonfigurasi perlindungan overwrite untuk bucket.

Sintaksis permintaan

PUT /?overwriteConfig HTTP/1.1
Host: bucket-name.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<OverwriteConfiguration>
  <Rule>
    <ID>string</ID>
    <Action>forbid</Action>
    <Prefix>string</Prefix>
    <Suffix>string</Suffix>
    <Principals>
      <Principal>string</Principal>
    </Principals>
  </Rule>
</OverwriteConfiguration>

Header permintaan

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

Elemen permintaan

Nama	Tipe	Wajib	Contoh	Deskripsi
OverwriteConfiguration	Container	Ya	None	Node root untuk konfigurasi perlindungan overwrite. Node anak: Rule Node induk: None
Rule	Container	Ya	None	Aturan perlindungan overwrite. Satu bucket dapat memiliki maksimal 100 aturan. Node anak: ID, Action, Prefix, Suffix, Principals Node induk: OverwriteConfiguration
ID	String	Tidak	rule-001	Identifier unik dari aturan. Jika Anda tidak menentukan elemen ini, UUID akan dihasilkan secara acak. Jika Anda menentukan elemen ini, nilainya harus unik. Aturan yang berbeda tidak boleh memiliki ID yang sama. Node anak: None Node induk: Rule
Action	String	Ya	forbid	Tipe operasi. Saat ini, hanya `forbid` (melarang overwrite) yang didukung. Node anak: None Node induk: Rule
Prefix	String	Tidak	a/	Awalan nama objek untuk memfilter objek yang ingin diproses. Panjang maksimum adalah 1.023 karakter. Setiap aturan dapat memiliki paling banyak satu prefix. Prefix dan suffix tidak mendukung ekspresi reguler. Node anak: None Node induk: Rule
Suffix	String	Tidak	.txt	Akhiran nama objek untuk memfilter objek yang ingin diproses. Panjang maksimum adalah 1.023 karakter. Setiap aturan dapat memiliki paling banyak satu suffix. Prefix dan suffix tidak mendukung ekspresi reguler. Node anak: None Node induk: Rule
Principals	Container	Tidak	None	Kumpulan entitas yang diizinkan. Penggunaannya mirip dengan elemen `Principal` dalam kebijakan bucket. Anda dapat menentukan akun Alibaba Cloud, pengguna RAM, atau peran RAM. Jika elemen ini kosong atau tidak dikonfigurasi, overwrite dilarang untuk semua objek yang sesuai dengan kondisi prefix dan suffix. Node anak: Principal Node induk: Rule
Principal	String	Tidak	27737962156157xxxx	Entitas yang diizinkan. Anda dapat menentukan akun Alibaba Cloud, pengguna RAM, atau peran RAM. Jika elemen ini kosong, pengaturan tersebut tidak valid. Node anak: None Node induk: Principals

Elemen respons

Operasi ini tidak mengembalikan elemen respons apa pun.

Header respons

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

Contoh

Contoh permintaan

PUT /?overwriteConfig HTTP/1.1
Host: bucket-name.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
<?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>
  </Rule>
  <Rule>
    <ID>rule-003</ID>
    <Action>forbid</Action>
    <Suffix>.jpg</Suffix>
  </Rule>
  <Rule>
    <ID>rule-004</ID>
    <Action>forbid</Action>
    <Principals>
      <Principal>27737962156157xxxx</Principal>
    </Principals>
  </Rule>
</OverwriteConfiguration>

Contoh respons

HTTP/1.1 200 OK
x-oss-request-id: 5C4E5B5C5E5F5A5B5C5D5XXX
Date: Mon, 25 Nov 2025 15:00:59 GMT