Object Storage Service:DeleteBucket

Permissões

Por padrão, uma conta Alibaba Cloud tem permissões completas. Usuários RAM ou funções RAM vinculados a essa conta não têm permissão inicialmente. A conta Alibaba Cloud ou o administrador da conta deve conceder as permissões de operação por meio de políticas do RAM ou Bucket Policy.

Sintaxe da solicitação

DELETE / HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Cabeçalhos da solicitação

Todos os cabeçalhos em uma solicitação DeleteBucket são cabeçalhos comuns de solicitação. Para mais informações, consulte Cabeçalhos comuns de solicitação.

Cabeçalhos da resposta

Todos os cabeçalhos na resposta de uma solicitação DeleteBucket são cabeçalhos comuns de resposta. Para mais informações, consulte Cabeçalhos comuns de resposta.

Exemplos

• Exemplo de solicitação para excluir um bucket vazio

  DELETE / HTTP/1.1
  Host: test.oss-cn-hangzhou.aliyuncs.com
  Accept-Encoding: identity
  User-Agent: aliyun-sdk-python/2.6.0(Windows/7/AMD64;3.7.0)
  Accept: */*
  Connection: keep-alive
  date: Tue, 15 Jan 2019 08:19:04 GMT
  authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  Content-Length: 0

  Exemplo de resposta

  HTTP/1.1 204 No Content
  Server: AliyunOSS
  Date: Tue, 15 Jan 2019 08:19:04 GMT
  Content-Length: 0
  Connection: keep-alive
  x-oss-request-id: 5C3D9778CC1C2AEDF85B****
  x-oss-server-time: 190

• Exemplo de solicitação para excluir um bucket inexistente

  DELETE / HTTP/1.1
  Host: test.oss-cn-hangzhou.aliyuncs.com
  Accept-Encoding: identity
  User-Agent: aliyun-sdk-python/2.6.0(Windows/7/AMD64;3.7.0)
  Accept: */*
  Connection: keep-alive
  date: Tue, 15 Jan 2019 07:53:24 GMT
  authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  Content-Length: 0

  Exemplo de resposta

  HTTP/1.1 404 Not Found
  Server: AliyunOSS
  Date: Tue, 15 Jan 2019 07:53:25 GMT
  Content-Type: application/xml
  Content-Length: 288
  Connection: keep-alive
  x-oss-request-id: 5C3D9175B6FC201293AD****
  
  <?xml version="1.0" encoding="UTF-8"?>
  <Error>
    <Code>NoSuchBucket</Code>
    <Message>The specified bucket does not exist.</Message>
    <RequestId>5C3D9175B6FC201293AD****</RequestId>
    <HostId>test.oss-cn-hangzhou.aliyuncs.com</HostId>
    <BucketName>test</BucketName>
    <EC>0015-00000101</EC>
  </Error>

• Exemplo de solicitação para excluir um bucket não vazio

  DELETE / HTTP/1.1
  Host: test.oss-cn-hangzhou.aliyuncs.com
  Accept-Encoding: identity
  User-Agent: aliyun-sdk-python/2.6.0(Windows/7/AMD64;3.7.0)
  Accept: */*
  Connection: keep-alive
  date: Thu, 17 Apr 2025 07:35:06 GMT
  authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  Content-Length: 0

  Exemplo de resposta

  HTTP/1.1 409 Conflict
  Server: AliyunOSS
  Date: Tue, 15 Jan 2019 07:35:06 GMT
  Content-Type: application/xml
  Content-Length: 296
  Connection: keep-alive
  x-oss-request-id: 5C3D8D2A0ACA54D87B43****
  x-oss-server-time: 16
  
  <?xml version="1.0" encoding="UTF-8"?>
  <Error>
    <Code>BucketNotEmpty</Code>
    <Message>The bucket has objects. Please delete them first.</Message>
    <RequestId>5C3D8D2A0ACA54D87B43****</RequestId>
    <HostId>test.oss-cn-hangzhou.aliyuncs.com</HostId>
    <BucketName>test</BucketName>
    <EC>0015-00000301</EC>
  </Error>

SDKs

Use os seguintes SDKs do OSS para chamar a operação DeleteBucket:

• Java

• Python V2

• PHP V2

• Go V2

• C

• C++

• .NET

• Android

• iOS

• Node.js

• Ruby

ossutil

Para obter informações sobre o comando do ossutil correspondente à operação DeleteBucket, consulte delete-bucket.

Códigos de erro