Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ Object Storage Service/ Referência de API/ As API/ Operações em objetos/ Obtenção da configuração ACL de um objeto
Atualizado em 2022-11-07 GMT+08:00
Ver PDF
Compartilhar

Obtenção da configuração ACL de um objeto

Funções

A implementação desta operação retorna a configuração ACL de um objeto. Você pode executar essa operação para exibir a ACL de um objeto, contanto que você tenha a permissão de leitura para a ACL do objeto.

Controle de versões

Por predefinição, esta operação obtém a ACL da versão mais recente de um objecto. Se o objeto tiver um marcador de exclusão, o código de status 404 será retornado. Para obter a ACL de uma versão especificada, o parâmetro versionId pode ser usado para especificar a versão desejada.

Sintaxe da solicitação

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

Parâmetros de solicitação

O parâmetro request especifica a ACL do objeto a ser obtida. Para obter detalhes sobre os parâmetros, consulte Tabela 1.

Tabela 1 Parâmetros de solicitação

Parâmetro

Descrição

Obrigatório

acl

Indica que a solicitação é para obter a ACL do objeto.

Tipo: string

Sim

versionId

Número da versão de um objeto.

Tipo: string

Não

Cabeçalhos de solicitação

Essa solicitação usa cabeçalhos comuns. Para mais detalhes, consulte Tabela 3.

Elementos de solicitação

Este pedido não envolve elementos.

Sintaxe da resposta

 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>

Cabeçalhos de resposta

A resposta à solicitação usa cabeçalhos comuns. Para mais detalhes, consulte Tabela 1.

Além da resposta comum cabeçalhos, a seguinte mensagem cabeçalhos também podem ser utilizados. Para mais detalhes, consulte Tabela 2.

Tabela 2 Cabeçalho de resposta adicional

Cabeçalho

Descrição

x-obs-version-id

Número da versão de um objeto.

Valor válido: string

Não há valor padrão.

Elementos de resposta

A mensagem de resposta da solicitação retorna as informações ACL do objeto. Tabela 3 descreve os elementos.

Tabela 3 Elementos de resposta

Elemento

Descrição

ID

ID da conta de usuário

Tipo: string

AccessControlList

Lista de usuários e suas permissões para o bucket.

Tipo: XML

Grant

Identifica o beneficiário e as permissões do beneficiário.

Tipo: XML

Grantee

Recipiente para os detalhes sobre o beneficiário.

Tipo: XML

Delivered

Indica se uma ACL de objeto herda a ACL de um bucket.

Tipo: boolean

Permission

Permissões de um usuário especificado para o bucket.

Tipo: string

Respostas de erro

Nenhuma resposta de erro especial é retornada. Para obter detalhes sobre respostas de erro, consulte Tabela 2.

Solicitação de exemplo

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=

Resposta de exemplo

 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>
Tópico principal: Operações em objetos