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 |
|
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:
|
|
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. |