全部产品
Search
文档中心

Object Storage Service:Membuat bucket vektor (Go SDK V2)

更新时间:Nov 09, 2025

Bucket vektor adalah wadah yang digunakan untuk menyimpan indeks vektor dan data vektor. Untuk membuat bucket vektor, Anda dapat memanggil operasi PutVectorBucket menggunakan Go SDK V2.

Izin

Secara default, Akun Alibaba Cloud memiliki semua izin yang diperlukan. Namun, pengguna Resource Access Management (RAM) dan peran RAM tidak memiliki izin secara default. Administrator Akun Alibaba Cloud harus memberikan izin untuk operasi ini melalui Kebijakan RAM atau kebijakan bucket.

API

Aksi

Deskripsi

PutVectorBucket

oss:PutVectorBucket

Membuat bucket vektor. Nama bucket vektor harus unik untuk UID dalam wilayah yang sama. Nama tersebut harus terdiri dari 3 hingga 32 karakter. Hanya boleh berisi huruf kecil, angka, dan tanda hubung (-). Tidak boleh dimulai atau diakhiri dengan tanda hubung.

Definisi metode

func (c *VectorsClient) PutVectorBucket(ctx context.Context, request *PutVectorBucketRequest, optFns ...func(*Options)) (*PutVectorBucketResult, error)

Parameter permintaan

Parameter

Tipe

Deskripsi

ctx

context.Context

Konteks permintaan.

request

*PutVectorBucketRequest

Parameter permintaan. Untuk informasi lebih lanjut, lihat PutVectorBucketRequest.

optFns

...func(*Options)

(Opsional) Parameter konfigurasi tingkat operasi.

Untuk informasi lebih lanjut, lihat Options.

Nilai kembali

Nilai kembali

Tipe

Deskripsi

result

*PutVectorBucketResult

Nilai kembali dari operasi. Parameter ini hanya valid jika err bernilai nil. Untuk informasi lebih lanjut, lihat PutVectorBucketResult.

err

error

Status permintaan. Jika permintaan gagal, err tidak bernilai nil.

Kode contoh

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", "", "Wilayah tempat bucket vektor berada.")
	flag.StringVar(&bucketName, "bucket", "", "Nama bucket vektor.")
	flag.StringVar(&accountId, "account-id", "", "ID akun vektor.")
}

func main() {
	flag.Parse()
	if len(bucketName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("parameter tidak valid, nama bucket diperlukan")
	}

	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("parameter tidak valid, wilayah diperlukan")
	}

	if len(accountId) == 0 {
		flag.PrintDefaults()
		log.Fatalf("parameter tidak valid, accountId diperlukan")
	}

	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("gagal menempatkan bucket vektor %v", err)
	}
	log.Printf("hasil bucket vektor:%#v\n", result)
}

Referensi

Untuk kode contoh lengkap dalam pembuatan bucket vektor, lihat put_vector_bucket.go.