Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ Object Storage Service/ Referencia de la API/ Las API/ Operaciones en objetos/ Obtención de la configuración de ACL de objetos
Actualización más reciente 2024-09-18 GMT+08:00
Ver PDF
Compartir

Obtención de la configuración de ACL de objetos

Funciones

La implementación de esta operación devuelve la configuración de ACL de un objeto. Puede realizar esta operación para ver la ACL de un objeto, siempre y cuando tenga el permiso de lectura para la ACL del objeto.

Control de versiones

De forma predeterminada, esta operación obtiene la ACL de la última versión de un objeto. Si el objeto tiene un marcador de borrado, se devuelve el código de estado 404. Para obtener la ACL de una versión especificada, el parámetro versionId se puede utilizar para especificar la versión deseada.

Sintaxis de solicitud

1
2
3
 
GET /ObjectName?acl HTTP/1.1 
Host: bucketname.obs.region.myhuaweicloud.com Date: date
Authorization: authorization

Parámetros de solicitud

El parámetro request especifica la ACL del objeto que se va a obtener. Para obtener más información acerca de los parámetros, consulte Tabla 1.

Tabla 1 Parámetros de solicitud

Parámetro

Descripción

Obligatorio

versionId

Número de versión de un objeto.

Tipo: string

No

Encabezados de solicitud

Esta solicitud utiliza encabezados comunes. Para obtener más información, véase Tabla 3.

Elementos de solicitud

Esta solicitud no implica ningún elemento.

Sintaxis de respuesta

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
 
HTTP/1.1 status_code
Date: date
Content-Length: length
Content-Type: application/xml 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
<AccessControlPolicy xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/">
    <Owner> 
        <ID>id</ID> 
    </Owner> 
    <Delivered>true</Delivered>
    <AccessControlList> 
        <Grant> 
            <Grantee> 
                <ID>id</ID> 
            </Grantee> 
            <Permission>permission</Permission> 
        </Grant> 
    </AccessControlList> 
</AccessControlPolicy>

Encabezados de respuesta

La respuesta a la solicitud utiliza encabezados comunes. Para más detalles, consulte Tabla 1.

Además de los encabezados de respuesta comunes, los encabezados de mensaje enumerados en Tabla 2 puede ser usado.

Tabla 2 Encabezado de respuesta adicional

Encabezado

Descripción

x-obs-version-id

Número de versión de un objeto.

Valor válido: string

Valor predeterminado: ninguno

Elementos de respuesta

El mensaje de respuesta de la solicitud devuelve la información de ACL del objeto. Tabla 3 describe los elementos.

Tabla 3 Elementos de respuesta

Elemento

Descripción

ID

ID de cuenta de usuario

Tipo: string

AccessControlList

Lista de usuarios y sus permisos para el bucket.

Tipo: XML

Grant

Identifica al concesionario y los permisos del concesionario.

Tipo: XML

Grantee

Contenedor para los detalles sobre el concesionario.

Tipo: XML

Entregado

Indica si una ACL de objeto hereda la ACL de un bucket.

Tipo: boolean

Permission

Permisos de un usuario especificado para el bucket.

Tipo: string

Respuestas de error

No se devuelven respuestas de error especiales. Para obtener más información sobre las respuestas de error, consulte Tabla 2.

Modelo de solicitud

1
2
3
4
5
6
 
GET /object011?acl HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 04:45:55 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:YcmvNQxItGjFeeC1K2HeUEp8MMM=

Modelo de respuesta

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
 
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 8DF400000163D3E650F3065C2295674C
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCS+wsHqRuA2Tx+mXUpNtBbWLPMle9CIx
Content-Type: application/xml
Date: WED, 01 Jul 2015 04:45:55 GMT
Content-Length: 769

<?xml version="1.0" encoding="utf-8"?>
<AccessControlPolicy xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/">
  <Owner> 
    <ID>b4bf1b36d9ca43d984fbcb9491b6fce9</ID> 
  </Owner>  
  <Delivered>false</Delivered> 
  <AccessControlList> 
    <Grant> 
      <Grantee> 
        <ID>b4bf1b36d9ca43d984fbcb9491b6fce9</ID> 
      </Grantee>  
      <Permission>FULL_CONTROL</Permission> 
    </Grant>  
    <Grant> 
      <Grantee> 
        <ID>783fc6652cf246c096ea836694f71855</ID> 
      </Grantee>  
      <Permission>READ</Permission>  
      </Grant>  
    <Grant> 
      <Grantee> 
        <Canned>Everyone</Canned> 
      </Grantee>  
      <Permission>READ_ACP</Permission> 
    </Grant> 
  </AccessControlList> 
</AccessControlPolicy>
Tema principal: Operaciones en objetos