HEAD Bucket

Indica se um bucket existe e se o solicitante tem acesso READ a ele.

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

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
Date A data e a hora da solicitação. Não
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

Elementos do corpo da solicitação

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

Sintaxe da solicitação

HEAD / HTTP/1.1
Host: BUCKET_NAME.storage.googleapis.com
Date: DATE
Content-Length: 0
Authorization: AUTHENTICATION_STRING

Cabeçalhos de resposta

A solicitação retorna cabeçalhos de resposta padrão.

Elementos do corpo da resposta

A resposta não inclui um documento XML no corpo da resposta. As respostas de erro para solicitações HEAD também não contêm um corpo de resposta.

Exemplo

O exemplo a seguir mostra uma solicitação HEAD para um bucket chamado travel-maps.

Solicitação

HEAD / HTTP/1.1
Host: travel-maps.storage.googleapis.com
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg

Resposta

HTTP/1.1 200 OK
...