Todos os produtos
Search
Central de documentação

Object Storage Service:DeleteVectors

Última atualização: Sep 22, 2026

Exclua os dados de vetores especificados de um índice de vetores.

Observações

  • Há suporte para exclusão em lote.

  • A exclusão é irreversível. Prossiga com cautela.

Permissões

Por padrão, uma conta Alibaba Cloud possui todas as permissões, enquanto um usuário ou uma função do Resource Access Management (RAM) não possui nenhuma. A conta Alibaba Cloud ou um administrador deve conceder permissões usando uma RAM policy ou uma bucket policy.

API

Ação

Descrição

DeleteVectors

oss:DeleteVectors

Exclua dados de vetores.

Sintaxe da requisiçã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 requisição

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

Parâmetros da requisição

Nome

Tipo de dados

Obrigatório

Exemplo

Descrição

indexName

string

Não

vectorindex1

O nome do índice.

keys

container

Sim

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

Uma lista de chaves primárias de vetores. O sistema não retorna erro se não existir um vetor para a chave primária especificada.

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

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

Cabeçalhos da resposta

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

Exemplos

Exemplo de requisiçã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

DeleteVectors está disponível nos seguintes SDKs:

Interface de linha de comando ossutil

Para 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 requisição contém um parâmetro de índice de vetores inválido.

MalformedJson

400

O corpo da requisição contém JSON malformado.

AccessDenied

403

Este erro pode ocorrer pelos seguintes motivos:

  • A requisição não inclui informações de autenticação.

  • Você não tem as permissões necessárias.

NoSuchVectorIndex

404

O índice de vetores especificado não existe.

QpsLimitExceeded

503

O limite de consultas por segundo (QPS) foi excedido. Se o código de status HTTP for 5xx, o sistema poderá excluir apenas parte dos dados da requisição em lote. A operação de gravação não garante atomicidade.