All Products
Search

This Product

    Object Storage Service:put-vector-index

    Document Center

    Object Storage Service:put-vector-index

    Last Updated:Jun 27, 2026

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

    Catatan

    • Satu bucket vektor dapat berisi hingga 100 indeks vektor.

    • Maksimal lima permintaan PutVectorIndex didukung per detik.

    Izin

    Secara default, akun Alibaba Cloud memiliki semua izin, sedangkan pengguna Resource Access Management (RAM) dan peran RAM tidak memiliki izin apa pun. Akun Alibaba Cloud atau administrator harus memberikan izin melalui kebijakan RAM atau kebijakan bucket.

    API

    Tindakan

    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 bucket vektor.

    --data-type

    string

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

    --dimension

    int

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

    --distance-metric

    string

    Fungsi ukuran jarak. Nilai yang valid:

    • euclidean: Jarak Euclidean (default)

    • cosine: Jarak cosine

    --index-name

    string

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

    • Nama harus unik secara global dalam bucket vektor dan panjangnya antara 1 hingga 63 karakter.

    • Nama hanya boleh terdiri dari 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 antara 1 hingga 100.

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

    Catatan

    Contoh penggunaan

    • Buat indeks bernama index untuk bucket examplebucket. Indeks tersebut memiliki dimensi vektor 512, menggunakan tipe data float32, dan 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 tersebut memiliki dimensi vektor 512, menggunakan tipe data float32, dan 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"]}'