GetObjectACL - Query object ACL | OSS API Reference - Object Storage Service

Sürüm Oluşturma

GetObjectACL varsayılan olarak mevcut nesne sürümünün ACL bilgisini döndürür. Belirli bir sürümü sorgulamak için versionId parametresini belirtin. Belirtilen sürüm bir silme işaretçisi ise OSS 404 Not Found hatası döndürür.

Not

Bir nesne için ACL ayarlanmamışsa GetObjectACL varsayılan ACL değerini döndürür; bu değer paket ACL'sinden miras alınır. Örneğin paket ACL'si private ise nesne ACL'si de private olur.

Söz Dizimi

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

İstek üst bilgileri

GetObjectACL isteğindeki tüm üst bilgiler ortak istek üst bilgileridir. Daha fazla bilgi için bkz. Ortak istek üst bilgileri.

Yanıt üst bilgileri

GetObjectACL isteğine verilen yanıt yalnızca ortak yanıt üst bilgilerini içerir. Daha fazla bilgi için bkz. Ortak yanıt üst bilgileri.

Yanıt öğeleri

Öğe	Tür	Örnek Değer	Açıklama
AccessControlList	Konteyner	Yok	ACL bilgilerini içeren konteyner. Üst düğümler: AccessControlPolicy
AccessControlPolicy	Konteyner	Yok	GetObjectACL sonuçlarını içeren konteyner. Üst düğümler: yok
DisplayName	Dize	0022012****	Paket sahibinin adı. Kullanıcı kimliği ile aynıdır. Üst düğümler: AccessControlPolicy.Owner
Grant	Sabit listeli dize	private	Nesnenin ACL değeri. Varsayılan değer: default. Geçerli değerler: default: Nesne ACL'si paket ACL'sinden miras alınır. private: Nesnenin ACL'si özeldir. public-read: Nesnenin ACL'si genel okumadır. public-read-write: Nesnenin ACL'si genel okuma/yazmadır. Üst düğümler: AccessControlPolicy.AccessControlList
ID	Dize	0022012****	Paket sahibinin kullanıcı kimliği. Üst düğümler: AccessControlPolicy.Owner
Owner	Konteyner	Yok	Paket sahibi bilgilerini içeren konteyner. Üst düğümler: AccessControlPolicy

Örnekler

Sürüm oluşturulmamış bir paketteki nesnenin ACL değerini sorgulama

Örnek istekler

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

Örnek yanıtlar

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>

Sürüm oluşturulmuş bir paketteki nesnenin ACL değerini sorgulama

Örnek istekler

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

Örnek yanıtlar

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 SDK'leri

Aşağıdaki diller için OSS SDK'lerini kullanarak GetObjectACL işlemini çağırın:

ossutil

GetObjectACL işlemine karşılık gelen ossutil komutu hakkında bilgi almak için bkz. get-object-acl.

Hata kodları

Hata kodu	HTTP durum kodu	Hata mesajı	Açıklama
AccessDenied	403	You do not have read acl permission on this object.	Bu işlemi gerçekleştirme yetkiniz yok. Yalnızca paket sahibi nesne ACL'lerini sorgulayabilir.
FileAlreadyExists	409	The object you specified already exists and is a directory.	Belirtilen nesne hiyerarşik ad alanı yapılandırılmış bir paketteki bir dizindir.