AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Container for the parameters to the DeleteBucket operation.
Deletes the bucket. All objects (including all object versions and Delete Markers) in the bucket must be deleted before the bucket itself can be deleted.
Namespace: Amazon.S3.Model
Assembly: AWSSDK.S3.dll
Version: 3.x.y.z
public class DeleteBucketRequest : AmazonWebServiceRequest IAmazonWebServiceRequest
The DeleteBucketRequest type exposes the following members
Name | Description | |
---|---|---|
![]() |
DeleteBucketRequest() |
Name | Type | Description | |
---|---|---|---|
![]() |
BucketName | System.String |
The name of the bucket to be created. |
![]() |
BucketRegion | Amazon.S3.S3Region |
The region locality for the bucket. |
![]() |
ExpectedBucketOwner | System.String |
The account id of the expected bucket owner. If the bucket is owned by a different account, the request will fail with an HTTP 403 (Access Denied) error. |
![]() |
UseClientRegion | System.Boolean |
If set to true the bucket will be deleted in the same region as the configuration of the AmazonS3 client. DeleteBucketRequest.BucketRegion takes precedence over this property if both are set. Default: true. |
This example shows how to delete an bucket.
// 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.
// 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 = "SampleBucket", 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);
.NET Core App:
Supported in: 3.1
.NET Standard:
Supported in: 2.0, 1.3
.NET Framework:
Supported in: 4.5, 4.0, 3.5