獲取目標的詳細信息。

調試

您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱 類型 是否必選 示例值 描述
Action String DescribeWatchItems

系統規定參數。取值:DescribeWatchItems

PageNumber Long 1

獲取第幾個分頁。

PageSize Long 10

獲取的分頁大小,最大100。

WatchPolicyId String 300f7e67c82e42b48a197894f512343b

關注策略ID。

WatchItemIds String ["30f6XXXX","7c2eXXXX","b4a1XXXX"]

目標ID列表,JSON數組格式,一次支持操作1000個。不指定時,返回該策略下的全部目標。

返回數據

名稱 類型 示例值 描述
RequestId String 46329898-489C-4E63-9BA1-C1DA5C5D0986

請求ID。

Success Boolean true

是否調用成功。

Code String 200

響應code。

Message String OK

返回消息。

Data Object

返回數據。

TotalCount Long 32

結果總數。

PageSize Long 10

每個分頁大小。

PageNumber Long 1

當前是第幾個分頁。

Records Array of Record

節點名稱: Record。

WatchItemId String 30f6XXXX

目標ID,每個策略中唯一,不同策略可以重復。

WatchItemName String example

目標名稱。

ItemAttributes String String [ { "Key":"HairColor", "Value":["4","1"], "Score":0.81 }, { "Key":"GenderCode", "Value":["1"], "Score":0.92 }]

目標的屬性,和圖片二選一。

ItemImageUrl String http:/www.aliyun.com/file2

目標圖圖片 url,和屬性二選一。

示例

請求示例

http(s)://[Endpoint]/?Action=DescribeWatchItems
&PageNumber=1
&PageSize=10
&WatchPolicyId=300f7e67c82e42b48a197894f512343b
&WatchItemIds=["30f6XXXX","7c2eXXXX","b4a1XXXX"]
&公共請求參數

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeWatchItemsResponse>
    <RequestId>46329898-489C-4E63-9BA1-C1DA5C5D0986</RequestId>
    <Success>true</Success>
    <Code>200</Code>
    <Message>OK</Message>
    <Data>
        <TotalCount>32</TotalCount>
        <PageSize>10</PageSize>
        <PageNumber>1</PageNumber>
        <Records>
            <WatchItemId>30f6XXXX</WatchItemId>
            <WatchItemName>example</WatchItemName>
            <ItemAttributes>String	[	{  "Key":"HairColor", 	"Value":["4","1"], 	"Score":0.81	 }, 	{  "Key":"GenderCode",   "Value":["1"],   "Score":0.92 	}]</ItemAttributes>
            <ItemImageUrl>http:/www.aliyun.com/file2</ItemImageUrl>
        </Records>
    </Data>
</DescribeWatchItemsResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "46329898-489C-4E63-9BA1-C1DA5C5D0986",
  "Success" : true,
  "Code" : "200",
  "Message" : "OK",
  "Data" : {
    "TotalCount" : 32,
    "PageSize" : 10,
    "PageNumber" : 1,
    "Records" : [ {
      "WatchItemId" : "30f6XXXX",
      "WatchItemName" : "example",
      "ItemAttributes" : "String\t[\t{  \"Key\":\"HairColor\", \t\"Value\":[\"4\",\"1\"], \t\"Score\":0.81\t }, \t{  \"Key\":\"GenderCode\",   \"Value\":[\"1\"],   \"Score\":0.92 \t}]",
      "ItemImageUrl" : "http:/www.aliyun.com/file2"
    } ]
  }
}

錯誤碼

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