All Products
Search

This Product

    Object Storage Service:DeleteVectors

    Document Center

    Object Storage Service:DeleteVectors

    Last Updated:May 31, 2026

    Operasi DeleteVectors menghapus data vektor tertentu dari indeks vektor.

    Catatan

    • Anda dapat menghapus data vektor secara batch.

    • Operasi penghapusan tidak dapat dikembalikan. Gunakan perintah ini dengan hati-hati.

    Izin

    Akun Alibaba Cloud memiliki semua izin secara default. Pengguna Resource Access Management (RAM) atau Peran RAM tidak memiliki izin secara default. Akun Alibaba Cloud atau administrator harus memberikan izin melalui Kebijakan RAM atau kebijakan bucket.

    API

    Action

    Description

    DeleteVectors

    oss:DeleteVectors

    Menghapus data vektor.

    Sintaks permintaan

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

    Header permintaan

    Operasi ini hanya menggunakan header permintaan umum. Untuk informasi selengkapnya, lihat Header HTTP umum.

    Parameter permintaan

    Nama

    Tipe data

    Wajib

    Contoh

    Deskripsi

    indexName

    string

    Tidak

    vectorindex1

    Nama indeks.

    keys

    container

    Ya

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

    Daftar kunci primary vektor. Tidak ada error yang dilaporkan jika vektor untuk kunci primary yang ditentukan tidak ada.

    Batasan: Jumlah kunci unik harus berada dalam rentang [1, 500].

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

    Header respons

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

    Contoh

    Contoh permintaan

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

    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

    Operasi DeleteVectors tersedia di kit pengembangan perangkat lunak (SDK) berikut:

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

    AccessDenied

    403

    Error ini dapat dikembalikan karena alasan berikut:

    • Tidak ada informasi autentikasi pengguna yang disediakan saat permintaan diajukan.

    • Anda tidak memiliki izin yang diperlukan.

    NoSuchVectorIndex

    404

    Indeks vektor yang ditentukan tidak ada.

    QpsLimitExceeded

    503

    Laju permintaan per detik (QPS) dibatasi. Jika kode status HTTP adalah 5xx, hanya sebagian data dalam permintaan batch yang mungkin berhasil dihapus. Operasi penulisan tidak menjamin atomicity.