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

Consulta la lista de control de acceso (ACL) de un objeto en un bucket.

Control de versiones

De forma predeterminada, GetObjectACL devuelve la ACL de la versión actual del objeto. Especifique el parámetro versionId para consultar una versión específica. Si la versión especificada es un marcador de eliminación, OSS devuelve 404 Not Found.

Nota

Si no se ha establecido una ACL para un objeto, GetObjectACL devuelve la ACL predeterminada, la cual se hereda de la ACL del bucket. Por ejemplo, si la ACL del bucket es privada, la ACL del objeto también será privada.

Sintaxis

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

Encabezados de solicitud

Todos los encabezados en una solicitud GetObjectACL son encabezados de solicitud comunes. Para obtener más información, consulte Common request headers.

Encabezados de respuesta

La respuesta a una solicitud GetObjectACL contiene únicamente encabezados de respuesta comunes. Para obtener más información, consulte Common response headers.

Elementos de respuesta

Elemento	Tipo	Valor de ejemplo	Descripción
AccessControlList	Contenedor	N/A	Contenedor para la información de la ACL. Nodos padre: AccessControlPolicy
AccessControlPolicy	Contenedor	N/A	Contenedor para los resultados de GetObjectACL. Nodos padre: ninguno
DisplayName	Cadena	0022012****	Nombre del propietario del bucket. Coincide con el ID de usuario. Nodos padre: AccessControlPolicy.Owner
Grant	Cadena enumerada	private	ACL del objeto. Valor predeterminado: default. Valores válidos: default: La ACL del objeto se hereda de la ACL del bucket. private: La ACL del objeto es privada. public-read: La ACL del objeto es de lectura pública. public-read-write: La ACL del objeto es de lectura y escritura públicas. Nodos padre: AccessControlPolicy.AccessControlList
ID	Cadena	0022012****	ID de usuario del propietario del bucket. Nodos padre: AccessControlPolicy.Owner
Owner	Contenedor	N/A	Contenedor para la información del propietario del bucket. Nodos padre: AccessControlPolicy

Ejemplos

Consulta de la ACL de un objeto en un bucket sin control de versiones

Solicitudes de ejemplo

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

Respuestas de ejemplo

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>

Consulta de la ACL de un objeto en un bucket con control de versiones

Solicitudes de ejemplo

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

Respuestas de ejemplo

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>

SDK de OSS

Llame a GetObjectACL con los SDK de OSS para los siguientes lenguajes:

ossutil

Para obtener información sobre el comando de ossutil correspondiente a la operación GetObjectACL, consulte get-object-acl.

Códigos de error

Código de error	Código de estado HTTP	Mensaje de error	Descripción
AccessDenied	403	You do not have read acl permission on this object.	No tiene autorización para realizar esta operación. Solo el propietario del bucket puede consultar las ACL de los objetos.
FileAlreadyExists	409	The object you specified already exists and is a directory.	El objeto especificado es un directorio en un bucket con namespace jerárquico.