Get bucket information (Java SDK V2)

Updated at:

Query bucket details by calling the GetBucketInfo operation with OSS Java SDK V2.

Prerequisites

  • OSS Java SDK V2 is installed. If you use Maven, add the dependency com.aliyun:alibabacloud-oss-v2 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

An Alibaba Cloud account has full permissions by default. RAM users and RAM roles under the account have no permissions by default. The Alibaba Cloud account or an account administrator must grant the required operation permissions to the RAM user or RAM role.

API

Action

Description

GetBucketInfo

oss:GetBucketInfo

Queries bucket information.

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 GetBucketInfoSample {
    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()) {

            GetBucketInfoResult result = client.getBucketInfo(GetBucketInfoRequest.newBuilder()
                            .bucket(bucket)
                    .build());

            System.out.printf("status code:%d, request id:%s%n",
                    result.statusCode(), result.requestId());

            BucketInfo bucketInfo = result.bucketInfo();
            System.out.printf("Bucket name: %s%n", bucketInfo.name());
            System.out.printf("Creation date: %s%n", bucketInfo.creationDate());
            System.out.printf("Location: %s%n", bucketInfo.location());
            System.out.printf("Storage class: %s%n", bucketInfo.storageClass());

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

References