创建向量Bucket(Go SDK V2)

向量Bucket是向量数据的容器,用于存储向量索引和向量数据,使用Go SDK V2调用PutVectorBucket接口创建向量Bucket。

权限说明

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

API

Action

说明

PutVectorBucket

oss: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(&region, "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