調用QueryDNAJobList查詢DNA作業。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
ice:QueryDNAJobList |
*全部資源
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| JobIds |
string |
否 |
需要查詢的 DNA 作業 ID 列表。一次最多建議查詢 10 個，用半形逗號（,）分隔。 |
88c6ca184c0e47098a5b665e2a12**** |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
請求 ID。 |
25818875-5F78-4A13-BEF6-D7393642CA58 |
| JobList |
array<object> |
DNA 作業資訊。 |
|
|
array<object> |
DNAJob |
||
| DNAResult |
string |
DNA 結果連結。 |
http://test_bucket.oss-cn-shanghai.aliyuncs.com/fingerprint/video/search_result/5/5.txt |
| PrimaryKey |
string |
唯一的視頻主鍵，唯一性由使用者保證。 |
3ca84a39a9024f19853b21be9cf9**** |
| DBId |
string |
DNA 庫 Id。 |
2288c6ca184c0e47098a5b665e2a12**** |
| CreationTime |
string |
作業建立時間。 |
2022-12-28T03:21:37Z |
| FinishTime |
string |
作業完成時間。 |
2022-12-28T03:21:44Z |
| Status |
string |
作業狀態，可取值：
|
Queuing |
| Message |
string |
作業執行錯誤資訊。 |
"The resource operated \"a887d0b***d805ef6f7f6786302\" cannot be found" |
| Config |
string |
DNA 配置。 |
{"SaveType": "save","MediaType"":"video"} |
| UserData |
string |
使用者自訂資料。 |
testdna |
| Code |
string |
作業執行錯誤碼。 |
"InvalidParameter.ResourceNotFound" |
| Input |
object |
輸入檔案。 |
|
| Type |
string |
輸入檔案類型，取值：
|
Media |
| Media |
string |
輸入檔案資訊，支援 OSS 地址和媒資 ID 兩種。 OSS 地址規則為 1、oss://bucket/object 2、http(s)://bucket.oss-[regionId].aliyuncs.com/object 其中 bucket 為和當前專案處於同一地區的 oss bucket 名稱，object 為檔案路徑。 |
1b1b9cd148034739af413150fded**** |
| Id |
string |
作業 ID。 |
88c6ca184c0e47098a5b665e2a12**** |
DNAResult 的內容為 Array of VideoMatchInfo，其中：
VideoMatchInfo 詳情
| 名稱 | 類型 | 描述 |
| PrimaryKey | String | 匹配檔案唯一主鍵。 |
| GlobalSimilarity | Double | 整體相似性。 |
| VideoMatchSegments | Array of VideoMatchSegment | 視頻/圖搜視頻匹配片段資訊。 |
| AudioMatchSegments | Array of AudioMatchSegment | 音頻搜音頻匹配片段資訊。 |
| TextMatchSegments | Array of TextMatchSegment | 文本搜文本匹配片段資訊。 |
VideoMatchSegment/AudioMatchSegment 詳情
| 名稱 | 類型 | 描述 |
| StartTime | Double | 輸入視頻/音訊開始時間。 |
| EndTime | Double | 輸入視頻/音訊結束時間。 |
| MasterStartTime | Double | 庫中視頻/音訊開始時間。 |
| MasterEndTime | Double | 庫中視頻/音訊結束時間。 |
| Similarity | Double | 匹配片段的信賴度。 |
TextMatchSegment 詳情
| 名稱 | 類型 | 描述 |
| Start | Double | 查詢匹配片段起始時間。 |
| End | Double | 查詢匹配片段結束時間。 |
| QueryText | String | 查詢匹配的文本片段。 |
| MasterText | String | 底庫匹配的文本片段。 |
| Similarity | Double | 匹配片段的信賴度。 |
樣本
正常返回樣本
JSON格式
{
"RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
"JobList": [
{
"DNAResult": "http://test_bucket.oss-cn-shanghai.aliyuncs.com/fingerprint/video/search_result/5/5.txt",
"PrimaryKey": "3ca84a39a9024f19853b21be9cf9****",
"DBId": "2288c6ca184c0e47098a5b665e2a12****",
"CreationTime": "2022-12-28T03:21:37Z",
"FinishTime": "2022-12-28T03:21:44Z",
"Status": "Queuing",
"Message": "\"The resource operated \\\"a887d0b***d805ef6f7f6786302\\\" cannot be found\"",
"Config": "{\"SaveType\": \"save\",\"MediaType\"\":\"video\"}",
"UserData": "testdna",
"Code": "\"InvalidParameter.ResourceNotFound\"",
"Input": {
"Type": "Media",
"Media": "1b1b9cd148034739af413150fded****"
},
"Id": "88c6ca184c0e47098a5b665e2a12****"
}
]
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。