You need to enable JavaScript to run this app.
Volcano Engine Function as a Service

Volcano Engine Function as a Service

Copy page
Download PDF
Timer trigger
UpdateTimer
Copy page
Download PDF
UpdateTimer
Call the UpdateTimer interface to update the configuration of Timer trigger.​
Request description​
  • Request method: POST​
  • Request address: http://open.volcengineapi.com/?Action=UpdateTimer&Version=2024-06-06​
Debugging​
API Explorer
You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.
​
Request parameter​
​
Parameter​
Type​
Required or Not​
Sample value​
Description​
Action​
String​
Yes​
UpdateTimer​
Interface name. The current API is called UpdateTimer.​
Version​
String​
Yes​
2024-06-06​
Interface version. The current version of the API is 2024-06-06.​
FunctionId​
String​
Yes​
wr******​
The ID of the function to which the Timer trigger belongs.​
Id​
String​
Yes​
nw******​
Timer Trigger ID.​
Description​
String​
No​
Timer trigger​
The remarks information for the Timer trigger.​
Enabled​
Boolean​
No​
true​
Whether the Timer trigger is enabled or not.​
  • true: Enabled​
  • false: Turned off.​
Crontab​
String​
No​
*/5 * * * *​
Timer trigger trigger time. The time format is crontab expression, and you can access crontab.guru to view the meanings of crontab expression.​
Payload​
String​
No​
​
The Timer trigger sends requested payload, that is, a trigger message.​
EnableConcurrency​
Boolean​
No​
false​
Whether the Timer trigger allows concurrency.​
  • true: allows concurrency​
  • false: concurrency is prohibited.​
Retries​
Integer​
No​
0​
The number of retries for the Timer trigger.​
​
Sample request​
​
POST http://open.volcengineapi.com/?Action=UpdateTimer&Version=2024-06-06 HTTP/1.1​
Content-Type: application/json​
{​
"FunctionId": "qt ******",​
"Id": "in ******",​
"Description": "Timer Trigger",​
"Enabled": false,​
"Crontab": "*/5 * * * *",​
"EnableConcurrency": true​
}​
​
Response parameter​
​
Parameter​
Type​
Sample value​
Description​
FunctionId​
String​
wr******​
Function ID.​
Id​
String​
nw******​
Timer trigger ID.​
Name​
String​
doc-timer​
Timer trigger name.​
Description​
String​
Timer Trigger​
The remarks information for the Timer trigger.​
Enabled​
Boolean​
true​
Whether the Timer trigger has been turned on. true indicates it is turned on.​
Crontab​
String​
*/5 * * * *​
The execution time of Trimer trigger, in the format crontab expression.​
Payload​
String​
​
The Timer trigger sends requested payload, that is, a trigger message.​
CreationTime​
String​
2024-06-14 15:31:07.143863441 +0800 CST m=+88714.902440864​
Timer trigger creation time.​
LastUpdateTime​
String​
2024-06-14 15:31:07.143863441 +0800 CST m=+88714.902440864​
Timer trigger update time.​
EnableConcurrency​
Boolean​
true​
Whether the Timer trigger allows concurrency. true indicates it allows concurrency.​
Retries​
Integer​
0​
The number of retries for the Timer trigger.​
​
Sample response​
​
HTTP/1.1 200 OK​
Content-Type: application/json​
{​
"ResponseMetadata": {​
"RequestId": "202411291622408A1DCA972BE**",​
"Action": "UpdateTimer",​
"Version": "2024-06-06",​
"Service": "vefaas",​
"Region": "cn-Beijing"​
},​
"Result": {​
"FunctionId": "qt ******",​
"Id": "in ******",​
"Name": "doc-timer",​
"Description": "Timer Trigger",​
"Enabled": false,​
"Crontab": "*/5 * * * *",​
"Payload": "",​
"CreationTime": "2024-11-29 08:16:31.54 + 0000 UTC",​
"LastUpdateTime": "2024-11-29 16:22:40.412373364 + 0800 CST m =+ 66137.231040950",​
"EnableConcurrency": true,​
"Retries": 0​
}​
}​
​
Error code​
The current interface temporarily has no independent error code. If the interface calls back abnormally, you can refer to the Public error code to troubleshoot.​
Last updated: 2025.06.30 11:37:44