全部文档
当前文档
最近更新时间：2026-06-03 21:32:12
以下代码用于列举所有的存储空间：
public void listBuckets() {
// 初始化 Ks3Client，参见“初始化”文档
Ks3Client ks3Client = initKs3Client();
try {
// 获取所有 Bucket
List<Bucket> buckets = ks3Client.listBuckets();
for (Bucket bucket : buckets) {
System.out.println("Bucket Name: " + bucket.getName());
System.out.println("Creation Date: " + bucket.getCreationDate());
System.out.println("Owner ID: " + bucket.getOwner().getId());
System.out.println("Owner Name: " + bucket.getOwner().getDisplayName());
System.out.println("Region: " + bucket.getRegion());
System.out.println("Type: " + bucket.getTypeName());
System.out.println("Visit Type: " + bucket.getVisitType());
System.out.println("Data Redundancy Type: " + bucket.getDataRedundancyType());
if (bucket.getCreator() != null) {
System.out.println("Creator Access Key: " + bucket.getCreator().getAccessKeyId());
System.out.println("Creator KRN: " + bucket.getCreator().getKrn());
System.out.println("Creator IP Address: " + bucket.getCreator().getIpAddress());
}
}
} catch (Ks3ServiceException e) {
System.out.println("Ks3ServiceException occurred, which means the request was made to KS3, but KS3 returned an error response for some reason.");
System.out.println("Error Message: " + e.getErrorMessage());
System.out.println("Error Code: " + e.getErrorCode());
System.out.println("Request ID: " + e.getRequestId());
} catch (Ks3ClientException e) {
System.out.println("Ks3ClientException occurred, which means the client encountered an internal error while trying to communicate with KS3.");
System.out.println("Error Message: " + e.getMessage());
} finally {
// 不再使用时，关闭 Ks3Client
ks3Client.shutdown();
}
}以下代码用于列举符合条件的存储空间：
public void listBucketsWithFilter() {
// 初始化 Ks3Client，参见“初始化”文档
Ks3Client ks3Client = initKs3Client();
try {
ListBucketsRequest request = new ListBucketsRequest();
// 设置前缀
request.withPrefixes("test-", "temp-");
// 设置区域
request.withRegions(Region.BEIJING, Region.SHANGHAI);
// 设置项目 ID
request.withProjectIds(Arrays.asList(0L, 1234L, 4321L));
// 设置桶类型
request.withBucketTypes(BucketType.Normal, BucketType.IA);
// 设置访问类型
request.withVisitTypes(BucketVisitType.NORMAL);
// 设置数据冗余类型
request.withDataRedundancyTypes(DataRedundancyType.ZRS);
List<Bucket> buckets = ks3Client.listBuckets(request);
for (Bucket bucket : buckets) {
System.out.println("Bucket Name: " + bucket.getName());
System.out.println("Creation Date: " + bucket.getCreationDate());
System.out.println("Owner ID: " + bucket.getOwner().getId());
System.out.println("Owner Name: " + bucket.getOwner().getDisplayName());
System.out.println("Region: " + bucket.getRegion());
System.out.println("Type: " + bucket.getTypeName());
System.out.println("Visit Type: " + bucket.getVisitType());
System.out.println("Data Redundancy Type: " + bucket.getDataRedundancyType());
}
} catch (Ks3ServiceException e) {
System.out.println("Ks3ServiceException occurred, which means the request was made to KS3, but KS3 returned an error response for some reason.");
System.out.println("Error Message: " + e.getErrorMessage());
System.out.println("Error Code: " + e.getErrorCode());
System.out.println("Request ID: " + e.getRequestId());
} catch (Ks3ClientException e) {
System.out.println("Ks3ClientException occurred, which means the client encountered an internal error while trying to communicate with KS3.");
System.out.println("Error Message: " + e.getMessage());
} finally {
// 不再使用时，关闭 Ks3Client
ks3Client.shutdown();
}
}SDK早期版本没有提供按项目ID列举存储空间的参数，如果用户有此需求，可以使用以下方法列举存储空间。
public void listBucketsWithProjectIds() {
// 初始化 Ks3Client，参见“初始化”文档
Ks3Client ks3Client = initKs3Client();
try {
ListBucketsRequest request = new ListBucketsRequest();
// 设置项目 ID 参数，多个项目 ID 以英文逗号分隔
request.getRequestConfig().getExtendQueryParams().put("projectIds", "0,1234");
List<Bucket> buckets = ks3Client.listBuckets(request);
for (Bucket bucket : buckets) {
System.out.println("Bucket Name: " + bucket.getName());
System.out.println("Creation Date: " + bucket.getCreationDate());
System.out.println("Owner ID: " + bucket.getOwner().getId());
System.out.println("Owner Name: " + bucket.getOwner().getDisplayName());
System.out.println("Region: " + bucket.getRegion());
System.out.println("Type: " + bucket.getTypeName());
System.out.println("Visit Type: " + bucket.getVisitType());
System.out.println("Data Redundancy Type: " + bucket.getDataRedundancyType());
if (bucket.getCreator() != null) {
System.out.println("Creator Access Key: " + bucket.getCreator().getAccessKeyId());
System.out.println("Creator KRN: " + bucket.getCreator().getKrn());
System.out.println("Creator IP Address: " + bucket.getCreator().getIpAddress());
}
}
} catch (Ks3ServiceException e) {
System.out.println("Ks3ServiceException occurred, which means the request was made to KS3, but KS3 returned an error response for some reason.");
System.out.println("Error Message: " + e.getErrorMessage());
System.out.println("Error Code: " + e.getErrorCode());
System.out.println("Request ID: " + e.getRequestId());
} catch (Ks3ClientException e) {
System.out.println("Ks3ClientException occurred, which means the client encountered an internal error while trying to communicate with KS3.");
System.out.println("Error Message: " + e.getMessage());
} finally {
// 不再使用时，关闭 Ks3Client
ks3Client.shutdown();
}
}纯净模式