DeleteVectors - Object Storage Service - Centre de documentation Alibaba Cloud

Notes

La suppression par lot est prise en charge.
La suppression est irréversible. Procédez avec prudence.

Permissions

Un compte Alibaba Cloud dispose de toutes les autorisations par défaut. Un utilisateur ou un rôle RAM (Resource Access Management) ne dispose d'aucune autorisation par défaut. Le compte Alibaba Cloud ou un administrateur doit accorder les autorisations à l'aide d'une politique RAM ou d'une politique de bucket.

API

Action

Description

DeleteVectors

oss:DeleteVectors

Supprime des données vectorielles.

Syntaxe de la requête

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]
}

En-têtes de requête

Cette opération utilise uniquement des en-têtes de requête communs. Pour plus d'informations, consultez la section En-têtes HTTP communs.

Paramètres de requête

Nom

Type de données

Obligatoire

Exemple

Description

indexName

string

Non

vectorindex1

Nom de l'index.

keys

container

Oui

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

Liste des clés primaires des vecteurs. Aucune erreur n'est signalée si un vecteur correspondant à une clé primaire spécifiée n'existe pas.

Contrainte : le nombre de clés uniques doit être compris entre 1 et 500.

Cette opération utilise également des en-têtes de requête communs. Pour plus d'informations, consultez la section En-têtes HTTP communs.

En-têtes de réponse

Cette opération utilise uniquement des en-têtes de réponse communs. Pour plus d'informations, consultez la section En-têtes HTTP communs.

Exemples

Exemple de requête

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"]
}

Exemple de réponse

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

L'opération DeleteVectors est disponible dans les SDK suivants :

Interface de ligne de commande ossutil

Pour la commande ossutil correspondante, consultez la section delete-vectors.

Codes d'erreur

Code d'erreur	Code d'état HTTP	Description
VectorIndexParameterInvalid	400	La requête contient un paramètre d'index vectoriel non valide.
MalformedJson	400	Le corps de la requête contient du JSON mal formé.
AccessDenied	403	Cette erreur peut être renvoyée pour les raisons suivantes : La requête ne contient pas d'informations d'authentification. Vous ne disposez pas des autorisations requises.
NoSuchVectorIndex	404	L'index vectoriel spécifié n'existe pas.
QpsLimitExceeded	503	La limite de requêtes par seconde (QPS) est dépassée. Si le code d'état HTTP est 5xx, seules certaines données de la requête par lot peuvent être supprimées. L'opération d'écriture ne garantit pas l'atomicité.