# 函数异步执行并返回预留实例ID（已废弃） - AsyncInvokeReservedFunction
#### 功能介绍
函数异步执行并返回预留实例ID用于场景指客户端请求执行比较费时任务，不需要同步等待执行完成返回结果，该方法提前返回任务执行对应的预留实例ID， 如果预留实例有异常，可以通过该实例ID把对应实例删除（该接口主要针对白名单用户）。 目前仅支持广州。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-functiongraph/functiongraph_06_0200.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-functiongraph/functiongraph_06_1100.html)。
#### URI
POST /v2/{project_id}/fgs/functions/{function_urn}/reserved-invocations
表1路径参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                     |
|:---|:---|:---|:---|
| project_id   | 是    | String | 租户项目 ID，获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-functiongraph/functiongraph_06_0260.html)。 |
| 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 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-functiongraph/ErrorCode.html)。