All Products
Search

This Product

    Object Storage Service:put-vector-index

    Document Center

    Object Storage Service:put-vector-index

    Last Updated:Nov 09, 2025

    Perintah put-vector-index digunakan untuk membuat indeks vektor di dalam bucket vektor.

    Catatan penggunaan

    • Satu bucket vektor mendukung maksimum 100 indeks vektor.

    • Operasi PutVectorIndex mendukung hingga 5 permintaan per detik.

    Izin

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

    API

    Aksi

    Deskripsi

    PutVectorIndex

    oss:PutVectorIndex

    Membuat indeks vektor.

    Format perintah

    ossutil vectors-api put-vector-index --bucket value --index-name value [flags]

    Parameter

    Parameter

    Tipe

    Deskripsi

    --bucket

    string

    Nama dari bucket vektor.

    --data-type

    string

    Tipe data dari vektor. Tipe data kustom tidak didukung. Nilai default: float32.

    --dimension

    int

    Dimensi vektor. Nilainya dapat berupa bilangan bulat dari 1 hingga 4.096. Nilai default adalah 512.

    --distance-metric

    string

    Fungsi ukuran jarak. Nilai yang valid:

    • euclidean: Jarak Euclidean (default)

    • cosine: Jarak Cosinus

    --index-name

    string

    Nama dari indeks. Anda dapat menentukan nama kustom. Nilai default kosong.

    • Nama tersebut harus unik secara global dalam bucket vektor dan harus memiliki panjang 1 hingga 63 karakter.

    • Nama hanya dapat berisi huruf dan angka, serta harus dimulai dengan huruf.

    --metadata

    string

    Kontainer untuk konfigurasi metadata. Hanya metadata non-filterable yang didukung. Batasan berikut berlaku untuk konfigurasi metadata non-filterable:

    • Jumlah entri metadata harus berkisar antara 1 hingga 10.

    • Panjang setiap nama kunci utama metadata harus berkisar antara 1 hingga 63 byte.

    Catatan

    Contoh penggunaan

    • Buat indeks bernama index untuk bucket examplebucket. Indeks ini memiliki 512 dimensi vektor, menggunakan tipe data float32, dan fungsi ukuran jarak euclidean.

      ossutil vectors-api put-vector-index --bucket examplebucket --index-name index --data-type float32 --dimension 512 --distance-metric euclidean

    • Buat indeks bernama index untuk bucket examplebucket dan konfigurasikan metadata non-filterable. Indeks ini memiliki 512 dimensi vektor, menggunakan tipe data float32, dan fungsi ukuran jarak euclidean.

      ossutil vectors-api put-vector-index --bucket examplebucket --index-name index --data-type float32 --dimension 512 --distance-metric euclidean --metadata '{"nonFilterableMetadataKeys":["owner","createdBy"]}'