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