Nacos API

监听配置

POST

/nacos/v1/cs/configs/listener

监听 Nacos 上的配置，以便实时感知配置变更。如果配置变更，则用获取配置接口获取配置的最新值，动态刷新本地缓存。

注册监听采用的是异步 Servlet 技术。注册监听本质就是带着配置和配置值的 MD5 值和后台对比。如果 MD5 值不一致，就立即返回不一致的配置。如果值一致，就等待住 30 秒。返回值为空。

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://127.0.0.1:8848/nacos/v1/cs/configs/listener?Listening-Configs=' \
--header 'Long-Pulling-Timeout: 30000'

Response Example

dataId%02group%02tenant%01

Request

Query Params

Listening-Configs

string

required

监听数据报文。格式为 dataId^2Group^2contentMD5^2tenant^1或者dataId^2Group^2contentMD5^1。 dataId：配置 ID group：配置分组 contentMD5：配置内容 MD5 值 tenant：租户信息，对应 Nacos 的命名空间字段(非必填)配置多个字段间分隔符：^2 = Character.toString((char) 2，urlencode 后值为 %02 配置间分隔符：^1 = Character.toString((char) 1)，urlencode 后值为 %01 contentMD5: MD5(content)，第一次本地缓存为空，所以这块为空串

Header Params

Long-Pulling-Timeout

string

required

长轮训等待 30s，此处填写 30000。

Example:

30000

Responses

🟢200成功

text/plain

Body

string

optional

获取配置

发布配置