DeleteVectors - Object Storage Service - Centro de documentación de Alibaba Cloud

Elimina los datos vectoriales especificados de un índice vectorial.

Notas

Se admite la eliminación por lotes.
La eliminación es irreversible. Proceda con precaución.

Permisos

Una cuenta de Alibaba Cloud tiene todos los permisos de forma predeterminada. Un usuario o rol de Resource Access Management (RAM) no cuenta con ningún permiso de manera predeterminada. La cuenta de Alibaba Cloud o un administrador deben otorgar los permisos mediante una RAM policy o una bucket policy.

API	Acción	Descripción
DeleteVectors	`oss:DeleteVectors`	Elimina datos vectoriales.

Sintaxis de la solicitud

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

Encabezados de solicitud

Esta operación utiliza únicamente los encabezados de solicitud comunes. Para obtener más información, consulte Common HTTP headers.

Parámetros de solicitud

Nombre

Tipo de dato

Obligatorio

Ejemplo

Descripción

indexName

string

vectorindex1

El nombre del índice.

keys

container

Sí

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

Una lista de claves primarias vectoriales. No se reporta ningún error si no existe el vector correspondiente a una clave primaria especificada.

Restricción: la cantidad de claves únicas debe estar en el rango [1, 500].

Esta operación también utiliza los encabezados de solicitud comunes. Para obtener más información, consulte Common HTTP headers.

Encabezados de respuesta

Esta operación utiliza únicamente los encabezados de respuesta comunes. Para obtener más información, consulte Common HTTP headers.

Ejemplos

Ejemplo de solicitud

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

Ejemplo de respuesta

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 está disponible en los siguientes SDK:

Interfaz de línea de comandos de ossutil

Para consultar el comando de ossutil correspondiente, consulte delete-vectors.

Códigos de error

Código de error	Código de estado HTTP	Descripción
VectorIndexParameterInvalid	400	La solicitud contiene un parámetro de índice vectorial no válido.
MalformedJson	400	El cuerpo de la solicitud contiene JSON con formato incorrecto.
AccessDenied	403	Este error puede devolverse por las siguientes razones: La solicitud no incluye información de autenticación. Usted no cuenta con los permisos obligatorios.
NoSuchVectorIndex	404	El índice vectorial especificado no existe.
QpsLimitExceeded	503	Se superó el límite de consultas por segundo (QPS). Si el código de estado HTTP es 5xx, es posible que solo se eliminen algunos datos de la solicitud por lotes. La operación de escritura no garantiza atomicidad.