创建关注策略。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateWatchPolicy

系统规定参数。取值:CreateWatchPolicy

WatchPolicyName String example

策略名称,支持0~64个字符,支持中英文、数字、下划线(_)、连字符(-)。

WatchMode String NotifyIfInList

NotifyIfInList,关注模式,包括:

NotifyIfInList:出现关注目标清单中的目标,发送通知

NotifyIfNotInList:出现不在关注目标清单中的目标,发送通知

NotifyAnyway:无论是否在目标清单中,有目标出现就发送通知

TargetType String Event

关注目标的类型。

SimilarityThreshold double 0.92

仅指定目标图片时有效。关注图片的相似度阈值,支持(0.00,1)范围的小数。最大支持16位小数,相似度低于此阈值的结果不返回。

ItemMatchType String ByAttributes

指定关注WatchItemList中哪个维度的信息,可选:

ByAttributes:关注目标的属性

如果此处指定关注“属性”,而WatchItemList中存在仅配置了“图片”的目标,则此目标被忽略。

ByImage:关注目标的图片

如果此处指定关注“图片”,而WatchItemList中存在仅配置了“属性”的目标,则此目标被忽略。

返回数据

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

请求ID。

Success Boolean true

是否调用成功。

Code String 200

响应code。

Message String OK

返回消息。

Data Object

返回结果数据。

WatchPolicyId String 300f7e67c82e42b48a197894f512343b

关注策略ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateWatchPolicy
&WatchPolicyName=example
&WatchMode=NotifyIfInList
&TargetType=Event
&SimilarityThreshold=0.92
&ItemMatchType=ByAttributes
&公共请求参数

正常返回示例

XML格式

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

<CreateWatchPolicyResponse>
    <RequestId>46329898-489C-4E63-9BA1-C1DA5C5D0986</RequestId>
    <Success>true</Success>
    <Code>200</Code>
    <Message>OK</Message>
    <Data>
        <WatchPolicyId>300f7e67c82e42b48a197894f512343b</WatchPolicyId>
    </Data>
</CreateWatchPolicyResponse>

JSON格式

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

{
  "RequestId" : "46329898-489C-4E63-9BA1-C1DA5C5D0986",
  "Success" : true,
  "Code" : "200",
  "Message" : "OK",
  "Data" : {
    "WatchPolicyId" : "300f7e67c82e42b48a197894f512343b"
  }
}

错误码

访问错误中心查看更多错误码。