向量Bucket是向量数据的容器,用于存储向量索引和向量数据,使用Go SDK V2调用PutVectorBucket接口创建向量Bucket。
权限说明
阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限,需要阿里云账号或账号管理员通过RAM Policy或Bucket Policy授予操作权限。
API | Action | 说明 |
PutVectorBucket |
| 创建向量Bucket。单一 UID 在同地域内的 Vector Bucket 命名具有唯一性,长度 3~32 个字符。只允许小写字母、数字、短横线(-),且不能以短横线开头或结尾。 |
方法定义
func (c *VectorsClient) PutVectorBucket(ctx context.Context, request *PutVectorBucketRequest, optFns ...func(*Options)) (*PutVectorBucketResult, error)请求参数列表
参数名 | 类型 | 说明 |
ctx | context.Context | 请求上下文。 |
request | *PutVectorBucketRequest | 设置请求参数,具体请参见PutVectorBucketRequest |
optFns | ...func(*Options) | (可选)接口级的配置参数, 请参见Options |
返回值列表
返回值名 | 类型 | 说明 |
result | *PutVectorBucketResult | 接口返回值,当 err 为nil 时有效,具体请参见PutVectorBucketResult |
err | error | 请求的状态,当请求失败时,err 不为 nil |
示例代码
package main
import (
"context"
"flag"
"log"
"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/vectors"
)
var (
region string
bucketName string
accountId string
)
func init() {
flag.StringVar(®ion, "region", "", "The region in which the vector bucket is located.")
flag.StringVar(&bucketName, "bucket", "", "The name of the vector bucket.")
flag.StringVar(&accountId, "account-id", "", "The id of vector account.")
}
func main() {
flag.Parse()
if len(bucketName) == 0 {
flag.PrintDefaults()
log.Fatalf("invalid parameters, bucket name required")
}
if len(region) == 0 {
flag.PrintDefaults()
log.Fatalf("invalid parameters, region required")
}
if len(accountId) == 0 {
flag.PrintDefaults()
log.Fatalf("invalid parameters, accounId required")
}
cfg := oss.LoadDefaultConfig().
WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
WithRegion(region).WithAccountId(accountId)
client := vectors.NewVectorsClient(cfg)
request := &vectors.PutVectorBucketRequest{
Bucket: oss.Ptr(bucketName),
}
result, err := client.PutVectorBucket(context.TODO(), request)
if err != nil {
log.Fatalf("failed to put vector bucket %v", err)
}
log.Printf("put vector bucket result:%#v\n", result)
}相关文档
关于创建向量Bucket的完整示例代码,请参见put_vector_bucket.go。
该文章对您有帮助吗?