HapusVektor - Object Storage Service

Operasi HapusVektor menghapus data vektor tertentu dari indeks vektor.

Catatan

Anda dapat menghapus data vektor dalam batch.
Operasi penghapusan tidak dapat dibatalkan. Gunakan perintah ini dengan hati-hati.

Izin

Akun Alibaba Cloud memiliki semua izin secara default. Pengguna Manajemen Akses Sumber Daya (RAM) atau Peran RAM di bawah Akun Alibaba Cloud tidak memiliki izin secara default. Administrator harus memberikan izin menggunakan Kebijakan RAM atau kebijakan bucket.

API	Aksi	Deskripsi
DeleteVectors	`oss:DeleteVectors`	Menghapus data vektor.

Sintaks permintaan

POST /?deleteVectors HTTP/1.1
Host: examplebucket-123***456.cn-hangzhou.oss-vectors.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
Content-type: application/json

{
   "indexName": "string",
   "keys": [string, string, string]
}

Header permintaan

Operasi ini hanya menggunakan header permintaan umum. Untuk informasi lebih lanjut, lihat Header Permintaan Umum.

Parameter permintaan

Nama

Tipe data

Diperlukan

Contoh

Deskripsi

indexName

string

Tidak

vectorindex1

Nama indeks.

keys

Kontainer

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

Daftar kunci primer vektor. Jika vektor yang sesuai dengan kunci primer yang ingin Anda hapus tidak ada, tidak akan ada kesalahan yang dilaporkan.

Batas: Jumlah kunci unik harus antara 1 hingga 500.

Operasi ini juga menggunakan header permintaan umum. Untuk informasi lebih lanjut, lihat Header Permintaan Umum.

Header respons

Operasi ini hanya menggunakan header respons umum. Untuk informasi lebih lanjut, lihat Header Respons Umum.

Contoh

Contoh Permintaan

POST /?deleteVectors HTTP/1.1
Host: examplebucket-123***456.cn-hangzhou.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"]
}

Contoh Respons

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

Kode kesalahan

Kode kesalahan	Kode status HTTP	Deskripsi
VectorIndexParameterInvalid	400	Parameter indeks vektor yang diberikan dalam permintaan tidak valid.
MalformedJson	400	Format JSON dari badan permintaan tidak valid.
AccessDenied	403	Penyebab potensial untuk kesalahan ini meliputi hal berikut: Informasi autentikasi pengguna tidak disertakan dalam permintaan. Anda tidak memiliki izin yang diperlukan untuk operasi tersebut.
NoSuchVectorIndex	404	Indeks vektor yang ditentukan tidak ada.
QpsLimitExceeded	503	Laju permintaan melebihi batas permintaan per detik (QPS). Jika kode status HTTP adalah 5xx, hanya sebagian data dalam permintaan batch yang mungkin berhasil dihapus. Operasi penulisan tidak menjamin atomicity.