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 ...