You need to enable JavaScript to run this app.
文档中心
对象存储

对象存储

请输入
  • 文档首页
    • 对象存储TOS VectorsSDK 参考Java-Vectors向量桶CreateVectorBucket（TOS Vectors Java SDK）
复制全文
下载 pdf
我的收藏
向量桶
CreateVectorBucket（TOS Vectors Java SDK）
复制全文
下载 pdf
我的收藏
CreateVectorBucket（TOS Vectors Java SDK）
CreateVectorBucket 接口用于创建向量桶，本文介绍如何通过 TOS Vectors Java SDK 的 CreateVectorBucket 接口创建向量桶。​
注意事项​
  • 为了防止密钥泄露，本文示例代码需要从环境变量中读取 Access Key ID 和 Secret Access Key。因此使用 SDK 前，您需要配置长期访问凭证，详细介绍，请参见 配置长期访问凭证。​
  • TOS Vectors Java SDK 支持使用临时访问凭证；也支持配置超时机制、重试策略等多种机制，您可以根据业务需求灵活设置，提升应用安全性，详细介绍，请参见 常见配置场景。​
  • 不允许匿名请求创建桶，并且一个用户在全局内最多可创建 100 个向量桶（包含普通桶）。​
权限说明​
主账号默认拥有全部权限，但是 IAM 用户默认没有任何权限。如果您需要使用 IAM 用户执行 CreateVectorBucket 操作，主账号需通过 IAM策略和桶策略为该 IAM 用户授予以下权限：tosvectors:CreateVectorBucket​
代码示例​
创建向量存储桶​
​
// 创建向量存储桶​
import com.volcengine.tos.TOSVectorsClientBuilder;​
import com.volcengine.tos.TOSVectors;​
import com.volcengine.tos.TosClientException;​
import com.volcengine.tos.TosServerException;​
import com.volcengine.tos.model.vectors.CreateVectorBucketInput;​
import com.volcengine.tos.model.vectors.CreateVectorBucketOutput;​
​
public class CreateVectorBucketExample {​
public static void main(String[] args) {​
String endpoint = 'Provide your endpoint';​
String region = 'Provide your region';​
String accessKey = System.getenv("TOS_ACCESS_KEY");​
String secretKey = System.getenv("TOS_SECRET_KEY");​
​
// 填写向量桶名称​
String vectorBucketName = 'Provide your bucket name';​
​
// 初始化客户端​
TOSVectors client = new TOSVectorsClientBuilder().build(region, endpoint, accessKey, secretKey);​
​
try {​
// 创建向量存储桶​
// 向量桶名称必须满足以下要求：​
// 1. 长度在3-32个字符之间​
// 2. 只能包含小写字母、数字和连字符(-)​
// 3. 不能以连字符(-)开头或结尾​
CreateVectorBucketInput input = CreateVectorBucketInput.builder()​
.vectorBucketName(vectorBucketName)​
.build();​
​
CreateVectorBucketOutput output = client.createVectorBucket(input);​
​
// 打印请求结果​
System.out.println("向量桶创建成功");​
System.out.println("RequestID: " + output.getRequestInfo().getRequestId());​
System.out.println("StatusCode: " + output.getRequestInfo().getStatusCode());​
​
} catch (TosClientException e) {​
// 操作失败，捕获客户端异常，一般情况是请求参数错误，此时请求并未发送​
System.out.println("操作失败");​
System.out.println("Message: " + e.getMessage());​
if (e.getCause() != null) {​
e.getCause().printStackTrace();​
}​
} catch (TosServerException e) {​
// 操作失败，捕获服务端异常，可以获取到从服务端返回的详细错误信息​
System.out.println("操作失败");​
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("操作失败");​
System.out.println("unexpected exception, message: " + t.getMessage());​
}​
}​
}​
​
​
最近更新时间：2026.07.31 10:37:26
这个页面对您有帮助吗？
有用
有用
无用
无用