Esta página foi traduzida pela API Cloud Translation.
Switch to English

DELETE Bucket

Exclui um bloco vazio.

O método DELETE Bucket é uma solicitação DELETE simples com escopo no bloco. Você precisa ser membro do grupo de proprietários do projeto para excluir buckets. Além disso, todas as solicitações DELETE Bucket precisam ser autenticadas.

Como prática recomendada, depois de excluir todos os objetos de um bucket, defina as ACLs do bucket para que nenhum usuário possa criar objetos nele.

Se houver objetos no bucket quando você tentar excluí-lo, você receberá umConflito de 409 e o corpo da resposta de erro conteráBucketNotEmpty no Code.

Se o bucket não existir, você receberá um código de status 404 Not Found e o corpo da resposta de erro conterá NoSuchBucket no 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 é 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-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 / 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 bucket chamado travel-maps.

Solicitação

DELETE / 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
Expires: Mon, 15 Feb  2010 11:00:01 GMT