DeleteVectors 操作は、ベクトルインデックスから指定されたベクトルデータを削除します。
注意
ベクトルデータをバッチで削除できます。
削除操作は元に戻せません。このコマンドは注意して使用してください。
権限
デフォルトでは、Alibaba Cloud アカウントはすべての権限を持っています。Alibaba Cloud アカウント下の Resource Access Management (RAM) ユーザーまたは RAM ロールは、デフォルトでは権限を持っていません。Alibaba Cloud アカウントまたは管理者は、RAM ポリシーまたはバケットポリシーを使用して権限を付与する必要があります。
API | アクション | 説明 |
DeleteVectors |
| ベクトルデータを削除します。 |
リクエスト構文
POST /?deleteVectors HTTP/1.1
Host: examplebucket-123***456.cn-hangzhou.oss-vectors.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
Content-type: application/json
{
"indexName": "string",
"keys": [string, string, string]
}リクエストヘッダー
この操作は、共通のリクエストヘッダーのみを使用します。詳細については、「共通リクエストヘッダー」をご参照ください。
リクエストパラメーター
名前 | データ型 | 必須 | 例 | 説明 |
indexName | 文字列 | いいえ | vectorindex1 | インデックスの名前。 |
keys | コンテナー | はい | ["doc-001", "doc-002"] | ベクトルプライマリキーのリスト。削除したいプライマリキーに対応するベクトルが存在しない場合、エラーは報告されません。 制限: 一意のキーの数は 1 から 500 の範囲である必要があります。 |
この操作は、共通のリクエストヘッダーも使用します。詳細については、「共通リクエストヘッダー」をご参照ください。
レスポンスヘッダー
この操作は、共通のレスポンスヘッダーのみを使用します。詳細については、「共通レスポンスヘッダー」をご参照ください。
例
リクエスト例
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エラーコード
エラーコード | HTTP ステータスコード | 説明 |
VectorIndexParameterInvalid | 400 | リクエストで指定されたベクトルインデックスパラメーターが無効です。 |
MalformedJson | 400 | リクエストボディの JSON フォーマットが無効です。 |
AccessDenied | 403 | このエラーの原因として、以下が考えられます。
|
NoSuchVectorIndex | 404 | 指定されたベクトルインデックスが存在しません。 |
QpsLimitExceeded | 503 | リクエストレートが 1 秒あたりのクエリ数 (QPS) の上限を超えています。HTTP ステータスコードが 5xx の場合、バッチリクエスト内の一部のデータのみが正常に削除される可能性があります。書き込み操作は原子性を保証しません。 |