GET Object

Faz o download de um objeto, lista as ACLs de um objeto ou recebe as informações de criptografia dele.

Para fazer o download de um objeto, faça uma solicitação GET com escopo para um bucket e objeto. Também é possível usar vários cabeçalhos de solicitação para ampliar o escopo da solicitação. A solicitação retorna o conteúdo do objeto no corpo da resposta. Para listar as ACLs de um objeto, faça uma solicitação GET com escopo para um bucket e objeto e use o parâmetro de string de consulta acl. As ACLs são retornadas em um documento XML no corpo da resposta.

Se você fizer uma solicitação GET para um objeto que não existe, receberá um código de status 404 Not Found e o corpo da resposta de erro conterá NoSuchKey no elemento Code.

Use uma solicitação GET de objeto para:

Não use uma solicitação de objeto GET para recuperar metadados gerais de objetos, porque isso gera cobranças de saída associadas ao download de todo o objeto. Use uma solicitação de objeto HEAD.

Cabeçalhos de solicitação comuns

Veja a seguir os cabeçalhos de solicitação comum para solicitações de objeto GET.

Header Descrição Obrigatório
Authorization A string de autenticação para a solicitação. Obrigatório para objetos sem acesso público de leitura. Talvez
Host O URI do Cloud Storage. Para mais informações, consulte Endpoints de solicitação. Sim
x-goog-user-project O projeto a ser cobrado por cobranças associadas à solicitação. Não