修改定时任务

最近更新时间:2024-11-01 16:30:32

我的收藏

1. 接口描述

接口请求域名:iot.cloud.tencent.com/api/exploreropen/tokenapi。 本接口(AppModifyTimer)用于修改设备的定时任务。

2. 输入参数

名称
类型
必选
描述
AccessToken
String
公共参数,AccessToken 用于对一个已经登录的用户鉴权。
RequestId
String
公共参数,唯一请求 ID,可自行生成,推荐使用 uuid。定位问题时,需提供该次请求的 RequestId。
Action
String
公共参数,本接口取值 AppModifyTimer。
ProductId
String
修改定时器对应的产品 ID。
DeviceName
String
定时器对应的设备名称。
TimerName
String
定时器的名称。
TimerId
String
定时器 ID。
TimePoint
String
定时器开启时间点。
Days
String
定时器开启时间,每一位,0:关闭,1:开启,从左至右依次表示:周日、周一、周二、周三、周四、周五、周六。
Repeat
Int
是否循环。
0:不需要。
1:需要。
Data
String
定时器启动时,下发的控制报文。

3. 输出参数

名称
类型
描述
RequestId
String
公共参数,唯一请求 ID,与入参相同,定位问题时,需提供该次请求的 RequestId。

4. 示例

输入示例
POST https://iot.cloud.tencent.com/api/exploreropen/tokenapi HTTP/1.1
content-type: application/json
{
"RequestId": "req_1",
"Action": "AppModifyTimer",
"ProductId": "US*****DIK",
"DeviceName": "411_3",
"AccessToken": "c1******************847e",
"TimerId":"a1c6939b39d345b897**********a12c",
"TimerName": "timer_test_modify",
"Days": "1100000",
"TimePoint": "9:30",
"Repeat": 0,
"Data": "{\\"brightness\\": 28}"
}
输出示例:成功
{
"Response": {
"RequestId": "req_1"
}
}

5. 错误码

错误码
描述
InternalError
内部错误。
InvalidParameterValue
参数取值错误。
InvalidParameterValue.InvalidAccessToken
Token 无效。