DeleteVectors - Object Storage Service: Central de Documentação do Alibaba Cloud

Observações

A exclusão em lote é compatível.
A exclusão é irreversível. Proceda com cautela.

Permissões

Por padrão, uma conta Alibaba Cloud tem todas as permissões. Usuários ou funções do Resource Access Management (RAM) não possuem permissões por padrão. A conta Alibaba Cloud ou um administrador deve conceder permissões por meio de uma política do RAM ou de uma política de bucket.

API	Action	Descrição
DeleteVectors	`oss:DeleteVectors`	Exclua dados vetoriais.

Sintaxe da solicitação

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

Cabeçalhos da solicitação

Esta operação usa apenas cabeçalhos de solicitação comuns. Para obter mais informações, consulte Cabeçalhos HTTP comuns.

Parâmetros da solicitação

Nome

Tipo de dado

Obrigatório

Exemplo

Descrição

indexName

string

Não

vectorindex1

Nome do índice.

keys

container

Sim

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

Lista de chaves primárias vetoriais. O sistema não retorna erro se o vetor de uma chave primária especificada não existir.

Restrição: o número de chaves únicas deve estar no intervalo [1, 500].

Esta operação também usa cabeçalhos de solicitação comuns. Para obter mais informações, consulte Cabeçalhos HTTP comuns.

Cabeçalhos da resposta

Esta operação usa apenas cabeçalhos de resposta comuns. Para obter mais informações, consulte Cabeçalhos HTTP comuns.

Exemplos

Exemplo de solicitação

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

Exemplo de resposta

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

O DeleteVectors está disponível nos seguintes SDKs:

Interface de linha de comando ossutil

Para obter o comando ossutil correspondente, consulte delete-vectors.

Códigos de erro

Código de erro	Código de status HTTP	Descrição
VectorIndexParameterInvalid	400	A solicitação contém um parâmetro de índice vetorial inválido.
MalformedJson	400	O corpo da solicitação contém json malformado.
AccessDenied	403	Esse erro pode ocorrer pelos seguintes motivos: A solicitação não inclui informações de autenticação. Você não tem as permissões necessárias.
NoSuchVectorIndex	404	O índice vetorial especificado não existe.
QpsLimitExceeded	503	O limite de consultas por segundo (QPS) foi excedido. Se o código de status HTTP for 5xx, talvez apenas parte dos dados da solicitação em lote seja excluída. A operação de gravação não garante atomicidade.