Deletes an S3 bucket.
Declaration Syntax| C# |
public DeleteBucketResponse DeleteBucket( DeleteBucketRequest request )
Parameters- request (DeleteBucketRequest)
- The DeleteBucketRequest that defines the parameters of the operation.
Return ValueReturns a DeleteBucketResponse from S3.
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.
ExamplesThis example shows how to delete an bucket.
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// 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| Exception | Condition |
|---|---|
| ArgumentNullException | |
| WebException | |
| AmazonS3Exception |