文档首页/函数工作流 FunctionGraph/API参考/API/函数预留实例/修改函数预留实例数量
更新时间：2025-08-29 GMT+08:00
在线调试
CLI示例
查看PDF
分享

修改函数预留实例数量

功能介绍

修改函数预留实例数量。

URI

PUT /v2/{project_id}/fgs/functions/{function_urn}/reservedinstances

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

function_urn

是

String

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

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

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

Content-Type

是

String

消息体的类型（格式）

表3 请求Body参数

参数

是否必选

参数类型

描述

count

是

Integer

预留实例个数

idle_mode

否

Boolean

是否开启闲置模式配置

tactics_config

否

TacticsConfig object

预留实例策略配置

表4 TacticsConfig

参数

是否必选

参数类型

描述

cron_configs

否

Array of CronConfig objects

定时配置列表

metric_configs

否

Array of MetricConfig objects

流量配置列表

表5 CronConfig

参数

是否必选

参数类型

描述

name

否

String

定时配置名称

cron

否

String

定时表达式

count

否

Integer

拉起预留实例个数

start_time

否

Long

开始时间戳（epoch时间戳格式）

expired_time

否

Long

失效时间戳（epoch时间戳格式）

表6 MetricConfig

参数

是否必选

参数类型

描述

name

否

String

流量配置名称

type

否

String

流量配置类型，当前只支持预留实例使用率一种类型

枚举值：

  • Concurrency

threshold

否

Integer

流量阈值

min

否

Integer

流量最小值

响应参数

状态码： 200

表7 响应Body参数

参数

参数类型

描述

count

Integer

预留实例个数

idle_mode

Boolean

是否开启闲置模式配置

tactics_config

TacticsConfig object

预留实例策略配置

表8 TacticsConfig

参数

参数类型

描述

cron_configs

Array of CronConfig objects

定时配置列表

metric_configs

Array of MetricConfig objects

流量配置列表

表9 CronConfig

参数

参数类型

描述

name

String

定时配置名称

cron

String

定时表达式

count

Integer

拉起预留实例个数

start_time

Long

开始时间戳（epoch时间戳格式）

expired_time

Long

失效时间戳（epoch时间戳格式）

表10 MetricConfig

参数

参数类型

描述

name

String

流量配置名称

type

String

流量配置类型，当前只支持预留实例使用率一种类型

枚举值：

  • Concurrency

threshold

Integer

流量阈值

min

Integer

流量最小值

状态码： 400

表11 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

状态码： 401

表12 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

状态码： 403

表13 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

状态码： 404

表14 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

状态码： 500

表15 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

请求示例

将函数预留实例数量更新为3。

PUT https://{Endpoint}/v2/{project_id}/fgs/functions/{function_urn}/reservedinstances

{
  "count" : 3
}

响应示例

状态码： 200

OK

{
  "count" : 2
}

状态码

状态码

描述

200

OK

400

Bad Request 请求错误。

401

Unauthorized 鉴权失败。

403

Forbidden 没有操作权限。

404

Not Found 找不到资源。

500

Internal Server Error 服务内部错误。

错误码

请参见错误码。

父主题：函数预留实例