すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:ベクターインデックス情報の取得 (Go SDK V2)

最終更新日:Nov 09, 2025

Go SDK V2 を使用して GetVectorIndex 操作を呼び出し、指定されたベクターインデックスに関する情報を取得します。

権限

Alibaba Cloud アカウントは、デフォルトですべての権限を持っています。これに対し、Resource Access Management (RAM) ユーザーと RAM ロールは、デフォルトでは権限がありません。Alibaba Cloud アカウントのオーナーまたは管理者は、RAM ポリシーまたはバケットポリシーを使用して権限を付与する必要があります。

API

アクション

説明

GetVectorIndex

oss:GetVectorIndex

ベクターインデックスに関する情報を取得します。

メソッド定義

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

リクエストパラメーター

パラメーター

説明

ctx

context.Context

リクエストコンテキスト。

request

*GetVectorIndexRequest

リクエストパラメーター。これらには、クエリするバケットの名前とインデックス名が含まれます。詳細については、「GetVectorIndexRequest」をご参照ください。

optFns

...func(*Options)

(オプション) インターフェイスレベルの構成パラメーター。

詳細については、「Options」をご参照ください。

戻り値

パラメーター

説明

result

*GetVectorIndexResult

戻り値。これは err が nil の場合に有効です。詳細については、「GetVectorIndexResult」をご参照ください。

err

error

エラーメッセージ。操作が成功した場合、これは nil です。

サンプルコード

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", "", "ベクターバケットが配置されているリージョン。")
	flag.StringVar(&bucketName, "bucket", "", "ベクターバケットの名前。")
	flag.StringVar(&indexName, "index", "", "ベクターインデックスの名前。")
	flag.StringVar(&accountId, "account-id", "", "ベクターアカウントの ID。")
}

func main() {
	flag.Parse()
	if len(bucketName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("無効なパラメーターです。バケット名が必要です")
	}

	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("無効なパラメーターです。リージョンが必要です")
	}

	if len(indexName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("無効なパラメーターです。インデックスが必要です")
	}

	if len(accountId) == 0 {
		flag.PrintDefaults()
		log.Fatalf("無効なパラメーターです。accountId が必要です")
	}

	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region).WithAccountId(accountId)

	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("ベクターインデックスの取得に失敗しました %v", err)
	}
	log.Printf("ベクターインデックスの結果を取得:%#v\n", result)
}

リファレンス

ベクターインデックス情報を取得するための完全なサンプルコードについては、「get_vector_index.go」をご参照ください。