全部產品
Search
文件中心

:IndexFileMeta - 檔案元資訊建立索引

更新時間:Jan 29, 2026

對輸入的檔案進行資料處理如標籤識別、臉部偵測、地點檢測等。將提取的檔案元資訊建立索引,支援使用者在一個資料集內多樣化的資料檢索。

介面說明

  • 請確保在使用該介面前,已充分瞭解Intelligent Media Management產品的收費方式和價格

  • 檔案元資訊建立索引資料處理支援列表請參見工作流程範本與運算元

  • 檔案元資訊建立索引有檔案總數量和檔案總大小限制,請參考使用限制說明中資料集限制部分, 關於資料集建立請參考參數說明。

  • 檔案元資訊建立索引支援地區列表請參考使用限制說明中各地區支援的功能,資料集與索引部分。

  • 檔案元資訊建立索引後,您可以通過簡單查詢進行資料檢索,其他檢索能力請見查詢與統計,還可以通過建立人臉聚類產生人臉分組,其他聚類能力請見智能管理

說明
  • 該介面為非同步作業,在您提交請求後,需要一定時間對您提交的檔案進行處理,處理完成後才會將中繼資料存放區到資料集內。該過程視工作流程範本與運算元不同、檔案內容不同,需要數秒到數分鐘甚至更久。您可以通過訊息訂閱能力接收任務完成通知。

調試

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

調試

授權資訊

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

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

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

imm:IndexFileMeta

create

*Dataset

acs:imm:{#regionId}:{#accountId}:project/{#ProjectName}/dataset/{#DatasetName}

請求參數

名稱

類型

必填

描述

樣本值

ProjectName

string

專案名稱,擷取方式請參見建立專案

test-project

DatasetName

string

資料集名稱, 擷取方式請參見建立資料集

test-dataset

File InputFile

需要索引的檔案,格式為 JSON。請參考結構體定義。

UserData

string

使用者自訂資訊,在非同步訊息通知中會返回,方便您在系統內對訊息通知進行關聯處理。最大長度為 2048 位元組。

{"ID": "user1","Name": "test-user1","Avatar": "http://example.com?id=user1"}

Notification Notification

訊息通知配置,詳細內容請點擊 Notification 查看,非同步通知訊息格式請參見非同步通知訊息格式中繼資料索引一欄。

返回參數

名稱

類型

描述

樣本值

object

響應結構體。

RequestId

string

請求 ID。

6E93D6C9-5AC0-49F9-914D-E02678D3****

EventId

string

事件 ID。

30F-1D8FxFzDXKJH9YQdve4CjR****

樣本

正常返回樣本

JSON格式

{
  "RequestId": "6E93D6C9-5AC0-49F9-914D-E02678D3****",
  "EventId": "30F-1D8FxFzDXKJH9YQdve4CjR****"
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情