文档首页/ 函数工作流 FunctionGraph/ API参考/ API/ 函数异步配置/ 获取函数异步调用请求列表
更新时间:2024-03-14 GMT+08:00

获取函数异步调用请求列表

功能介绍

获取函数异步调用请求列表

URI

GET /v2/{project_id}/fgs/functions/{function_urn}/async-invocations

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户项目 ID,获取方式请参见获取项目ID

function_urn

String

函数的URN,详细解释见FunctionGraph函数模型的描述。

表2 Query参数

参数

是否必选

参数类型

描述

request_id

String

需要查询的异步请求ID。如果不指定,默认查询所有异步调用记录

最小长度:0

最大长度:64

marker

String

本次查询起始位置,默认值0

缺省值:0

最小长度:0

最大长度:64

limit

String

本次查询最大返回的数据条数,最大值500,默认值100

缺省值:100

最小长度:0

最大长度:64

status

String

本次查询指定的异步调用状态,支持5种状态,如果不指定,则查询所有状态的调用记录 WAIT: 等待 RUNNING: 执行中 SUCCESS: 执行成功 FAIL: 执行失败 DISCARD: 请求丢弃

最小长度:0

最大长度:64

query_begin_time

String

搜索起始时间(格式为YYYY-MM-DD'T'HH:mm:ss,UTC时间)。如果不指定默认为当前时间前1小时

query_end_time

String

搜索结束时间(格式为YYYY-MM-DD'T'HH:mm:ss,UTC时间)。如果不指定默认为当前时间

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

Content-Type

String

消息体的类型(格式)

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

invocations

Array of ListFunctionAsyncInvocationsResult objects

异步调用记录列表。

count

Integer

查询数据总条数

next_marker

Integer

查询下一页的起始位置

表5 ListFunctionAsyncInvocationsResult

参数

参数类型

描述

request_id

String

异步调用请求ID

status

String

异步调用状态,支持5种状态 WAIT: 等待 RUNNING: 执行中 SUCCESS: 执行成功 FAIL: 执行失败 DISCARD: 请求丢弃

枚举值:

  • WAIT

  • RUNNING

  • SUCCESS

  • FAIL

  • DISCARD

error_message

String

异步调用错误信息,如果执行成功,则返回空

error_code

Integer

异步调用错误码,如果执行成功,则返回0

start_time

String

异步调用开始时间(格式为YYYY-MM-DD'T'HH:mm:ss,UTC时间)。

end_time

String

异步调用结束时间(格式为YYYY-MM-DD'T'HH:mm:ss,UTC时间)。

状态码: 403

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

状态码: 404

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

状态码: 500

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

请求示例

获取函数异步调用请求列表。

GET /v2/{project_id}/fgs/functions/{function_urn}/async-invocations

响应示例

状态码: 200

OK

{
  "invocations" : [ {
    "request_id" : "403fcbd6-ec41-401f-9fa7-386f3d3d****",
    "status" : "SUCCESS",
    "error_message" : "",
    "start_time" : "2019-10-25T15:37:27",
    "end_time" : "2019-10-25T15:37:27",
    "error_code" : 0
  } ]
}

状态码: 403

FORBIDDEN

{
  "error_code" : "FSS.0403",
  "error_msg" : "invalid token"
}

状态码: 404

Not Found

{
  "error_code" : "FSS.0404",
  "error_msg" : "can not find function"
}

状态码: 500

内部错误

{
  "error_code" : "FSS.0500",
  "error_msg" : "xxx"
}

状态码

状态码

描述

200

OK

403

FORBIDDEN

404

Not Found

500

内部错误

错误码

请参见错误码