Todos os produtos
Search
Central de documentação

Object Storage Service:Obter índice vetorial (Go SDK V2)

Última atualização: Jul 03, 2026

Chame a operação GetVectorIndex pelo Go SDK V2 para recuperar informações de um índice vetorial específico.

Permissões

As contas Alibaba Cloud têm permissões completas por padrão. Usuários e funções RAM exigem autorização explícita por meio de uma política do RAM ou de uma política de bucket.

API

Ação

Descrição

GetVectorIndex

oss:GetVectorIndex

Recupera informações do índice vetorial.

Definição do método

func (c *VectorsClient) GetVectorIndex(ctx context.Context, request *GetVectorIndexRequest, optFns ...func(*oss.Options)) (*GetVectorIndexResult, error) 

Parâmetros da solicitação

Parâmetro

Tipo

Descrição

ctx

context.Context

Contexto da solicitação.

request

*GetVectorIndexRequest

Parâmetros da solicitação, incluindo o nome do bucket e do índice. Para obter mais informações, consulte GetVectorIndexRequest.

optFns

...func(*Options)

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

Para obter mais informações, consulte Options.

Valores de retorno

Parâmetro

Tipo

Descrição

result

*GetVectorIndexResult

Resultado da operação. Válido apenas quando err é nil. Para obter mais informações, consulte GetVectorIndexResult.

err

error

Mensagem de erro. Retorna nil em caso de sucesso.

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

func init() {
	flag.StringVar(&region, "region", "", "The region where the bucket is located.")
	flag.StringVar(&bucketName, "bucket", "", "The name of the bucket.")
	flag.StringVar(&indexName, "index", "", "The name of the vector index.")
	flag.StringVar(&accountId, "account-id", "", "The ID of the Alibaba Cloud account.")
}

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(indexName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, index 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 a public endpoint, set this to false or remove this line.
		WithUseInternalEndpoint(true)

	client := vectors.NewVectorsClient(cfg)

	request := &vectors.GetVectorIndexRequest{
		Bucket:    oss.Ptr(bucketName),
		IndexName: oss.Ptr(indexName),
	}
	result, err := client.GetVectorIndex(context.TODO(), request)
	if err != nil {
		log.Fatalf("failed to get vector index %v", err)
	}
	log.Printf("get vector index result:%#v\n", result)
}

Referências

Para visualizar o código de exemplo completo, consulte get_vector_index.go.