GetObjectACL - Object Storage Service

Mengambil daftar kontrol akses (ACL) dari sebuah objek dalam bucket.

Versioning

Secara default, ketika Anda memanggil operasi GetObjectACL untuk mengambil ACL dari sebuah objek, hanya ACL versi terkini objek yang dikembalikan. Anda dapat menentukan parameter versionId dalam permintaan untuk mengambil ACL dari versi tertentu objek. Jika versi yang ditentukan adalah penanda hapus, Object Storage Service (OSS) akan mengembalikan respons 404 Not Found.

Catatan

Jika Anda memanggil operasi GetObjectACL untuk mengambil ACL dari sebuah objek yang tidak memiliki konfigurasi ACL, OSS akan mengembalikan ACL default objek tersebut. Dalam hal ini, ACL objek ini sama dengan ACL bucket tempat objek disimpan. Sebagai contoh, jika ACL bucket tempat objek disimpan adalah private, maka ACL objek juga private.

Syntax

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

Request headers

Semua header dalam permintaan GetObjectACL merupakan header permintaan umum. Untuk informasi lebih lanjut, lihat Header permintaan umum.

Response headers

Tanggapan terhadap permintaan GetObjectACL hanya mencakup header tanggapan umum. Untuk informasi lebih lanjut, lihat Header tanggapan umum.

Elemen tanggapan

Elemen	Tipe	Nilai Contoh	Deskripsi
AccessControlList	Kontainer	N/A	Kontainer yang menyimpan informasi ACL. Node induk: AccessControlPolicy
AccessControlPolicy	Kontainer	N/A	Kontainer yang menyimpan hasil dari permintaan GetObjectACL. Node induk: none
DisplayName	String	0022012****	Nama pemilik bucket, yang sama dengan ID pengguna. Node induk: AccessControlPolicy.Owner
Grant	Enumerated string	private	ACL dari objek. Nilai default: default. Nilai valid: default: ACL dari objek sama dengan ACL dari bucket tempat objek disimpan. private: ACL dari objek adalah private. public-read: ACL dari objek adalah baca publik. public-read-write: ACL dari objek adalah baca/tulis publik. Node induk: AccessControlPolicy.AccessControlList
ID	String	0022012****	ID pengguna pemilik bucket. Node induk: AccessControlPolicy.Owner
Owner	Kontainer	N/A	Kontainer yang menyimpan informasi tentang pemilik bucket. Node induk: AccessControlPolicy

Contoh

Permintaan ACL dari objek dalam bucket tanpa versi

Contoh permintaan

GET /test-object?acl HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 29 Apr 2015 05:21:12 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Contoh tanggapan

HTTP/1.1 200 OK
x-oss-request-id: 559CC9BDC755F95A64485981
Date: Wed, 29 Apr 2015 05:21:12 GMT
Content-Length: 253
Content-Type: application/xml
Connection: keep-alive
Server: AliyunOSS
<?xml version="1.0" ?>
<AccessControlPolicy>
    <Owner>
        <ID>0022012****</ID>
        <DisplayName>0022012****</DisplayName>
    </Owner>
    <AccessControlList>
        <Grant>public-read </Grant>
    </AccessControlList>
</AccessControlPolicy>

Permintaan ACL dari objek dalam bucket dengan versi

Contoh permintaan

GET /example?acl&versionId=CAEQMhiBgMC1qpSD0BYiIGQ0ZmI5ZDEyYWVkNTQwMjBiNTliY2NjNmY3ZTVk**** HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Tue, 09 Apr 2019 06:30:10 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Contoh tanggapan

HTTP/1.1 200 OK
x-oss-version-id: CAEQMhiBgMC1qpSD0BYiIGQ0ZmI5ZDEyYWVkNTQwMjBiNTliY2NjNmY3ZTVk****
x-oss-request-id: 5CAC3BF2B7AEADE017000621
Date: Tue, 09 Apr 2019 06:30:10 GMT
Content-Length: 261
Content-Type: application/xml
Connection: keep-alive
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<AccessControlPolicy>
  <Owner>
    <ID>1234513715092****</ID>
    <DisplayName>1234513715092****</DisplayName>
  </Owner>
  <AccessControlList>
    <Grant>public-read</Grant>
  </AccessControlList>
</AccessControlPolicy>

OSS SDKs

Anda dapat menggunakan OSS SDK berikut untuk memanggil operasi GetObjectACL:

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi GetObjectACL, lihat get-object-acl.

Kode kesalahan

Kode kesalahan	Status HTTP	Pesan kesalahan	Deskripsi
AccessDenied	403	You do not have read acl permission on this object.	Pesan kesalahan dikembalikan karena Anda tidak memiliki izin untuk melakukan operasi GetObjectACL. Hanya pemilik bucket yang memiliki izin untuk memanggil operasi GetObjectACL untuk meminta ACL dari objek dalam bucket.
FileAlreadyExists	409	The object you specified already exists and is a directory.	Pesan kesalahan dikembalikan karena objek yang ACL-nya ingin Anda minta adalah direktori dalam bucket yang fitur namespace hierarkisnya diaktifkan.