Todos os produtos
Search
Central de documentação

Object Storage Service:Listar índices vetoriais (Go SDK V2)

Última atualização: Jul 03, 2026

Use o Go SDK V2 para chamar a operação ListVectorIndexes e listar todos os índices vetoriais em um bucket vetorial específico.

Permissões

A conta Alibaba Cloud tem permissões completas para acessar todas as operações de API. Por padrão, usuários RAM e funções RAM não podem chamar esta operação. Crie e anexe uma política do RAM ou uma política de bucket para conceder as permissões necessárias.

API

Action

Descrição

ListVectorIndexes

oss:ListVectorIndexes

Lista índices vetoriais.

Definição do método

func (c *VectorsClient) ListVectorIndexes(ctx context.Context, request *ListVectorIndexesRequest, optFns ...func(*oss.Options)) (*ListVectorIndexesResult, error) 

Parâmetros da solicitação

Parâmetro

Tipo

Descrição

params

*ListVectorIndexesRequest

Parâmetros da solicitação, como o nome do bucket. Para mais informações, consulte ListVectorIndexesRequest.

optFns

...func(*Options)

(Opcional) Parâmetros de configuração no nível da API.

Para mais informações, consulte Options.

Valores de retorno

Parâmetro

Tipo

Descrição

result

*ListVectorIndexesPaginator

Paginador usado para percorrer a lista de índices vetoriais. Para mais informações, consulte ListVectorIndexesPaginator.

Código de 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
	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 ID of your Alibaba Cloud account.")
}

func main() {
	flag.Parse()
	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, region required")
	}

	if len(bucketName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, bucket required")
	}

	if len(accountId) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, accountId required")
	}

	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region).WithAccountId(accountId).
		// To access the service over the public internet, set this parameter to false or remove this line.
		WithUseInternalEndpoint(true)

	client := vectors.NewVectorsClient(cfg)

	request := &vectors.ListVectorIndexesRequest{
		Bucket: oss.Ptr(bucketName),
	}
	p := client.NewListVectorIndexesPaginator(request)

	var i int
	log.Println("Vector Indexes:")
	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 found indexes.
		for _, index := range page.Indexes {
			log.Printf("index:%v, %v, %v, %v\n", oss.ToString(index.IndexName), oss.ToTime(index.CreateTime), oss.ToString(index.DataType), oss.ToString(index.Status))
		}
	}
}

Referências

Para ver o código de exemplo completo de listagem de índices vetoriais, consulte list_vector_indexes.go.