全部產品
Search

搜尋本產品

    Intelligent Media Services：InsertMediaToSearchLib - 插入媒資到搜尋庫

    文件中心

    Intelligent Media Services：InsertMediaToSearchLib - 插入媒資到搜尋庫

    更新時間：Mar 21, 2026

    插入媒資到搜尋庫。

    介面說明

    前提條件

    插入媒資到搜尋庫前，需要調用 CreateSearchLib 介面建立好搜尋庫。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ice:InsertMediaToSearchLib

    create

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    SearchLibName

    string

    否

    搜尋庫名稱。需要調用 CreateSearchLib 介面提前建立好搜尋庫。

    test1
    MediaId

    string

    否

    媒資 ID。具有唯一性，不填會自動產生。

    411bed50018971edb60b0764a0ec6***
    MediaType

    string

    否

    媒資類型。預設值 video。

    • video 視頻

    • image 圖片

    • audio 音頻

    枚舉值：

    • image :

      image

    • video :

      video

    • audio :

      audio

    video
    Input

    string

    是

    需要入庫的視頻、音頻或圖片檔案的地址，請勿使用臨時地址，需保證源檔案可以被訪問。

    說明

    請確認您的檔案名稱正確且所在 Bucket 與介面調用地區一致，否則可能導致找不到檔案或介面調用失敗。

    • OSS 地址（推薦）：oss://[Bucket 名稱]/[檔案路徑]，例如 oss://[example-bucket-]/[object_path-]。

    • HTTP 地址：公網可下載的地址，例如 http://example-test-****.mp4。

    oss://[example-bucket-]/[object_path-]
    MsgBody

    string

    否

    媒資資訊。JSON 字串。支援欄位：

    • title，標題，string 類型

    • customFields，自訂欄位，JSONObject，參數不支援修改；支援 Int 型 intField1、string 型 strField1、strField2

    {"title":"test","customFields":{"intField1":12,"strField1":"abc"}}
    ImagesInput

    string

    否

    圖片集資訊。僅支援 IPCamera 情境，MediaType 需為 video。

    { "images": [ "oss://[example-bucket-]/[object_path-]xxx1.jpg", "oss://[example-bucket-]/[object_path-]xxx2.jpg", "oss://[example-bucket-]/[object_path-]xxx3.jpg", "oss://[example-bucket-]/[object_path-]xxx4.jpg" ] }
    Namespace

    string

    否

    命名空間。

    name-1

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    RequestId

    string

    請求 ID。

    *****ACB-44F2-5F2D-88D7-1283E70*****
    MediaId

    string

    媒資 ID。

    ****20b48fb04483915d4f2cd8ac****
    Success

    string

    是否調用成功。取值：

    • true： 成功

    • false：失敗

    true
    Code

    string

    返回碼。

    200

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "*****ACB-44F2-5F2D-88D7-1283E70*****",
  "MediaId": "****20b48fb04483915d4f2cd8ac****",
  "Success": "true",
  "Code": "200"
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。