DeleteVectors - Object Storage Service

Panggil operasi DeleteVectors untuk menghapus data vektor tertentu dari indeks vektor.

Catatan

Anda dapat menghapus data vektor secara batch.
Operasi penghapusan bersifat ireversibel. Gunakan perintah ini dengan hati-hati.

Izin

Secara default, Akun Alibaba Cloud memiliki semua izin. Pengguna Resource Access Management (RAM) atau RAM role di bawah Akun Alibaba Cloud tidak memiliki izin secara default. Akun Alibaba Cloud atau administrator harus memberikan izin melalui RAM Policy atau Bucket Policy.

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

Sintaksis 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 selengkapnya, lihat Common HTTP headers.

Parameter permintaan

Nama

Tipe data

Wajib

Contoh

Deskripsi

indexName

string

Tidak

vectorindex1

Nama indeks.

keys

container

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

Daftar kunci primary vektor. Jika kunci primary yang ditentukan tidak sesuai dengan vektor yang ada, tidak akan dilaporkan error.

Batasan: Jumlah kunci unik harus berada dalam rentang 1 hingga 500.

Operasi ini juga menggunakan header permintaan umum. Untuk informasi selengkapnya, lihat Common HTTP headers.

Header respons

Operasi ini hanya menggunakan header respons umum. Untuk informasi selengkapnya, lihat Common HTTP headers.

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

SDK

SDK berikut mendukung operasi DeleteVectors:

Antarmuka baris perintah ossutil

Untuk perintah ossutil yang sesuai dengan operasi DeleteVectors, lihat delete-vectors.

Kode error

Kode error	Kode status HTTP	Deskripsi
VectorIndexParameterInvalid	400	Parameter indeks vektor yang diberikan dalam permintaan tidak valid.
MalformedJson	400	Format JSON dalam badan permintaan tidak valid.
AccessDenied	403	Kemungkinan penyebab error ini: Informasi autentikasi pengguna tidak disertakan dalam permintaan. Izin yang diperlukan untuk operasi ini belum diberikan.
NoSuchVectorIndex	404	Indeks vektor yang ditentukan tidak ada.
QpsLimitExceeded	503	Batas QPS terlampaui. Laju permintaan dibatasi. Jika kode status HTTP adalah 5xx, hanya sebagian data dalam permintaan batch yang mungkin dihapus. Operasi penulisan tidak menjamin atomicity.