存储空间标签(Java SDK V2)

更新时间:
复制 MD 格式

通过 OSS Java SDK V2 调用 PutBucketTags、GetBucketTags 和 DeleteBucketTags 接口管理存储空间标签。

前提条件

  • 已安装 OSS Java SDK V2。使用 Maven 时,请在 pom.xml 中添加依赖 com.aliyun:alibabacloud-oss-v2。

  • 已通过环境变量配置访问凭证。本文示例使用 EnvironmentVariableCredentialsProvider 从环境变量 OSS_ACCESS_KEY_ID 和 OSS_ACCESS_KEY_SECRET 读取凭证。

权限说明

阿里云账号默认拥有全部权限。阿里云账号下的 RAM 用户或 RAM 角色默认没有任何权限,需要阿里云账号或账号管理员授予操作权限。

API

Action

说明

PutBucketTags

oss:PutBucketTagging

设置、查询或删除存储空间标签。

示例代码

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.*;
import java.util.ArrayList;
import java.util.List;

public class BucketTagsSample {
    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()) {
            // 设置存储空间标签
            List<Tag> tagList = new ArrayList<>();
            tagList.add(Tag.newBuilder().key("key1").value("value1").build());
            tagList.add(Tag.newBuilder().key("key2").value("value2").build());

            Tagging tagging = Tagging.newBuilder()
                    .tagSet(TagSet.newBuilder().tags(tagList).build())
                    .build();

            PutBucketTagsResult putResult = client.putBucketTags(PutBucketTagsRequest.newBuilder()
                    .bucket(bucket).tagging(tagging).build());

            System.out.printf("PutBucketTags status code:%d%n", putResult.statusCode());

            // 获取存储空间标签
            GetBucketTagsResult getResult = client.getBucketTags(
                    GetBucketTagsRequest.newBuilder().bucket(bucket).build());

            for (Tag tag : getResult.tagging().tagSet().tags()) {
                System.out.printf("tag: %s = %s%n", tag.key(), tag.value());
            }

            // 删除存储空间标签
            DeleteBucketTagsResult delResult = client.deleteBucketTags(
                    DeleteBucketTagsRequest.newBuilder().bucket(bucket).build());

            System.out.printf("DeleteBucketTags status code:%d%n", delResult.statusCode());

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

相关文档