View bucket list

Updated at：2025-11-03

Basic workflow

Instantiate the BOSClient class.
Calling the BOSClient.listBuckets() method will return an instance of the ListBucketsResponse class.
For an instance of the ListBucketsResponse class, you can perform actions like getBuckets(), getOwner(), and getMetadata().

Example code

The following code can list all buckets of a user:

                Java
                
            

                List<BucketSummary> buckets = client.listBuckets().getBuckets();
 // Traverse bucket
for (BucketSummary bucket : buckets) {
   System.out.println(bucket.getName());
  }
            

The following code can list the bucket's owner:

                Java
                
                User usr = client.listBuckets().getOwner();
System.out.println(usr.getDisplayName());
System.out.println(usr.getId());

The following code can list the mucket's metadata:

                Java
                
            

                BosResponseMetadata metaData = client.listBuckets().getMetadata();
System.out.println(metaData.getBceRequestId());
System.out.println(metaData.getBceContentSha256());
System.out.println(metaData.getContentLength());
System.out.println(metaData.getEtag());
System.out.println(metaData.getExpires());
System.out.println(metaData.getContentMd5());
System.out.println(metaData.getContentDisposition());
System.out.println(metaData.getLastModified());
            

Note: If these parameters are not set for the bucket, the returned value may be null.

Complete example

                Java
                
            

                import java.util.List;
import android.app.Activity;
import android.os.Bundle;
import com.baidubce.BceClientException;
import com.baidubce.BceServiceException;
import com.baidubce.auth.DefaultBceCredentials;
import com.baidubce.development.R;
import com.baidubce.model.User;
import com.baidubce.services.bos.BosClient;
import com.baidubce.services.bos.BosClientConfiguration;
import com.baidubce.services.bos.model.BosResponseMetadata;
import com.baidubce.services.bos.model.BucketSummary;
import com.baidubce.services.bos.model.CreateBucketResponse;
import com.baidubce.services.bos.model.ListBucketsResponse;
​    
public class ExampleActivity extends Activity {
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    new Thread(new Runnable() {
        @Override
        public void run() {
            try {
                BosClientConfiguration config = new BosClientConfiguration();
                config.setCredentials(new DefaultBceCredentials(<AccessKeyID>, <SecretAccessKey>));
                config.setEndpoint(<EndPoint>);    
                BosClient client = new BosClient(config);
                ListBucketsResponse bucketsResponse = client.listBuckets() ;
 // Retrieve the bucket list
                List<BucketSummary> buckets = bucketsResponse.getBuckets();
                for (BucketSummary bucket : buckets) {
                    System.out.println(bucket.getName());
                }
 // Retrieve the bucket's owner
                User user = bucketsResponse.getOwner();
                System.out.println(user.getDisplayName());
                System.out.println(user.getId());
            } catch (BceServiceException e) {
                System.out.println("Error ErrorCode: " + e.getErrorCode());
                System.out.println("Error RequestId: " + e.getRequestId());
                System.out.println("Error StatusCode: " + e.getStatusCode());
                System.out.println("Error Message: " + e.getMessage());
                System.out.println("Error ErrorType: " + e.getErrorType());
            } catch (BceClientException e) {
                System.out.println("Error Message: " + e.getMessage());
            }
        }
    }).start();
}
}
            

Bucket permission control

Check if bucket exists

BOS

BOS

View bucket list

Basic workflow

Example code

Complete example