本文介绍如何通过 TOS Java SDK 根据 ObjectSet 标签设置默认 QoS 与容量配额规则。

注意事项

rules 不能为空。

同一请求中不允许出现重复的 tag.key=tag.value。

请求体大小受服务端限制，默认上限为 20 KiB。

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

该规则会覆盖基于标签的配额规则，请谨慎在生产 Bucket 上调用。

代码示例

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.ObjectSetQos;​
import com.volcengine.tos.model.bucket.ObjectSetQuotaByTagRule;​
import com.volcengine.tos.model.bucket.PutObjectSetQuotaByTagInput;​
import com.volcengine.tos.model.bucket.PutObjectSetQuotaByTagOutput;​
import com.volcengine.tos.model.bucket.Tag;​
​
import java.util.Collections;​
​
public class PutObjectSetQuotaByTagExample {​
    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");​
​
        TOSV2 tos = new TOSV2ClientBuilder().build(region, endpoint, accessKey, secretKey);​
​
        try {​
            ObjectSetQos qos = ObjectSetQos.builder()​
                    .readsQps(0)​
                    .writesQps(0)​
                    .listQps(0)​
                    .readsRate(0)​
                    .writesRate(0)​
                    .build();​
            ObjectSetQuotaByTagRule rule = new ObjectSetQuotaByTagRule()​
                    .setTag(Tag.builder().key("owner").value("java-sdk-example").build())​
                    .setQos(qos)​
                    .setStorageQuota("0");​
            PutObjectSetQuotaByTagInput input = PutObjectSetQuotaByTagInput.builder()​
                    .bucket(bucket)​
                    .rules(Collections.singletonList(rule))​
                    .build();​
​
            PutObjectSetQuotaByTagOutput output = tos.putObjectSetQuotaByTag(input);​
            System.out.println("putObjectSetQuotaByTag succeed");​
            System.out.println("RequestID: " + output.getRequestInfo().getRequestId());​
        } catch (TosClientException e) {​
            System.out.println("putObjectSetQuotaByTag failed");​
            System.out.println("Message: " + e.getMessage());​
            if (e.getCause() != null) {​
                e.getCause().printStackTrace();​
            }​
        } catch (TosServerException e) {​
            System.out.println("putObjectSetQuotaByTag 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("putObjectSetQuotaByTag failed");​
            System.out.println("unexpected exception, message: " + t.getMessage());​
        }​
    }​
}​

对象存储