Tous les produits
Search
Centre de documentation

Object Storage Service:Répertorier les buckets vectoriels (Go SDK V2)

Dernière mise à jour :Aug 18, 2026

Le Go SDK V2 vous permet d'appeler l'opération ListVectorBuckets. Cette opération répertorie tous les buckets vectoriels de votre compte Alibaba Cloud et prend en charge la pagination.

Autorisations

Par défaut, un compte Alibaba Cloud dispose de toutes les autorisations sur ses ressources. Les utilisateurs RAM et les rôles RAM ne disposent d'aucune autorisation par défaut. Pour permettre à un utilisateur RAM ou à un rôle RAM d'appeler cette opération, un compte Alibaba Cloud ou un administrateur RAM doit accorder les autorisations requises via une politique RAM ou une politique de bucket.

API

Action

Description

ListVectorBuckets

oss:ListVectorBuckets

Répertorie les buckets vectoriels.

Définition de la méthode

func (c *VectorsClient) NewListVectorBucketsPaginator(params *ListVectorBucketsRequest, optFns ...func(*Options)) *ListVectorBucketsPaginator

Paramètres de requête

Nom du paramètre

Type

Description

params

*ListVectorBucketsRequest

Spécifie les paramètres de la requête. Pour plus d'informations, consultez ListVectorBucketsRequest.

optFns

...func(*Options)

Facultatif. Paramètres de configuration au niveau de l'interface.

Pour plus d'informations, consultez Options.

Valeurs de retour

Nom du paramètre

Type

Description

result

*ListVectorBucketsPaginator

Paginateur utilisé pour parcourir la liste des buckets vectoriels. Pour plus d'informations, consultez ListVectorBucketsPaginator.

Exemple

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
	accountId string
)

func init() {
	flag.StringVar(&region, "region", "", "The region in which the vector bucket is located.")
	flag.StringVar(&accountId, "account-id", "", "The ID of the vector account.")
}

func main() {
	flag.Parse()
	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).
		// To access the service over the public network, set this to false or remove this line.
		WithUseInternalEndpoint(true)

	client := vectors.NewVectorsClient(cfg)

	request := &vectors.ListVectorBucketsRequest{}

	p := client.NewListVectorBucketsPaginator(request)

	var i int
	log.Println("Vector Buckets:")
	for p.HasNext() {
		i++

		page, err := p.NextPage(context.TODO())
		if err != nil {
			log.Fatalf("failed to get page %v, %v", i, err)
		}

		// Log the buckets found.
		for _, b := range page.Buckets {
			log.Printf("Bucket:%v, %v, %v\n", oss.ToString(b.Name), oss.ToString(b.ResourceGroupId), oss.ToString(b.Location))
		}
	}
}

Références

Pour consulter l'exemple de code complet, voir list_vector_buckets.go.