DELETE Object

Exclui um objeto.

Se você fizer uma solicitação DELETE 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.

Parâmetros de string de consulta

Parâmetro Descrição Obrigatório
generation Você poderá usar isso se quiser excluir uma geração de objeto específica. Se esse parâmetro de consulta for usado em um bucket com versão, e a geração especificada for a versão ativa do objeto, a versão não se tornará uma versão não atual do objeto, mas será excluída completamente. Não

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-if-generation-match Se a geração especificada for igual à do objeto atual, o objeto será excluído. Não
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

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

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

A resposta não inclui um documento XML no corpo da resposta.

Exemplo

O exemplo a seguir exclui um objeto chamado paris.jpg.

Solicitação

DELETE /paris.jpg HTTP/1.1
Host: travel-maps.storage.googleapis.com
Date: Mon, 15 Feb  2010 11:00:00 GMT
Content-Length: 0
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg

Resposta

HTTP/1.1 204 No Content
Date: Mon, 15 Feb  2010 11:00:01 GMT