文档首页/ 函数工作流 FunctionGraph/ API参考/ API/ 函数调用/ 函数异步执行并返回预留实例ID(已废弃)
更新时间:2024-03-21 GMT+08:00
分享

函数异步执行并返回预留实例ID(已废弃)

功能介绍

函数异步执行并返回预留实例ID用于场景指客户端请求执行比较费时任务,不需要同步等待执行完成返回结果,该方法提前返回任务执行对应的预留实例ID, 如果预留实例有异常,可以通过该实例ID把对应实例删除(该接口主要针对白名单用户)。 目前仅支持广州和贵阳一

调用方法

请参见如何调用API

URI

POST /v2/{project_id}/fgs/functions/{function_urn}/reserved-invocations

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

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

function_urn

String

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

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

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

表3 请求Body参数

参数

是否必选

参数类型

描述

{自定义key}

Object

函数异步执行并返回预留实例请求body体。

响应参数

状态码: 202

表4 响应Header参数

参数

参数类型

描述

Content-Type

String

application/json

表5 响应Body参数

参数

参数类型

描述

instance_id

String

预留实例id

状态码: 404

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

请求示例

函数异步执行并返回预留实例ID。

POST /v2/{project_id}/fgs/functions/{function_urn}/reserved-invocations

{
  "body" : {
    "k" : "v"
  }
}

响应示例

状态码: 202

Accepted

{
  "instance_id" : "048bad9b-96ae-45ad-8f12-4061a744ef9d"
}

状态码: 404

Not Found

{
  "error_code" : "FSS.1051",
  "error_msg" : "Not found the function"
}

状态码

状态码

描述

202

Accepted

404

Not Found

错误码

请参见错误码

相关文档