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

最新推荐文章于 2025-05-14 16:31:37 发布

原创最新推荐文章于 2025-05-14 16:31:37 发布 · 1.2w 阅读

14 ·

本内容遵循CC 4.0 BY-SA版权协议

收录于

Nacos

当前文章被收录于：

Nacos

13 篇文章 4 人学习

动态服务发现、配置管理和服务管理平台

订阅专栏查看详情

当前文章被以下社区和专栏收录：

查询服务列表

API
- 总结

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’”}。

在这里插入图片描述