Tous les produits
Search
Centre de documentation

Object Storage Service:Créer un bucket vectoriel (SDK Go V2)

Dernière mise à jour :Sep 22, 2026

Un bucket vectoriel est un conteneur qui stocke les index vectoriels et les données vectorielles. Pour créer un bucket vectoriel, appelez l'opération PutVectorBucket à l'aide du SDK Go V2.

Autorisations

Par défaut, un compte Alibaba Cloud dispose de toutes les autorisations. Les utilisateurs RAM et les rôles RAM ne disposent d'aucune autorisation par défaut ; vous devez leur accorder l'accès via une politique RAM ou une politique de bucket.

API

Action

Description

PutVectorBucket

oss:PutVectorBucket

Crée un bucket vectoriel. Le nom d'un bucket vectoriel doit être unique pour un UID au sein d'une même région. Sa longueur doit être comprise entre 3 et 32 caractères. Il ne peut contenir que des lettres minuscules, des chiffres et des traits d'union (-). Le nom ne peut pas commencer ni se terminer par un trait d'union.

Définition de la méthode

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

Paramètres de requête

Paramètre

Type

Description

ctx

context.Context

Le contexte de la requête.

request

*PutVectorBucketRequest

Les paramètres de la requête. Pour plus d'informations, consultez PutVectorBucketRequest.

optFns

...func(*Options)

(Facultatif) Les paramètres de configuration au niveau de l'opération.

Pour plus d'informations, consultez Options.

Valeurs de retour

Valeur de retour

Type

Description

result

*PutVectorBucketResult

La valeur de retour de l'opération. Ce paramètre n'est valide que si err est nul. Pour plus d'informations, consultez PutVectorBucketResult.

err

error

L'état de la requête. Si la requête échoue, err n'est pas nul.

Exemple de code

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 account ID.")
}

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, accountId required")
	}

	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region).WithAccountId(accountId).
		// To use a public endpoint, set this parameter to false or remove this line.
		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("failed to put vector bucket %v", err)
	}
	log.Printf("put vector bucket result:%#v\n", result)
}

Références

Pour consulter l'exemple de code complet relatif à la création d'un bucket vectoriel, voir put_vector_bucket.go.