DeleteVectors API 呼び出しによるベクトルデータの削除 - OSS

DeleteVectors 操作を呼び出して、ベクトルインデックスから指定されたベクトルデータを削除します。

注意事項

ベクトルデータをバッチ単位で削除できます。
削除操作は元に戻すことができません。実行には十分ご注意ください。

権限

デフォルトでは、Alibaba Cloud アカウント (root ユーザー) はすべての権限を持ちます。一方、Alibaba Cloud アカウント配下の Resource Access Management (RAM) ユーザーまたは RAM ロールは、デフォルトで権限を持ちません。Alibaba Cloud アカウントまたは管理者が、RAM ポリシーまたはバケットポリシーを使用して権限を付与する必要があります。

API	Action	説明
DeleteVectors	`oss:DeleteVectors`	ベクトルデータを削除します。

リクエスト構文

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

{
   "indexName": "文字列",
   "keys": ["文字列", "文字列", "文字列"]
}

リクエストヘッダー

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

リクエストパラメーター

名前

データ型

必須

例

説明

indexName

文字列

いいえ

vectorindex1

インデックスの名前です。

keys

コンテナー

はい

["doc-001", "doc-002"]

ベクトルのプライマリキーのリストです。指定されたプライマリキーに対応するベクトルが存在しない場合でも、エラーは報告されません。

制約：一意のキー数は 1～500 の範囲である必要があります。

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

レスポンスヘッダー

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

サンプル

リクエストの例

POST /?deleteVectors 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",
   "keys": ["doc-001", "doc-002", "doc-003"]
}

レスポンスの例

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

SDK

DeleteVectors 操作をサポートする SDK は以下のとおりです。

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

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

エラーコード

エラーコード	HTTP ステータスコード	説明
VectorIndexParameterInvalid	400	リクエストで指定されたベクトルインデックスのパラメーターが無効です。
MalformedJson	400	リクエストボディ内の JSON フォーマットが無効です。
AccessDenied	403	このエラーの発生要因として考えられるのは以下です。リクエストにユーザー認証情報が含まれていません。この操作に必要な権限が付与されていません。
NoSuchVectorIndex	404	指定されたベクトルインデックスが存在しません。
QpsLimitExceeded	503	QPS 制限を超えました。リクエスト頻度が制限されています。HTTP ステータスコードが 5xx の場合、バッチリクエスト内の一部のデータのみが削除される可能性があります。書き込み操作は原子性を保証しません。