ListBucketsResponse Class | AWS SDK for .NET Version 4

This is the response object from the ListBuckets operation.

Inheritance Hierarchy

System.Object
Amazon.Runtime.AmazonWebServiceResponse
Amazon.S3.Model.ListBucketsResponse

Namespace: Amazon.S3.Model
Assembly: AWSSDK.S3.dll
Version: 3.x.y.z

Syntax

public class ListBucketsResponse : AmazonWebServiceResponse

The ListBucketsResponse type exposes the following members

Constructors

	Name	Description
	ListBucketsResponse()

Properties

Name	Type	Description
Buckets	System.Collections.Generic.List<Amazon.S3.Model.S3Bucket>	Gets and sets the property Buckets. The list of buckets owned by the requester. Starting with version 4 of the SDK this property will default to null. If no data for this property is returned from the service the property will also be null. This was changed to improve performance and allow the SDK and caller to distinguish between a property not set or a property being empty to clear out a value. To retain the previous SDK behavior set the AWSConfigs.InitializeCollections static property to true.
ContentLength	System.Int64	Inherited from Amazon.Runtime.AmazonWebServiceResponse.
ContinuationToken	System.String	Gets and sets the property ContinuationToken. `ContinuationToken` is included in the response when there are more buckets that can be listed with pagination. The next `ListBuckets` request to Amazon S3 can be continued with this `ContinuationToken`. `ContinuationToken` is obfuscated and is not a real bucket.
HttpStatusCode	System.Net.HttpStatusCode	Inherited from Amazon.Runtime.AmazonWebServiceResponse.
Owner	Amazon.S3.Model.Owner	Gets and sets the property Owner. The owner of the buckets listed.
Prefix	System.String	Gets and sets the property Prefix. If `Prefix` was sent with the request, it is included in the response. All bucket names in the response begin with the specified bucket name prefix.
ResponseMetadata	Amazon.Runtime.ResponseMetadata	Inherited from Amazon.Runtime.AmazonWebServiceResponse.

Examples

This example shows how to list all buckets.

ListBuckets sample


// Create a client
AmazonS3Client client = new AmazonS3Client();

// Issue call
ListBucketsResponse response = await client.ListBucketsAsync();

// 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);
}

Version Information

.NET:
Supported in: 8.0 and newer, Core 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.7.2 and newer