查询函数当前的可用实例列表。
接口说明
ListInstances 接口提供了查询函数当前可用实例的能力。
可用实例是指正在执行请求，或者可被调度以处理请求的实例。ListInstances 接口查询得到的实例与具有相同
ServiceName、FunctionName和Qualifier的 InvokeFunction 接口流量链路下的活跃实例保持一致。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
fc:ListInstances |
get |
*全部资源
|
无 | 无 |
请求语法
GET /2021-04-06/services/{serviceName}/functions/{functionName}/instances HTTP/1.1路径参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| serviceName |
string |
是 |
服务的名称。 |
demoService |
| functionName |
string |
是 |
函数的名称。 |
demoFunction |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| qualifier |
string |
否 |
版本或者别名。 |
dev |
| instanceIds |
array |
否 |
实例 ID。 |
|
|
string |
否 |
实例 ID。 |
["1ef6b6ff-7f7b-485e-ab49-501ac681****", "04db0821-c6d2-4c10-970b-93e36f1a****"] |
|
| limit |
integer |
否 |
限定此次返回资源的数量，取值范围[0,1000]。 返回结果可以小于指定的数量，但不能多于指定的数量。 |
20 |
| X-Fc-Account-Id |
string |
否 |
您的阿里云账号（主账号）ID。 |
188077086902**** |
| X-Fc-Date |
string |
否 |
||
| X-Fc-Trace-Id |
string |
否 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
查询返回的实例信息列表。 |
||
| instances |
array<object> |
查询返回的实例信息列表。 |
|
|
object |
实例信息。 |
||
| instanceId |
string |
实例 ID。 |
1ef6b6ff-7f7b-485e-ab49-501ac681**** |
| versionId |
string |
实例所属的服务版本。如果是 LATEST 别名下的函数实例，则返回版本号为 0。 |
1 |
示例
正常返回示例
JSON格式
{
"instances": [
{
"instanceId": "1ef6b6ff-7f7b-485e-ab49-501ac681****",
"versionId": "1"
}
]
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。