PutBucketAcl - Object Storage Service

Operasi ini digunakan untuk mengonfigurasi atau memodifikasi ACL sebuah bucket.

Catatan penggunaan

Saat memanggil operasi PutBucketAcl, perhatikan hal-hal berikut:

Anda harus memiliki izin tulis pada bucket untuk memanggil operasi ini.
Operasi PutBucketAcl menggunakan semantik penimpaan. ACL baru akan menimpa yang sudah ada.
Jika bucket yang ingin Anda atur ACL-nya tidak tersedia saat memanggil operasi ini, bucket baru akan dibuat.

Izin

Secara default, akun Alibaba Cloud memiliki izin penuh. Pengguna RAM atau Peran RAM di bawah akun Alibaba Cloud tidak memiliki izin apa pun secara default. Akun Alibaba Cloud atau administrator akun harus memberikan izin operasi melalui Kebijakan RAM atau Kebijakan Bucket.

API	Aksi	Definisi
PutBucketAcl	oss:PutBucketAcl	Mengonfigurasi atau memodifikasi ACL sebuah bucket.

Struktur permintaan

PUT /? acl HTTP/1.1
x-oss-acl: Permission
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Header permintaan

Header

Tipe

Diperlukan

Nilai contoh

Deskripsi

x-oss-acl

String

private

ACL yang ingin Anda atur untuk bucket.

Header ini disertakan dalam permintaan PutBucketAcl untuk mengatur ACL bucket. Jika header ini tidak disertakan, pengaturan ACL tidak akan berlaku.

Nilai valid: public-read-write, public-read, dan private

public-read-write: Semua pengguna, termasuk pengguna anonim dapat membaca dan menulis objek di bucket. Berhati-hatilah saat mengatur ACL bucket ke public-read-write.
public-read: Hanya pemilik atau pengguna yang berwenang dari bucket ini yang dapat menulis objek di bucket. Pengguna lain, termasuk pengguna anonim hanya dapat membaca objek di bucket. Berhati-hatilah saat mengatur ACL bucket ke public-read.
private: Hanya pemilik atau pengguna yang berwenang dari bucket ini yang dapat membaca dan menulis objek di bucket. Pengguna lain, termasuk pengguna anonim tidak dapat mengakses objek di bucket tanpa otorisasi.

Untuk header permintaan umum yang disertakan dalam permintaan PutBucketAcl, lihat Header Permintaan Umum.

Header respons

Respons terhadap permintaan PutBucketAcl hanya berisi header respons umum. Untuk informasi lebih lanjut, lihat Header Respons Umum.

Contoh

Contoh Permintaan

PUT /? acl HTTP/1.1
x-oss-acl: public-read
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 03:21:12 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Contoh Respons

Contoh Respons Sukses

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 24 Feb 2012 03:21:12 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS

Contoh Respons terhadap Permintaan dengan Pengaturan ACL Tidak Valid

HTTP/1.1 400 Bad Request
x-oss-request-id: 56594298207FB3044385****
Date: Fri, 24 Feb 2012 03:55:00 GMT
Content-Length: 309
Content-Type: text/xml; charset=UTF-8
Connection: keep-alive
Server: AliyunOSS

<? xml version="1.0" encoding="UTF-8"? >
<Error>
  <Code>InvalidArgument</Code>
  <Message>no such bucket access control exists</Message>
  <RequestId>5***9</RequestId>
  <HostId>***-test.example.com</HostId>
  <ArgumentName>x-oss-acl</ArgumentName>
  <ArgumentValue>error-acl</ArgumentValue>
</Error>

OSS SDK

Anda dapat menggunakan OSS SDK untuk bahasa pemrograman berikut untuk memanggil operasi PutBucketAcl:

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi PutBucketAcl, lihat put-bucket-acl.

Kode kesalahan

Kode kesalahan	Status HTTP	Deskripsi
AccessDenied	403	Pesan kesalahan dikembalikan karena informasi otentikasi pengguna tidak disertakan dalam permintaan PutBucketAcl. Pesan kesalahan dikembalikan karena Anda tidak berwenang untuk memulai permintaan PutBucketAcl.