All Products
Search
Document Center

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

Last Updated:Jun 04, 2026

Bucket vektor adalah wadah yang 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. Pengguna Resource Access Management (RAM) atau peran RAM tidak memiliki izin secara default. Pemilik akun Alibaba Cloud atau administrator harus memberikan izin melalui kebijakan RAM atau kebijakan bucket.

API

Action

Deskripsi

PutVectorBucket

oss:PutVectorBucket

Membuat bucket vektor. Nama bucket vektor harus unik untuk satu UID dalam wilayah yang sama. Nama harus terdiri dari 3 hingga 32 karakter. Nama hanya boleh berisi huruf kecil, angka, dan tanda hubung (-). Nama tidak boleh diawali 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 selengkapnya, lihat PutVectorBucketRequest.

optFns

...func(*Options)

(Opsional) Parameter konfigurasi tingkat operasi.

Untuk informasi selengkapnya, lihat Options.

Nilai kembali

Nilai kembali

Tipe

Deskripsi

result

*PutVectorBucketResult

Nilai kembali dari operasi. Parameter ini hanya valid jika err bernilai nil. Untuk informasi selengkapnya, 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.")
}

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

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

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

	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region).WithAccountId(accountId).
		// Untuk menggunakan titik akhir publik, atur parameter ini ke false atau hapus baris ini.
		WithUseInternalEndpoint(true)

	client := vectors.NewVectorsClient(cfg)

	request := &vectors.PutVectorBucketRequest{
		Bucket: oss.Ptr(bucketName),
	}
	result, err := client.PutVectorBucket(context.TODO(), request)
	if err != nil {
		log.Fatalf("gagal membuat bucket vektor %v", err)
	}
	log.Printf("hasil pembuatan bucket vektor:%#v\n", result)
}

Referensi

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