GetBucketAcl - Object Storage Service

Operasi ini digunakan untuk menanyakan daftar kontrol akses (ACL) dari sebuah bucket.

Catatan

Izin oss:GetBucketAcl diperlukan untuk menanyakan ACL dari sebuah bucket. Untuk informasi lebih lanjut, lihat Lampirkan kebijakan kustom ke pengguna RAM.

Sintaks permintaan

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

Header permintaan

Semua header dalam permintaan DescribeRegions adalah header permintaan umum. Untuk informasi lebih lanjut, lihat Header Permintaan Umum.

Elemen respons

Elemen	Tipe	Deskripsi
AccessControlList	Container	Wadah yang berisi informasi ACL. Node induk: AccessControlPolicy.
AccessControlPolicy	Container	Wadah yang berisi hasil dari permintaan GetBucketACL. Node induk: tidak ada.
DisplayName	String	Nama pemilik bucket, yang saat ini sama dengan ID pengguna. Node induk: AccessControlPolicy dan Owner.
Grant	Enumerasi	ACL untuk bucket. Nilai valid: private, public-read, dan public-read-write. Node induk: AccessControlPolicy dan AccessControlList.
ID	String	ID pengguna pemilik bucket. Node induk: AccessControlPolicy dan Owner.
Owner	Container	Wadah yang berisi informasi tentang pemilik bucket. Node induk: AccessControlPolicy.

Contoh

Contoh Permintaan

GET /? acl HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 04:11:23 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Contoh Respons Sukses

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 24 Feb 2012 04:11:23 GMT 
Content-Length: 253
Content-Type: application/xml
Connection: keep-alive
Server: AliyunOSS

<? xml version="1.0" ? >
<AccessControlPolicy>
    <Owner>
        <ID>0022012****</ID>
        <DisplayName>user_example</DisplayName>
    </Owner>
    <AccessControlList>
        <Grant>public-read</Grant>
    </AccessControlList>
</AccessControlPolicy>

SDK OSS

SDK untuk operasi GetBucketAcl dalam berbagai bahasa pemrograman adalah sebagai berikut:

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi GetBucketAcl, lihat get-bucket-acl.

Kode kesalahan

Kode kesalahan	Kode status HTTP	Deskripsi
NoSuchBucket	404	Pesan kesalahan dikembalikan karena bucket yang ditentukan tidak ada.
AccessDenied	403	Pesan kesalahan dikembalikan karena Anda tidak memiliki izin untuk menanyakan ACL bucket. Hanya pemilik bucket yang dapat menanyakan ACL bucket.