向量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。