The content of this page has been automatically translated by AI. If you encounter any problems while reading, you can view the corresponding content in Chinese.

Modifying Scheduled Task Status

Last updated: 2025-04-30 15:43:33

1. API Description

api request domain name: iot.cloud.tencent.com/api/exploreropen/tokenapi. This interface (AppModifyTimerStatus) is used to modify the start-stop status of a scheduled task.

2. Input Parameters

Name
Type
Required
Description
AccessToken
String
Yes
Common parameter. AccessToken is used for user authentication of a logged-in user.
RequestId
String
Yes
Common parameter. Unique request ID can be generated manually. It is recommended to use uuid. When locating issues, you need to provide the RequestId for the request.
Action
String
Yes
Common parameter. This interface takes values AppModifyTimerStatus.
ProductId
String
Yes
The product ID of the scheduled task list needs to be modified.
DeviceName
String
Yes
The timer status or device name needs modification.
TimerId
String
Yes
Timer ID.
Status
Int
No
The timer status that needs to be modified.
0: Off.
1: Enable.

3. Output Parameters

Name
Type
Description
RequestId
String
Common parameter. Unique request ID, consistent with the input parameter. When locating issues, you need to provide the RequestId for the request.

4. Example

Input Example
POST https://iot.cloud.tencent.com/api/exploreropen/tokenapi HTTP/1.1
content-type: application/json
{
"RequestId": "req_1",
"Action": "AppModifyTimerStatus",
"ProductId": "US4*****IK",
"DeviceName": "411_3",
"TimerId":"a1c6939b39d345b897**********a12c",
"Status":0,
"AccessToken": "c1******************847e"
}
Output example: successful
{
"Response": {
"RequestId": "req_1"
}
}

5. Error Code

Error Code
Description
InternalError
Internal error.
InvalidParameterValue
Invalid parameter value.
InvalidParameterValue.InvalidAccessToken
The Token is invalid.