本文介绍如何通过 TOS Java SDK 列举 Bucket 下的 ObjectSet，支持按前缀、标签和 marker 分页过滤。

注意事项

Bucket 必须已开启 ObjectSet。

通过子账号调用时，需要具备当前 Bucket 的 tos:ListObjectSet 权限。

maxKeys 默认值和最大值均由服务端控制，最大值为 1000。

当返回结果被截断时，可使用 nextMarker 继续列举。

代码示例

import com.volcengine.tos.TOSV2;​
import com.volcengine.tos.TOSV2ClientBuilder;​
import com.volcengine.tos.TosClientException;​
import com.volcengine.tos.TosServerException;​
import com.volcengine.tos.model.bucket.ListObjectSetsInput;​
import com.volcengine.tos.model.bucket.ListObjectSetsOutput;​
import com.volcengine.tos.model.bucket.ObjectSetInfo;​
​
public class ListObjectSetsExample {​
    public static void main(String[] args) {​
        String endpoint = System.getenv("TOS_ENDPOINT");​
        String region = System.getenv("TOS_REGION");​
        String accessKey = System.getenv("TOS_ACCESS_KEY");​
        String secretKey = System.getenv("TOS_SECRET_KEY");​
        String bucket = System.getenv("TOS_BUCKET");​
        String prefix = System.getenv("TOS_OBJECT_SET_PREFIX");​
​
        TOSV2 tos = new TOSV2ClientBuilder().build(region, endpoint, accessKey, secretKey);​
​
        try {​
            String marker = null;​
            do {​
                ListObjectSetsInput input = ListObjectSetsInput.builder()​
                        .bucket(bucket)​
                        .prefix(prefix)​
                        .maxKeys(100)​
                        .marker(marker)​
                        .build();​
                ListObjectSetsOutput output = tos.listObjectSets(input);​
                System.out.println("listObjectSets succeed");​
                if (output.getObjectSets() != null) {​
                    for (ObjectSetInfo objectSet : output.getObjectSets()) {​
                        System.out.println("ObjectSetName: " + objectSet.getObjectSetName());​
                    }​
                }​
                marker = output.getNextMarker();​
                if (!Boolean.TRUE.equals(output.getIsTruncated())) {​
                    break;​
                }​
            } while (marker != null && marker.length() > 0);​
        } catch (TosClientException e) {​
            System.out.println("listObjectSets failed");​
            System.out.println("Message: " + e.getMessage());​
            if (e.getCause() != null) {​
                e.getCause().printStackTrace();​
            }​
        } catch (TosServerException e) {​
            System.out.println("listObjectSets failed");​
            System.out.println("StatusCode: " + e.getStatusCode());​
            System.out.println("Code: " + e.getCode());​
            System.out.println("Message: " + e.getMessage());​
            System.out.println("RequestID: " + e.getRequestID());​
        } catch (Throwable t) {​
            System.out.println("listObjectSets failed");​
            System.out.println("unexpected exception, message: " + t.getMessage());​
        }​
    }​
}​

对象存储