All Products
Document Center

Object Storage Service:Query bucket information by using OSS SDK for Android

Last Updated:Feb 20, 2024

A bucket is a container used to store objects in Object Storage Service (OSS). This topic describes how to query information about a bucket.

Usage notes

  • Before you run the sample code in this topic, you must create an OSSClient instance by using methods such as using a custom domain name or Security Token Service (STS). For more information, see Initialization.


The following sample code provides an example on how to query information about a bucket:

GetBucketInfoRequest request = new GetBucketInfoRequest("bucketName");

// Query information about the bucket. 
OSSAsyncTask task = oss.asyncGetBucketInfo(request, new OSSCompletedCallback<GetBucketInfoRequest, GetBucketInfoResult>() {
    public void onSuccess(GetBucketInfoRequest request, GetBucketInfoResult result) {
        Log.i("i", "code: " + result.getStatusCode());

    public void onFailure(GetBucketInfoRequest request, ClientException clientException, ServiceException serviceException) {
        // Handle request exceptions. 
        if (clientException != null) {
            // Handle client exceptions, such as network exceptions. 
        if (serviceException != null) {
            // Handle service exceptions. 
            Log.e("ErrorCode", serviceException.getErrorCode());
            Log.e("RequestId", serviceException.getRequestId());
            Log.e("HostId", serviceException.getHostId());
            Log.e("RawMessage", serviceException.getRawMessage());


  • For the complete sample code that is used to query information about a bucket, visit GitHub.

  • For more information about the API operation that you can call to query information about a bucket, see GetBucketInfo.

  • For more information about how to initialize an OSSClient instance, see Initialization.