How to get a list of buckets stored in S3 using Java – AWS S3 List Buckets

3 weeks ago Lalit Bhagtani 0

In this tutorial, we will learn about how to get a list of buckets stored in S3 using java language.

Project Setup

Create a simple maven project in your favorite IDE and add below mentioned dependency in your pom.xml file.


For latest version of aws library, check this page.

S3 Connection

Create an object of AmazonS3 ( ) class for sending a client request to S3. To get instance of this class, we will use AmazonS3ClientBuilder builder class. It requires three important parameters :- 

  1. Region :- It is a region where S3 table will be stored.
  2. ACCESS_KEY :- It is a access key for using S3. You can generate this key, using aws management console.
  3. SECRET_KEY :- It is a secret key of above mentioned access key.

Here is a code example :-

AmazonS3 s3 = AmazonS3ClientBuilder.standard()
				.withCredentials(new AWSStaticCredentialsProvider
                                                    (new BasicAWSCredentials("ACCESS_KEY","SECRET_KEY")))

List Buckets

An AmazonS3.listBuckets method returns a list of all S3 buckets that the authenticated sender of the request owns. Users can only list buckets that it had created.


import java.util.List;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.auth.AWSStaticCredentialsProvider;
import com.amazonaws.auth.BasicAWSCredentials;
import com.amazonaws.regions.Regions;

public class ListBuckets {

	public static void main(String[] args) {
		/* Create S3 Client Object */
		AmazonS3 s3 = AmazonS3ClientBuilder
				.withCredentials(new AWSStaticCredentialsProvider(
                                     new BasicAWSCredentials("ACCESS_KEY","SECRET_KEY")))
		try {			
			/* Send List Bucket Request */
			List&lt;Bucket&gt; buckets = s3.listBuckets();
			/* Printing Bucket Names */
			if (buckets != null) { -&gt; System.out.println(e.getName()));
			} else {
				System.out.println("No bucket available");
        } catch (AmazonServiceException e) {
        } finally {
        	if(s3 != null) {

References :-

  1. ListBucketsRequest Java Docs
  2. Bucket Java Docs

That’s all for how to get a list of buckets stored in S3 using java language. If you liked it, please share your thoughts in comments section and share it with others too.