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

Object Storage Service:DeleteVectors

最終更新日:Nov 09, 2025

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

注意

  • ベクトルデータをバッチで削除できます。

  • 削除操作は元に戻せません。このコマンドは注意して使用してください。

権限

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

API

アクション

説明

DeleteVectors

oss: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 の場合、バッチリクエスト内の一部のデータのみが正常に削除される可能性があります。書き込み操作は原子性を保証しません。