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

获取函数预留实例数量

功能介绍

获取函数预留实例数量。

URI

GET /v2/{project_id}/fgs/functions/reservedinstances

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户项目 ID，获取方式请参见获取项目ID。
表2 Query参数

参数

是否必选

参数类型

描述

marker

否

String

上一次查询到的最后的记录位置。

缺省值：0

limit

否

String

每次查询获取的最大函数记录数量

最大值：400 如果不提供该值或者提供的值大于400或等于0，则使用默认值：400 如果该值小于0，则返回参数错误。

缺省值：400

urn

否

String

查询指定函数版本预留实例数的函数urn。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

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

Content-Type

是

String

消息体的类型（格式）

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

reservedinstances

Array of FuncReservedInstance objects

函数预留实例列表

page_info

PageInfo object

count

Long

函数个数
表5 FuncReservedInstance

参数

参数类型

描述

func_urn

String

函数urn

count

Long

预留实例数目
表6 PageInfo

参数

参数类型

描述

next_marker

Long

下一次读取位置

previous_marker

Long

上一次读取位置

current_count

Long

当前页总数

状态码： 400

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

状态码： 401

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

状态码： 403

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

状态码： 404

表10 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

状态码： 500

表11 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

请求示例

查询租户预留实例列表。

GET https://{Endpoint}/v2/{project_id}/fgs/functions/reservedinstances

响应示例

状态码： 200

OK

{
  "reservedinstances" : [ {
    "func_urn" : "urn:fss:xxxxx:46b6f338fc3445b8846c71dfb1fbxxxx:function:csharp:test2-0:latest",
    "count" : 2
  } ],
  "page_info" : {
    "next_marker" : 2,
    "previous_marker" : 0,
    "current_count" : 2
  }
}

状态码

状态码

描述

200

OK

400

Bad Request 请求错误。

401

Unauthorized 鉴权失败。

403

Forbidden 没有操作权限。

404

Not Found 找不到资源。

500

Internal Server Error 服务内部错误。

错误码

请参见错误码。

父主题： 函数预留实例