调用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
}