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

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

最終更新日:Jun 03, 2026

Go SDK V2 を使用して GetVectorIndex API を呼び出し、特定のベクターインデックスに関する情報を取得します。

権限

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

API

Action

説明

GetVectorIndex

ossvector:GetVectorIndex

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

メソッド定義

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

リクエストパラメーター

パラメーター

型

説明

ctx

context.Context

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

request

*GetVectorIndexRequest

バケット名やインデックス名などのリクエストパラメーターを指定します。詳細については、「GetVectorIndexRequest」をご参照ください。

optFns

...func(*oss.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", "", "Alibaba Cloud アカウントの ID です。")
}

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).
		// パブリックエンドポイント経由でサービスにアクセスする場合は、これを false に設定するか、この行を削除してください。
		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)
}

関連ドキュメント

完全なサンプルコードについては、「get_vector_index.go」をご参照ください。