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.
This operation is not supported for directory buckets.
Returns a list of all buckets owned by the authenticated sender of the request. To
grant IAM permission to use this operation, you must add the s3:ListAllMyBuckets
policy action.
For information about Amazon S3 buckets, see Creating, configuring, and working with Amazon S3 buckets.
We strongly recommend using only paginated ListBuckets requests. Unpaginated
ListBuckets requests are only supported for Amazon Web Services accounts set
to the default general purpose bucket quota of 10,000. If you have an approved general
purpose bucket quota above 10,000, you must send paginated ListBuckets requests
to list your account’s buckets. All unpaginated ListBuckets requests will be
rejected for Amazon Web Services accounts with a general purpose bucket quota greater
than 10,000.
You must URL encode any signed header values that contain spaces. For example, if
your header value is my file.txt, containing two spaces after my, you
must URL encode this value to my%20%20file.txt.
For .NET Core this operation is only available in asynchronous form. Please refer to ListBucketsAsync.
Namespace: Amazon.S3
Assembly: AWSSDK.S3.dll
Version: 3.x.y.z
public virtual ListBucketsResponse ListBuckets()
This example shows how to list all buckets.
// Create a client
AmazonS3Client client = new AmazonS3Client();
// Issue call
ListBucketsResponse response = client.ListBuckets();
// View response data
Console.WriteLine("Buckets owner - {0}", response.Owner.DisplayName);
foreach (S3Bucket bucket in response.Buckets)
{
Console.WriteLine("Bucket {0}, Created on {1}", bucket.BucketName, bucket.CreationDate);
}
.NET Framework:
Supported in: 4.5 and newer, 3.5