查詢函數當前的可用執行個體列表。
介面說明
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"
}
]
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。