nacos–扩展–2.2–OpenApi–服务发现
1、注册实例
1.1、接口说明
1.2、案例
[hd@zhoufei ~]$ curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?port=8848&healthy=false&ip=11.11.11.11&weight=1.0&serviceName=nacos.test.1&encoding=GBK&namespaceId=n1' -w '\n'
ok
2、注销实例
2.1、接口说明
2.2、案例
[hd@zhoufei ~]$ curl -X DELETE '127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.test.1&ip=1.1.1.1&port=8888&clusterName=TEST1' -w '\n'
ok
[hd@zhoufei ~]$
3、修改实例
3.1、接口说明
3.2、案例
[hd@zhoufei ~]$ curl -X PUT 'http://127.0.0.1:8848/nacos/v1/ns/instance?port=8848&serviceName=nacos.test.1&ip=11.11.11.11&namespaceId=n1' -w '\n'
ok
4、查询实例详情
4.1、接口说明
4.2、案例
[hd@zhoufei ~]$ curl -X GET '127.0.0.1:8848/nacos/v1/ns/instance?port=8848&healthy=false&ip=11.11.11.11&weight=1.0&serviceName=nacos.test.1&encoding=GBK&namespaceId=n1' -w '\n'
{
"service": "DEFAULT_GROUP@@nacos.test.1",
"ip": "11.11.11.11",
"port": 8848,
"clusterName": "DEFAULT",
"weight": 1,
"healthy": false,
"instanceId": "11.11.11.11#8848#DEFAULT#DEFAULT_GROUP@@nacos.test.1",
"metadata": {}
}
5、发送实例心跳
5.1、接口说明
5.2、案例
[hd@zhoufei ~]$ curl -X PUT '127.0.0.1:8848/nacos/v1/ns/instance/beat?serviceName=nacos.test.1&beat={"cluster":"c1","ip":"127.0.0.1","metadata":{},"port":8080,"scheduled":true,"serviceName":"jinhan0Fx4s.173TL.net","weight":1}' -w '\n'
ok
6、创建服务
6.1、接口说明
6.2、案例
[hd@zhoufei ~]$ curl -X POST '127.0.0.1:8848/nacos/v1/ns/service?serviceName=nacos.test.2&metadata=k1=v1' -w '\n'
ok
7、删除服务
7.1、接口说明
7.2、案例
[hd@zhoufei ~]$ curl -X DELETE '127.0.0.1:8848/nacos/v1/ns/service?serviceName=nacos.test.2' -w '\n'
ok
8、修改服务
8.1、接口说明
8.2、案例
[hd@zhoufei ~]$ curl -X PUT '127.0.0.1:8848/nacos/v1/ns/service?serviceName=nacos.test.2&metadata=k1=v2&protectThreshold=1000' -w '\n'
ok
9、查询服务
9.1、接口说明
9.2、案例
[root@zhoufei ~]# curl -X GET '127.0.0.1:8848/nacos/v1/ns/service?serviceName=nacos.test.2' -w '\n'
{
"namespaceId": "public",
"groupName": "DEFAULT_GROUP",
"name": "nacos.test.2",
"protectThreshold": 0,
"metadata": {
"k1": "v1"
},
"selector": {
"type": "none",
"contextType": "NONE"
},
"clusters": []
}
10、查询服务列表
10.1、接口说明
10.2、案例
[root@zhoufei ~]# curl -X GET '127.0.0.1:8848/nacos/v1/ns/service/list?pageNo=1&pageSize=2' -w '\n'
{
"count": 1,
"doms": [
"nacos.test.2"
]
}
11、查询系统开关
11.1、接口说明
11.2、案例
[root@zhoufei ~]# curl -X GET '127.0.0.1:8848/nacos/v1/ns/operator/switches' -w '\n'
{
"masters": null,
"adWeightMap": {},
"defaultPushCacheMillis": 10000,
"clientBeatInterval": 5000,
"defaultCacheMillis": 3000,
"distroThreshold": 0.7,
"healthCheckEnabled": true,
"autoChangeHealthCheckEnabled": true,
"distroEnabled": true,
"enableStandalone": true,
"pushEnabled": true,
"checkTimes": 3,
"httpHealthParams": {
"max": 5000,
"min": 500,
"factor": 0.85
},
"tcpHealthParams": {
"max": 5000,
"min": 1000,
"factor": 0.75
},
"mysqlHealthParams": {
"max": 3000,
"min": 2000,
"factor": 0.65
},
"incrementalList": [],
"serverStatusSynchronizationPeriodMillis": 2000,
"serviceStatusSynchronizationPeriodMillis": 5000,
"disableAddIP": false,
"sendBeatOnly": false,
"lightBeatEnabled": true,
"doubleWriteEnabled": false,
"limitedUrlMap": {},
"distroServerExpiredMillis": 10000,
"pushGoVersion": "0.1.0",
"pushJavaVersion": "0.1.0",
"pushPythonVersion": "0.4.3",
"pushCVersion": "1.0.12",
"pushCSharpVersion": "0.9.0",
"enableAuthentication": false,
"overriddenServerStatus": null,
"defaultInstanceEphemeral": true,
"healthCheckWhiteList": [],
"checksum": null,
"name": "00-00---000-NACOS_SWITCH_DOMAIN-000---00-00"
}
12、修改系统开关
12.1、接口说明
12.2、案例
[root@zhoufei ~]# curl -X PUT '127.0.0.1:8848/nacos/v1/ns/operator/switches?entry=pushEnabled&value=false&debug=true' -w '\n'
ok
13、查看系统当前数据指标
13.1、接口说明
13.2、案例
[root@zhoufei ~]# curl -X GET '127.0.0.1:8848/nacos/v1/ns/operator/metrics' -w '\n'
{
"status": "UP"
}
14、查看当前集群Server列表
14.1、接口说明
14.2、案例
[root@zhoufei ~]# curl -X GET '127.0.0.1:8848/nacos/v1/ns/operator/servers' -w '\n'
{
"servers": [
{
"ip": "192.168.187.171",
"port": 8848,
"state": "UP",
"extendInfo": {
"lastRefreshTime": 1669015959691,
"raftMetaData": {
"metaDataMap": {
"naming_instance_metadata": {
"leader": "192.168.187.171:7848",
"raftGroupMember": [
"192.168.187.171:7848"
],
"term": 2
},
"naming_persistent_service_v2": {
"leader": "192.168.187.171:7848",
"raftGroupMember": [
"192.168.187.171:7848"
],
"term": 2
},
"naming_service_metadata": {
"leader": "192.168.187.171:7848",
"raftGroupMember": [
"192.168.187.171:7848"
],
"term": 2
}
}
},
"raftPort": "7848",
"readyToUpgrade": true,
"version": "2.1.1"
},
"address": "192.168.187.171:8848",
"failAccessCnt": 0,
"abilities": {
"remoteAbility": {
"supportRemoteConnection": true
},
"configAbility": {
"supportRemoteMetrics": false
},
"namingAbility": {
"supportJraft": true
}
}
}
]
}
15、查看当前集群leader
15.1、接口说明
15.2、案例
[root@zhoufei ~]# curl -X GET '127.0.0.1:8848/nacos/v1/ns/raft/leader' -w '\n'
{
leader:{
"heartbeatDueMs": 2500,
"ip": "1.1.1.1:8848",
"leaderDueMs": 12853,
"state": "LEADER",
"term": 54202,
"voteFor": "1.1.1.1:8848"
}
}
16、更新实例的健康状态
16.1、接口说明
16.2、案例
[hd@zhoufei ~]$ curl -X PUT 'http://127.0.0.1:8848/nacos/v1/ns/health/instance?port=8848&healthy=true&ip=11.11.11.11&serviceName=nacos.test.2&namespaceId=n1' -w '\n'
ok
17、批量更新实例元数据(Beta)
17.1、接口说明
17.2、案例
[root@zhoufei ~]# curl -X PUT 'http://localhost:8848/nacos/v1/ns/instance/metadata/batch' -d 'namespaceId=public&serviceName=xxxx@@xxxx&instances=[{"ip":"3.3.3.3","port": "8080","ephemeral":"true","clusterName":"xxxx-cluster"},{"ip":"2.2.2.2","port":"8080","ephemeral":"true","clusterName":"xxxx-cluster"}]&metadata={"age":"20","name":"cocolan"}' -w '\n'
{
"updated": []
}
18、批量删除实例元数据(Beta)
18.1、接口说明
18.2、案例
[root@zhoufei ~]# curl -X DELETE 'http://localhost:8848/nacos/v1/ns/instance/metadata/batch' -d 'namespaceId=public&serviceName=xxxx@@xxxx&instances=[{"ip":"3.3.3.3","port": "8080","ephemeral":"true","clusterName":"xxxx-cluster"},{"ip":"2.2.2.2","port":"8080","ephemeral":"true","clusterName":"xxxx-cluster"}]&metadata={"age":"20","name":"cocolan"}' -w '\n'
{
"updated": []
}