Object Storage Service:ベクターデータの書き込み (PutVectors)

注意事項

• 1 回の PutVectors リクエストでは最大 500 個のベクターを書き込めます。また、1 秒あたりのリクエスト数（QPS）は最大 5 です。

権限

Alibaba Cloud アカウント (root ユーザー) には、デフォルトですべての権限が付与されています。ただし、RAM ユーザーおよび RAM ロールには、デフォルトで権限が付与されていません。Alibaba Cloud アカウントの所有者または管理者が、RAM ポリシー または バケットポリシー を使用して、操作権限を明示的に付与する必要があります。

リクエスト構文

POST /?putVectors HTTP/1.1
Host: examplebucket-123***456.cn-hangzhou.oss-vectors.aliyuncs.com
Date: GMT 日付
Authorization: SignatureValue
Content-type: application/json

{
   "indexName": "文字列",
   "vectors": [ 
      { 
         "data": {
            "float32":[浮動小数点数]
         },
         "key": "文字列",
         "metadata": {
             "key1": ["value1", "value2"],
             "key2": "value2"
         }
      }
   ]
}

リクエストヘッダー

この操作では、共通のリクエストヘッダーのみを使用します。詳細については、「共通の HTTP ヘッダー」をご参照ください。

リクエストパラメーター

レスポンスヘッダー

この操作では、共通のレスポンスヘッダーのみを使用します。詳細については、「共通の HTTP ヘッダー」をご参照ください。

例

リクエストの例

POST /?putVectors HTTP/1.1
Host: examplebucket-123***456.cn-hangzhou.oss-vectors.aliyuncs.com
Date: Thu, 17 Apr 2025 01:33:47 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218
Content-type: application/json

{
   "indexName": "vectorindex1",
   "vectors": [
      {
         "key": "doc-001",
         "data": {
            "float32": [0.1, 0.2, 0.3, 0.4, 0.5]
         },
         "metadata": {
             "category": ["technology", "ai"],
             "title": "Introduction to Vector Search"
         }
      },
      {
         "key": "doc-002",
         "data": {
            "float32": [0.6, 0.7, 0.8, 0.9, 1.0]
         },
         "metadata": {
             "category": ["technology", "database"],
             "title": "Advanced Database Indexing"
         }
      }
   ]
}

レスポンスの例

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Thu, 17 Apr 2025 01:33:47 GMT
Connection: keep-alive
Server: AliyunOSS

SDK

以下の SDK で PutVectors 操作がサポートされています。

• ベクトルのアップロード（Python SDK V2）

• ベクトルのアップロード（Go SDK V2）

ossutil コマンドラインインターフェイス

PutVectors 操作に対応する ossutil コマンドの詳細については、「put-vectors」をご参照ください。

エラーコード