修改定时任务

最近更新时间：2023-07-19 10:57:13

我的收藏

本页目录：

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": "US4CJ11DIK",
    "DeviceName": "411_3",
    "AccessToken": "c1******************847e",
    "TimerId":"a1c6939b39d345b897b168313f8ca12c",
    "TimerName": "timer_test_modify",
    "Days": "1100000",
    "TimePoint": "9:30",
    "Repeat": 0,
    "Data": "{\\"brightness\\": 28}"
}
输出示例：成功
{
	"Response": {
		"RequestId": "req_1"
	}
}
5. 错误码
错误码
描述
InternalError
内部错误。
InvalidParameterValue
参数取值错误。
InvalidParameterValue.InvalidAccessToken
Token 无效。
﻿

上一篇: 新建定时任务下一篇: 删除定时任务

名称	类型	必选	描述
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	是	定时器启动时，下发的控制报文。

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