調用ListRecognitionSamples分頁查詢自訂實體的識別樣本列表-智能媒體服務-阿里雲

介面說明

本介面目前支援的地區為華北 2（北京）、華東 2（上海）、華東 1（杭州）、華南 1（深圳），其他地區暫不支援。
本介面的單使用者 QPS 限制為 50 次/秒。超過限制，API 呼叫會被限流，這可能會影響您的業務，請合理調用。更多資訊，請參見 QPS 限制。

調試

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

調試

授權資訊

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

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ice:ListRecognitionSamples

get

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
Algorithm	string	是	識別類型，取值： landmark：自訂地標。 object：自訂物體。 logo：自訂 logo face：自訂人臉 label：自訂標籤	landmark
LibId	string	是	庫 ID，傳入則精確查該庫；支援傳入列表，用","分割。	lib1,lib2,lib3
EntityId	string	是	實體 ID。填"ANY"時，會查詢 EntityName。	************544cb84754**********
PageNumber	integer	是	頁碼	1
PageSize	integer	是	每頁返回的記錄數	10
EntityName	string	否	實體名。	custom_person

返回參數

名稱	類型	描述	樣本值
	object
RequestId	string	請求 ID	****11-DB8D-4A9A-875B-275798****
PageNumber	integer	頁碼	1
PageSize	integer	每頁返回的記錄數	20
TotalCount	integer	樣本總數	5
Samples	object
Sample	array<object>	樣本列表
	object	樣本
SampleId	string	樣本 ID。	************4d2ba728e2f************
ImageUrl	string	樣本圖片 URL	https://example.com/sample.png
EntityId	string	實體 id	*****49ff-9b15****
LibId	string	實體庫 id	********23da4529998**********

樣本

正常返回樣本

JSON格式

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "PageNumber": 1,
  "PageSize": 20,
  "TotalCount": 5,
  "Samples": {
    "Sample": [
      {
        "SampleId": "**************4d2ba728e2f**************",
        "ImageUrl": "https://example.com/sample.png",
        "EntityId": "*******49ff-9b15******",
        "LibId": "**********23da4529998************"
      }
    ]
  }
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
500	InternalError	errorMsg:%s

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

變更歷史

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