全部產品
Search
文件中心

Object Storage Service:向量Bucket級命令

更新時間:Sep 27, 2025

向量Bucket級命令提供對OSS向量Bucket的API的直接存取。在實際使用時,需要通過vectors-api命令發起調用。向量Bucket操作中沒有通用Bucket的Object key概念,通過索引和向量key管理向量資料,且所有請求都需攜帶 --account-id 參數。

一個向量Bucket API請求包含API名稱和API參數:Bucket名稱、索引名稱、header、query和body。

  • API名稱:每個API對應成一個命令,轉成短劃線(-)串連的名字

    PutVectorBucket轉成put-vector-bucket。關於API的更多資訊,請參見API概覽

  • API參數

    API參數

    選項名

    說明

    Bucket名稱

    --bucket

    string

    Bucket名稱。

    index名稱

    --index-name

    string

    索引名稱。僅在向量資料操作和索引管理操作中需要。

    account id

    --account-id

    string

    帳號ID。除了region外,還需要設定account id。account id可以設定在設定檔,也可以通過命令列選項傳入。

    query參數

    --data-type

    string

    每個query參數對應一個選項,小駝峰轉成短劃線(-)串連的全小寫,例如dataType為--data-type。

    body參數

    --vectors

    string

    合并為一個參數。

    • 以xml的根節點 ,轉成短劃線(-)串連的全小寫作為參數名。

    • 參數值為string,以file://為首碼的string,表示檔案路徑。

    • 參數值支援JSON 形式。