文档首页> 函数工作流 FunctionGraph> API参考（吉隆坡区域）> API> 函数调用> 函数异步执行并返回预留实例ID（已废弃）
更新时间：2023-07-06 GMT+08:00
查看PDF

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

功能介绍

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

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

{
  "application/json" : {
    "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

错误码

请参见错误码。

父主题： 函数调用