Todos os produtos
Search
Central de documentação

Object Storage Service:Listar vector buckets (Go SDK V2)

Última atualização: Jul 03, 2026

Use o Go SDK V2 para chamar a operação ListVectorBuckets. Essa operação lista todos os vector buckets da sua conta Alibaba Cloud e oferece suporte a consultas paginadas.

Permissões

Por padrão, uma conta Alibaba Cloud tem permissões totais sobre seus recursos. Usuários RAM e funções RAM não possuem permissões por padrão. Para permitir que um usuário ou função RAM chame esta operação, conceda as permissões necessárias por meio de uma política RAM ou de uma política de bucket. Essa concessão deve ser feita pela conta Alibaba Cloud ou por um administrador RAM.

API

Ação

Descrição

ListVectorBuckets

oss:ListVectorBuckets

Lista os vector buckets.

Definição do método

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

Parâmetros da solicitação

Nome do parâmetro

Tipo

Descrição

params

*ListVectorBucketsRequest

Especifica os parâmetros da solicitação. Para mais informações, consulte ListVectorBucketsRequest.

optFns

...func(*Options)

Opcional. Parâmetros de configuração no nível da interface.

Para mais detalhes, veja Options.

Valores de retorno

Nome do parâmetro

Tipo

Descrição

result

*ListVectorBucketsPaginator

Paginador usado para percorrer a lista de vector buckets. Consulte também ListVectorBucketsPaginator.

Exemplo

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))
		}
	}
}

Referências

Para obter o código de exemplo completo, consulte list_vector_buckets.go.