Query the storage capacity of a bucket (Java SDK V2)

Updated at:

Query the storage capacity and object count of a bucket by calling the GetBucketStat operation with OSS Java SDK V2.

Prerequisites

  • OSS Java SDK V2 is installed. If you use Maven, add the com.aliyun:alibabacloud-oss-v2 dependency to the pom.xml file.

  • Access credentials are configured by using environment variables. The sample code in this topic uses EnvironmentVariableCredentialsProvider to read credentials from the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables.

Permissions

Alibaba Cloud accounts have full permissions by default. RAM users and RAM roles under an Alibaba Cloud account have no permissions by default. The Alibaba Cloud account or an account administrator must grant the required permissions.

API

Action

Description

GetBucketStat

oss:GetBucketStat

Queries the storage capacity and object count of a bucket.

Sample code

import com.aliyun.sdk.service.oss2.OSSClient;
import com.aliyun.sdk.service.oss2.OSSClientBuilder;
import com.aliyun.sdk.service.oss2.credentials.CredentialsProvider;
import com.aliyun.sdk.service.oss2.credentials.EnvironmentVariableCredentialsProvider;
import com.aliyun.sdk.service.oss2.models.*;

public class GetBucketStatSample {
    public static void main(String[] args) throws Exception {
        String region = "cn-hangzhou";
        String bucket = "examplebucket";

        CredentialsProvider provider = new EnvironmentVariableCredentialsProvider();
        OSSClientBuilder clientBuilder = OSSClient.newBuilder()
                .credentialsProvider(provider)
                .region(region);

        try (OSSClient client = clientBuilder.build()) {

            GetBucketStatResult result = client.getBucketStat(GetBucketStatRequest.newBuilder()
                            .bucket(bucket)
                    .build());

            System.out.printf("status code:%d, request id:%s%n",
                    result.statusCode(), result.requestId());
            System.out.printf("storage:%d, object count:%d, multipart upload count:%d%n",
                    result.bucketStat().storage(),
                    result.bucketStat().objectCount(),
                    result.bucketStat().multipartUploadCount());

        } catch (Exception e) {
            System.out.printf("error:%n%s", e);
        }
    }
}

References