Deletes an S3 bucket.
            
 Declaration Syntax
 Declaration Syntax| C# | 
DeleteBucketResponse DeleteBucket( DeleteBucketRequest request )
 Parameters
 Parameters- request (DeleteBucketRequest)
- The DeleteBucketRequest that defines the parameters of the operation.
 Return Value
 Return ValueReturns a DeleteBucketResponse from S3.
 Remarks
 Remarks
            All objects in the bucket must be deleted before the bucket itself can be deleted.
            Only the owner of a bucket can delete it, regardless of the bucket's access control policy.
            
 Examples
 ExamplesThis example shows how to delete an bucket.
 CopyDeleteBucket sample
CopyDeleteBucket sample// Create a client AmazonS3Client client = new AmazonS3Client(); // Construct request DeleteBucketRequest request = new DeleteBucketRequest { BucketName = "SampleBucket" }; // Issue call DeleteBucketResponse response = client.DeleteBucket(request);
This example shows how to delete all items in a bucket, and then delete the actual bucket.
 CopyDeleteBucket sample
CopyDeleteBucket sample// Create a client AmazonS3Client client = new AmazonS3Client(); // List and delete all objects ListObjectsRequest listRequest = new ListObjectsRequest { BucketName = "SampleBucket" }; ListObjectsResponse listResponse; do { // Get a list of objects listResponse = client.ListObjects(listRequest); foreach (S3Object obj in listResponse.S3Objects) { // Delete each object client.DeleteObject(new DeleteObjectRequest { BucketName = obj.BucketName, Key = obj.Key }); } // Set the marker property listRequest.Marker = listResponse.NextMarker; } while (listResponse.IsTruncated); // Construct DeleteBucket request DeleteBucketRequest request = new DeleteBucketRequest { BucketName = "SampleBucket" }; // Issue call DeleteBucketResponse response = client.DeleteBucket(request);
 Exceptions
 Exceptions| Exception | Condition | 
|---|---|
| ArgumentNullException | |
| WebException | |
| AmazonS3Exception |