DeleteVectors - Object Storage Service - Alibaba Cloud Dokümantasyon Merkezi

Notlar

Toplu iş silme desteklenir.
Silme işlemi geri alınamaz. Dikkatli olun.

İzinler

Alibaba Cloud hesabı varsayılan olarak tüm izinlere sahiptir. Resource Access Management (RAM) kullanıcısı veya RAM rolü varsayılan olarak herhangi bir izne sahip değildir. Alibaba Cloud hesabı veya yönetici, RAM ilkesi veya paket ilkesi kullanarak izinleri vermelidir.

API	Action	Açıklama
DeleteVectors	`oss:DeleteVectors`	Vektör verilerini siler.

İstek sözdizimi

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

İstek üstbilgileri

Bu işlem yalnızca ortak istek üstbilgilerini kullanır. Daha fazla bilgi için bkz. Ortak HTTP üstbilgileri.

İstek parametreleri

Ad

Veri türü

Gerekli

Örnek

Açıklama

indexName

string

Hayır

vectorindex1

Dizin adı.

keys

container

Evet

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

Vektör birincil anahtarlarının listesi. Belirtilen birincil anahtara ait bir vektör yoksa hata döndürülmez.

Kısıtlama: Benzersiz anahtar sayısı [1, 500] aralığında olmalıdır.

Bu işlem ayrıca ortak istek üstbilgilerini kullanır. Daha fazla bilgi için bkz. Ortak HTTP üstbilgileri.

Yanıt üstbilgileri

Bu işlem yalnızca ortak yanıt üstbilgilerini kullanır. Daha fazla bilgi için bkz. Ortak HTTP üstbilgileri.

Örnekler

İstek örneği

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

Yanıt örneği

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 aşağıdaki SDK'lerde kullanılabilir:

ossutil komut satırı arabirimi

İlgili ossutil komutu için bkz. delete-vectors.

Hata kodları

Hata kodu	HTTP durum kodu	Açıklama
VectorIndexParameterInvalid	400	İstek geçersiz bir vektör dizini parametresi içeriyor.
MalformedJson	400	İstek gövdesi hatalı biçimlendirilmiş JSON içeriyor.
AccessDenied	403	Bu hata aşağıdaki nedenlerle döndürülebilir: İstek kimlik doğrulama bilgilerini içermiyor. Gerekli izinlere sahip değilsiniz.
NoSuchVectorIndex	404	Belirtilen vektör dizini mevcut değil.
QpsLimitExceeded	503	Saniye başına sorgu (QPS) sınırı aşıldı. HTTP durum kodu 5xx ise toplu iş isteğindeki verilerin yalnızca bir kısmı silinebilir. Yazma işlemi atomikliği garanti etmez.