全部產品
Search
文件中心

Object Storage Service:建立向量Bucket(Go SDK V2)

更新時間:Sep 25, 2025

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