天翼云智能视图服务API

1.更新AI应用

接口功能介绍

本接口用于更新AI应用。

接口约束

无

URI

PUT /ai/apps/{AppId}

路径参数

参数	是否必填	参数类型	说明	示例	下级对象
AppId	是	Integer	应用ID。	586

Query参数
无

请求参数

请求头header参数

参数	是否必填	参数类型	说明	示例
Authorization	是	String	认证信息。	CT-HMAC-SHA256 Credential=FQ01GA2RR9IJFM1PWIPR/2023-07-18/vss, SignedHeaders=content-type;host;timestamp, Signature=c6e72dffcfb2d25d276e119781e1deb6656d966702191b2bd862d1691e39394f
Content-Type	是	String	互联网媒体类型。	application/json;charset=utf-8
Host	是	String	主机。	vssapi.ctyun.cn
Version	是	String	版本。	2021-11-25
Timestamp	是	String	时间戳。	1689643309

请求体body参数

参数	是否必填	参数类型	说明	示例	下级对象
AnalyseType	否	String	分析频率，分钟级AI-100，秒级AI-200。	AI-100
AppName	否	String	应用名称，长度为1~10个字符。	testApp
Confidence	否	Double	置信度，取值范围为0~1。	0.6
AlgorithmMetadata	否	Object	算法的自定义配置项，具体可参考表AlgorithmMetadata的参数说明。		AlgorithmMetadata
OperTimeSlot	否	Array of Objects	AI应用生效时间段，最多包含五组时间段。默认为全天（00:00:00-23:59:59）。		OperTimeSlot
AlertConfig	否	Object	告警配置。		AlertConfig
Description	否	String	应用描述，长度为1~255个字符。	应用描述

表 AlgorithmMetadata

参数	是否必填	参数类型	说明	示例
FaceDbName	否	String	人脸库ID。当AI算法类型为入侵检测或人脸识别时，该字段必选。	1080062
HelmetReflectiveType	否	Array of Strings	安全帽反光服检测（helmet:未带安全帽告警，reflective:未穿反光服报警），当AI算法类型为安全帽反光服检时，该字段必选。	["helmet","reflective"]
PedThreshold	否	String	行人检测（人员数量阈值），当AI算法类型为行人检测时，该字段必选。	22
VehiclesThreshold	否	String	车辆数量阈值，当AI算法类型为车辆统计时，该字段必选。	10
PvTime	否	String	车辆违停检测（临停时间），当AI算法类型为车辆违停检测时，该字段必选。	22
JamThreshold	否	String	车辆拥堵检测（拥堵车辆阈值），当AI算法类型为车辆拥堵检测，该字段必选。	56
CrowdThreShold	否	String	人群感应检测（人员数量阈值），当AI算法类型为人群感应检测时，该字段必选。	21
OffDutyThreShold	否	String	实时在岗检测（人脱岗超时时间），当AI算法类型为实时在岗检测时，该字段必选。	14
SleepOnDutyThreShold	否	String	实时在岗检测（睡岗超时时间），当AI算法类型为实时在岗检测时，该字段必选。	12
CityGovType	否	Array of Strings	城市治理-（店外经营，游摊小贩，占道经营乱堆物料，户外广告，打包垃圾，暴露垃圾，沿街晾晒，违规撑伞，地桩地锁，绿化损坏，道路破损，垃圾箱未加盖，垃圾箱满溢，气拱门，横幅识别，井盖异常），当AI算法类型为城市治理时，该字段必选。	["dianwai","youtan","zhandao","wuliao","guanggao","dabaolaji","baolulaji","liangshai","chengsan","disuo","lvhuasunhuai","daoluposun","weijiagai","manyi","qimogongmeng","banner","cover"]

表 OperTimeSlot

参数	是否必填	参数类型	说明	示例	下级对象
StartTime	否	String	开始时间。格式为"hh:mm:ss"，且StartTime必须小于EndTime。默认值为"00:00:00"。	08:40:00
EndTime	否	String	结束时间。格式为"hh:mm:ss"，且StartTime必须小于EndTime。默认值为"23:59:59"。	09:40:00

表 AlertConfig

参数	是否必填	参数类型	说明	示例
AlertPeriod	否	String	告警周期，检测告警信息的时间区段，默认0秒。	30
AlertTriggerThreshold	否	String	告警数量阈值，检测告警信息的数量阈值，默认1个。	5
AlertSilencePeriod	否	String	静默时间。静默时间内，不产生任何的AI告警信息，告警周期内触发告警之后即进入静默期，待达到静默时间之后，重新进行新一轮的告警判断，默认3秒。	10

响应参数

参数	是否必填	参数类型	说明	示例	下级对象
statusCode	是	Integer	响应状态码。	200
error	String	错误码，执行成功时，不返回该字段。	VSS_0001。
message	是	String	响应信息。	请求成功
requestId	是	String	请求ID。	362d4e78556b47129182d0881fade86b
returnObj	是	Object	响应数据。		returnObj

表 returnObj

参数	参数类型	说明	示例	下级对象
RequestId	String	请求ID。	362d4e78556b47129182d0881fade86b
AppId	String	AI应用ID。	32388487739092996

请求示例

请求url

PUT '/ai/app/588'

请求头header

{
    "Authorization": "CT-HMAC-SHA256 Credential=FQ01GA2RR9IJFM1PWIPR/2023-07-18/vss, SignedHeaders=content-type;host;timestamp, Signature=c6e72dffcfb2d25d276e119781e1deb6656d966702191b2bd862d1691e39394f",
    "Content-Type": "application/json;charset=utf-8",
    "Host": "vssapi.ctyun.cn",
    "Version": "2021-11-25",
    "Timestamp": "1689643309"
}

请求体body

{
    "Name":"1113",
    "AnalyseType":"AI-100",
    "Confidence":0.8,
    "AlgorithmsId":2,
    "AlgorithmMetadata":"{}"
}

响应示例

{
    "statusCode": 200,
    "message": "请求成功",
    "requestId": "17d7d17cedb947059f368003b9d04007",
    "returnObj": {
        "RequestId": "17d7d17cedb947059f368003b9d04007",
        "AppId": "588"
    }
}

状态码

请参考状态码说明。

错误码

请参考错误码说明。

更新AI应用

最近更新时间：2026-03-19 18:16:28

天翼云智能视图服务API

1.更新AI应用

接口功能介绍

接口约束

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码