Listing directory buckets - Amazon Simple Storage Service
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Listing directory buckets

The following examples show how to list directory buckets by using the Amazon SDKs and Amazon CLI.

SDK for Java 2.x

The following example lists directory buckets by using the Amazon SDK for Java 2.x.

public static void listBuckets(S3Client s3Client) { try { ListDirectoryBucketsRequest listDirectoryBucketsRequest = ListDirectoryBucketsRequest.builder().build(); ListDirectoryBucketsResponse response = s3Client.listDirectoryBuckets(listDirectoryBucketsRequest); if (response.hasBuckets()) { for (Bucket bucket: response.buckets()) { System.out.println(bucket.name()); System.out.println(bucket.creationDate()); } } } catch (S3Exception e) { System.err.println(e.awsErrorDetails().errorMessage()); System.exit(1); } }
SDK for Python

The following example lists directory buckets by using the Amazon SDK for Python (Boto3).

import logging import boto3 from botocore.exceptions import ClientError def list_directory_buckets(s3_client): ''' Prints a list of all directory buckets in a Region :param s3_client: boto3 S3 client :return: True if there are buckets in the Region, else False ''' try: response = s3_client.list_directory_buckets() for bucket in response['Buckets']: print (bucket['Name']) except ClientError as e: logging.error(e) return False return True if __name__ == '__main__': region = 'us-east-1' s3_client = boto3.client('s3', region_name = region) list_directory_buckets(s3_client)
Amazon SDK for .NET

The following example lists directory buckets by using the Amazon SDK for .NET.

var listDirectoryBuckets = await amazonS3Client.ListDirectoryBucketsAsync(new ListDirectoryBucketsRequest { MaxDirectoryBuckets = 10 }).ConfigureAwait(false);
SDK for PHP

The following example lists directory buckets by using the Amazon SDK for PHP.

require 'vendor/autoload.php'; $s3Client = new S3Client([ 'region' => 'us-east-1', ]); $result = $s3Client->listDirectoryBuckets();
SDK for Ruby

The following example lists directory buckets by using the Amazon SDK for Ruby.

s3 = Aws::S3::Client.new(region:'us-west-1') s3.list_directory_buckets

The following list-directory-buckets example command shows how you can use the Amazon CLI to list your directory buckets in the us-east-1 region. To run this command, replace the user input placeholders with your own information.

aws s3api list-directory-buckets --region us-east-1

For more information, see list-directory-buckets in the Amazon CLI Command Reference.