Nacos指南-服务发现:查询服务列表

API

描述

查询服务列表

请求类型

GET

请求路径

/nacos/v1/ns/service/list

请求参数

名称	类型	是否必选	描述
pageNo	int	是	当前页码
pageSize	int	是	分页大小
groupName	字符串	否	分组名
namespaceId	字符串	否	命名空间ID
selector	字符串	否	过滤表达式

错误编码

错误代码	描述	语义
400	Bad Request	客户端请求中的语法错误
403	Forbidden	没有权限
404	Not Found	无法找到资源
500	Internal Server Error	服务器内部错误
200	OK	正常

示例请求

curl -X GET '127.0.0.1:8848/nacos/v1/ns/service/list?pageNo=1&pageSize=2'

示例返回

{
    "count":148,
    "doms": [
        "nacos.test.1",
        "nacos.test.2"
    ]
}

总结

查询服务列表的时候也有个名为selector的参数，作用是可以根据服务以及实例中的元数据参数metadata进行服务过滤。这个表达式为：{“type”:“label”,“expression”:“INSTANCE.metadata.xxx = ‘xxx’”}或 {“type”:“label”,“expression”:“SERVICE.metadata.xxx = ‘xxx’”}。