Object Storage Service:DeleteBucket

Request syntax

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

Request headers

This request contains only common request headers. For more information, see Common HTTP headers.

Response headers

This request contains only common response headers. For more information, see Common HTTP 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

Error codes