调用GetStatefulAsyncInvocation接口获取符合条件的异步任务记录。

StatefulAsyncInvocation:异步任务。异步任务在普通的异步调用基础上增加了状态管理的功能,更适用于各类任务场景。

请求头

该接口无特殊请求头,关于公共请求头信息,请参见公共参数

请求语法

GET /services/{serviceName[.qualifier]}/functions/{functionName}/stateful-async-invocations/{statefulAsyncInvocationId} HTTP/1.1

请求参数

名称 类型 位置 是否必选 示例值 描述
serviceName String Path service_name

异步任务所属的服务的名称。

functionName String Path function_name

异步任务所属的函数的名称。

qualifier String Path alias

异步任务所属的服务的别名或版本。

statefulAsyncInvocationId String Path e026ae92-61e5-472f-b32d-1c9e3c4e****

异步任务的ID。

说明 建议您在使用SDK调用时设置与业务相关的ID,方便对相关执行进行后续操作。例如,一个视频处理函数可以使用视频文件名作为调用ID,通过该ID可以查看视频是否处理完成或终止视频的处理。该ID的命名规则只能以英文大小写字母或下划线(_)开头,由英文大小写字母、数字(0-9)、下划线(_)及短划线(-)组成,不超过128个字符。如果您未设置异步调用的ID时,系统则会自动生成一个ID。

返回数据

名称 类型 示例值 描述
startedTime Long 2020-08-20T02:28:21Z

异步任务的开始时间。

endTime Long 2020-08-20T02:38:21Z

异步任务的结束时间。

functionName String function_name

异步任务所属的函数名称。

qualifier String alias

异步任务所属的服务的别名或版本。

serviceName String service_name

异步任务所属的服务名称。

invocationId String e026ae92-61e5-472f-b32d-1c9e3c4e****

异步任务的任务ID。

requestId String 403fcbd6-ec41-401f-9fa7-386f3d3d****

异步任务的请求ID。

status String Succeeded

异步任务的执行状态。

  • Enqueued:异步消息已入队,等待处理。
  • Dequeued:异步消息已出队,等待触发。
  • Running:调用执行中。
  • Succeeded:调用执行成功。
  • Failed:调用执行失败。
  • Stopped:调用执行终止。
  • Stopping:执行停止中。
  • Expired:您给异步消息配置了存活有效期,该消息因过期已被丢弃(未触发)。
  • Invalid:您的执行因函数被删除等原因处于无效状态(未触发)。
  • Retrying:异步调用因执行错误重试中。
destinationStatus String Succeeded

本次异步任务的目的状态。

invocationErrorMessage String UnhandledException

异步任务调用失败的错误消息。

InvocationPayload String hello world

异步任务调用的输入。

alreadyRetriedTimes Long 3

本次异步任务失败后的最大重试次数,默认值为3。取值范围[0,8]。

示例

请求示例

GET /2016-08-15/services/{serviceName[.qualifier]}/functions/function_name/stateful-async-invocations/e026ae92-61e5-472f-b32d-1c9e3c4e**** HTTP/1.1
公共请求头

正常返回示例

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "functionName" : "function_name",
  "qualifier" : "alias",
  "serviceName" : "service_name",
  "invocationId" : "e026ae92-61e5-472f-b32d-1c9e3c4e****",
  "requestId" : "403fcbd6-ec41-401f-9fa7-386f3d3d****",
  "status" : "Succeeded",
  "destinationStatus" : "Succeeded",
  "invocationErrorMessage" : "UnhandledException",
  "InvocationPayload" : "function_name",
  "alreadyRetriedTimes" : 3
}