Object Storage Service:DeleteBucket

Request syntax

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

Request headers

All headers in a DescribeRegions request are common request headers. For more information, see Common request headers.

Response headers

All headers in the response to a DescribeRegions request are common response headers. For more information, see Common response headers.

Examples

• Sample request for deleting an empty bucket

  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: OSS qn6qrrqxo2oawuk53otfjbyc:ceOEyZavKY4QcjoUWYSpYbJ3****
  Content-Length: 0

  Sample response

  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

• Sample request for deleting a bucket that does not exist

  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: OSS qn6qrrqxo2oawuk53otfjbyc:ceOEyZavKY4QcjoUWYSpYbJ3****
  Content-Length: 0

  Sample response

  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>

• Sample request for deleting a non-empty bucket

  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:35:06 GMT
  authorization: OSS qn6qrrqxo2oawuk53otfjbyc:ceOEyZavKY4QcjoUWYSpYbJ3****
  Content-Length: 0

  Sample response

  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

You can use OSS SDKs for the following programming languages to call DeleteBucket:

• Java

• Python

• PHP

• Go

• C

• C++

• .NET

• Android

• iOS

• Node.js

• Ruby

ossutil

For information about the ossutil command that corresponds to the DeleteBucket operation, see delete-bucket.

Error codes