GetTimer--函数服务-火山引擎

文档中心

立即注册

导航

GetTimer

最近更新时间：2024.11.29 17:12:07首次发布时间：2024.11.29 17:12:07

调用 GetTimer 接口，获取 Timer 触发器的详细信息。

请求说明

请求方式：POST
请求地址：http://open.volcengineapi.com/?Action=GetTimer&Version=2024-06-06

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

参数	类型	是否必选	示例值	描述
Action	String	是	GetTimer	接口名称。当前 API 的名称为 `GetTimer`。
Version	String	是	2024-06-06	接口版本。当前 API 的版本为 `2024-06-06`。
FunctionId	String	是	wrwskd**	Timer触发器所属函数 ID。
Id	String	是	nwwz**	Timer 触发器 ID。

请求示例

POST http://open.volcengineapi.com/?Action=GetTimer&Version=2024-06-06 HTTP/1.1
Content-Type: application/json
{
    "FunctionId": "wrwskd**",
    "Id": "nwwz**"
}

返回参数

参数	类型	示例值	描述
FunctionId	String	wrwsk**	函数 ID。
Id	String	nwwzo**	Timer 触发器 ID。
Name	String	doc-timer	Timer 触发器名字。
Description	String	Timer触发器	Timer 触发器的备注信息。
Enabled	Boolean	true	Timer 触发器是否开启用，`true`表示启用。
Crontab	String	`/5 * * *`	Timer 触发器的触发时间，格式为 crontab 表达式。
Payload	String	`{"body": "update event payload"}`	Timer 触发器发送请求的 payload，即触发消息。
CreationTime	String	2024-06-14 15:31:07.143863441 +0800 CST m=+88714.902440864	Timer 触发器创建时间。
LastUpdateTime	String	2024-06-14 15:31:07.143863441 +0800 CST m=+88714.902440864	Timer 触发器更新时间。
EnableConcurrency	Boolean	true	Timer 触发器是否允许并发，`true`表示允许并发。
Retries	Integer	0	Timer 触发器的重试次数。

返回示例

HTTP/1.1 200 OK
Content-Type: application/json
{
    "ResponseMetadata": {
        "RequestId": "2024112916192814CC1E0FD73**",
        "Action": "GetTimer",
        "Version": "2024-06-06",
        "Service": "vefaas",
        "Region": "cn-beijing"
    },
    "Result": {
        "FunctionId": "qtqz**",
        "Id": "ing3qa**",
        "Name": "doc-timer",
        "Description": "Timer触发器",
        "Enabled": true,
        "Crontab": "*/5 * * * *",
        "Payload": "",
        "CreationTime": "2024-11-29 08:16:31.54 +0000 UTC",
        "LastUpdateTime": "2024-11-29 08:16:31.54 +0000 UTC",
        "EnableConcurrency": false,
        "Retries": 0
    }
}

错误码

当前接口暂无独立错误码，若接口调用返回异常，可参考公共错误码进行故障排查。