查詢Nacos服務執行個體列表。
介面說明
當前的 OpenAPI 並非是 Nacos-SDK API，Nacos-SDK API 相關內容，請參見官方文檔。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
mse:ListAnsInstances |
list |
*全部資源
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| RequestPars |
string |
否 |
擴充請求參數，JSON 格式。 |
{} |
| PageNum |
integer |
是 |
頁碼。 |
1 |
| PageSize |
integer |
是 |
每頁展示執行個體數。 |
10 |
ClusterId
deprecated
|
string |
否 |
叢集 ID。 重要 此介面同時有 InstanceId 與 ClusterId，則其中一項必填。 |
mse-09k1q11**** |
| ServiceName |
string |
是 |
服務名稱。 |
name |
| GroupName |
string |
否 |
連絡人群組名稱。 |
test |
| NamespaceId |
string |
否 |
命名空間 ID。 |
12233**** |
| ClusterName |
string |
否 |
叢集別名。 |
DEFAULT |
| InstanceId |
string |
否 |
執行個體 ID。 重要 此介面同時有 InstanceId 與 ClusterId，則其中一項必填。 |
mse_prepaid_public_cn-tl327w**** |
| AcceptLanguage |
string |
否 |
返回資訊的語言類型：
|
zh |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| HttpCode |
string |
HTTP 狀態代碼。 |
202 |
| TotalCount |
integer |
執行個體總數。 |
7 |
| RequestId |
string |
請求 ID。 |
52BA6DA6-A702-4362-A32F-DFF79655**** |
| Message |
string |
資訊。 |
請求處理成功 |
| PageSize |
integer |
每頁展示執行個體數。 |
10 |
| PageNumber |
integer |
頁碼。 |
1 |
| Data |
array<object> |
資料概覽。 |
|
|
array<object> |
|||
| DefaultKey |
string |
預設鍵。 |
30.5.XX.XX:unknown |
| Ephemeral |
boolean |
臨時節點，取值如下：
|
true |
| Marked |
boolean |
標記，取值如下：
|
true |
| Ip |
string |
公網 IP。 |
30.5.XX.XX |
| InstanceId |
string |
執行個體 ID。 |
30.5.XX.XX#0#DEFAULT#DEFAULT_GROUP@@consumers:com.alibaba.edas.IHelloService |
| Port |
integer |
連接埠號碼 |
8080 |
| LastBeat |
integer |
最近一次的心跳時間。 |
20201010 |
| OkCount |
integer |
成功計數。 |
0 |
| Weight |
integer |
權重。 |
1 |
| InstanceHeartBeatInterval |
integer |
執行個體心跳間隔，單位：秒。 |
5000 |
| IpDeleteTimeout |
integer |
IP 刪除逾時。 |
30000 |
| App |
string |
應用程式名稱。 |
app |
| FailCount |
integer |
失敗計數。 |
0 |
| Healthy |
boolean |
執行個體健康狀態，取值如下：
|
true |
| Enabled |
boolean |
生效狀態，取值如下：
|
true |
| DatumKey |
string |
基準鍵。 |
30.5.XX.XX:unknown:DEFAULT |
| ClusterName |
string |
叢集名稱。 |
DEFAULT |
| InstanceHeartBeatTimeOut |
integer |
執行個體心跳逾時。 |
15000 |
| ServiceName |
string |
服務名稱。 |
DEFAULT_GROUP@@consumers:com.alibaba.edas.IHelloService:: |
| Metadata |
object |
中繼資料。 |
[int] |
| ErrorCode |
string |
錯誤碼。 |
mse-100-000 |
| Success |
boolean |
請求結果，取值如下：
|
true |
樣本
正常返回樣本
JSON格式
{
"HttpCode": "202",
"TotalCount": 7,
"RequestId": "52BA6DA6-A702-4362-A32F-DFF79655****",
"Message": "請求處理成功",
"PageSize": 10,
"PageNumber": 1,
"Data": [
{
"DefaultKey": "30.5.XX.XX:unknown",
"Ephemeral": true,
"Marked": true,
"Ip": "30.5.XX.XX",
"InstanceId": "30.5.XX.XX#0#DEFAULT#DEFAULT_GROUP@@consumers:com.alibaba.edas.IHelloService",
"Port": 8080,
"LastBeat": 20201010,
"OkCount": 0,
"Weight": 1,
"InstanceHeartBeatInterval": 5000,
"IpDeleteTimeout": 30000,
"App": "app",
"FailCount": 0,
"Healthy": true,
"Enabled": true,
"DatumKey": "30.5.XX.XX:unknown:DEFAULT",
"ClusterName": "DEFAULT",
"InstanceHeartBeatTimeOut": 15000,
"ServiceName": "DEFAULT_GROUP@@consumers:com.alibaba.edas.IHelloService::",
"Metadata": {
"test": "test",
"test2": 1
}
}
],
"ErrorCode": "mse-100-000",
"Success": true
}錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | IllegalRequest | Invalid request:%s | 非法請求： %s |
| 400 | InvalidParameter | Parameter error:%s | 請求參數錯誤：%s |
| 500 | InternalError | Console error. Try again later:%s | 控制台錯誤.稍後重試：%s |
| 403 | NoPermission | You are not authorized to perform this operation:%s | 沒有許可權使用此介面：%s |
| 404 | NotFound | Not found:%s | 資源不存在：%s |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。