GET Service

Lista todos os buckets em um projeto especificado, ordenados na lista lexicograficamente pelo nome.

O método GET Service é uma solicitação GET simples sem um escopo de bucket ou objeto. A solicitação retorna a lista de buckets em um documento XML no corpo da resposta. A solicitação precisa ser autenticada (solicitações anônimas falharão). Por padrão, somente o grupo de proprietários de projetos pode listar os buckets porque eles são os proprietários de todos os buckets dentro do projeto. Os grupos de editores de projetos e de projetos só têm acesso de visualização ou gravação aos buckets, respectivamente.

Se a solicitação GET Service falhar, ela retornará um código de status 403 Forbidden. O corpo da resposta de erro também conterá uma mensagem descrevendo o motivo da falha da solicitação.

A API XML não retorna listas com mais de 1.000 buckets.

Parâmetros de string de consulta

Normalmente, essa solicitação não inclui parâmetros de string de consulta.

Consulte parâmetros de string de consulta de URL assinado para informações sobre os parâmetros incluídos ao criar e usar URLs assinados.

Cabeçalhos de solicitação

Header Descrição Obrigatório
Authorization A string de autenticação para a solicitação. Sim
Content-Length

O tamanho do corpo da solicitação sem cabeçalhos (em bytes).

* Não é obrigatório para solicitações que usam codificação de transferência fragmentada.

Sim*
Date A data e a hora da solicitação. Sim
Host O URI do Cloud Storage. Para mais informações, consulte Endpoints de solicitação. Sim
x-goog-project-id O ID de um projeto. Sim
x-goog-user-project O projeto a ser cobrado por cobranças associadas à solicitação. Não

Elementos do corpo da solicitação

Esta solicitação não inclui um documento XML no corpo da solicitação.

Sintaxe da solicitação

GET / HTTP/1.1
Host: storage.googleapis.com
Date: DATE
Authorization: AUTHENTICATION_STRING
Content-Length: 0
x-goog-project-id: PROJECT_ID

Cabeçalhos de resposta

A solicitação pode retornar diversos cabeçalhos de resposta, dependendo dos cabeçalhos de solicitação usados.

Elementos do corpo da resposta

Element Descrição
ListAllMyBucketsResult Recipiente para informações sobre o bloco.
Buckets Recipiente para informações sobre os blocos do proprietário.
Bucket Recipiente para informações sobre um bloco específico.
Name Nome do bloco.
CreationDate Data de criação do bloco.

Exemplo

O exemplo a seguir lista os blocos do projeto especificado.

Solicitação

GET / HTTP/1.1
Host: storage.googleapis.com
Date: Mon, 15 Feb  2010 11:00:00 GMT
Content-Length: 0
x-goog-project-id: 123456789123
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg

Resposta

HTTP/1.1 200 OK
Content-Length: 648
Content-Type: application/xml
Date: Mon, 15 Feb  2010 11:00:01 GMT

<?xml version='1.0' encoding='utf-8'?>
<ListAllMyBucketsResult xmlns='http://doc.s3.amazonaws.com/2006-03-01'>
  <Buckets>
    <Bucket>
      <Name>city-maps</Name>
      <CreationDate>2009-12-16T18:36:25.369Z</CreationDate>
    </Bucket>
    <Bucket>
      <Name>state-maps</Name>
      <CreationDate>2009-12-16T18:42:37.408Z</CreationDate>
    </Bucket>
    <Bucket>
      <Name>country-maps</Name>
      <CreationDate>2010-01-22T01:27:03.633Z</CreationDate>
    </Bucket>
  </Buckets>
</ListAllMyBucketsResult>