- 最新动态
- 功能总览
- 产品介绍
- 计费说明
- 快速入门
-
用户指南
- 使用前必读
- 权限管理
- 环境管理
- 应用管理
- 组件管理
- 配置管理
- 发布管理（公测）
- 技术栈管理
- 部署源管理
- 持续交付
- 微服务引擎
- 云审计服务支持的关键操作
- 查看监控指标及告警
- 开发指南
- 最佳实践
- API参考
- SDK参考
-
常见问题
- 应用开发问题咨询指引
- 环境管理
-
应用管理
- 如何查看应用组件部署失败的原因？
- 实例长期处于创建中怎么办？
- 如何解决Docker运行node应用程序时的依赖问题？
- 如何定制Tomcat Context path？
- 如何固定应用组件IP？
- 如何处理虚拟机类型环境下创建和部署组件时遇到ECS错误？
- 如何处理虚拟机类型环境下创建和部署组件时端口访问不通的错误？
- 虚拟机类型环境下部署的应用组件支持在什么目录写文件？
- 如何处理虚拟机类型环境下部署的组件删除失败报host status is not active错误的问题？
- 如何体验ServiceStage的源码部署功能？
- 如何处理使用ServiceStage灰度发布升级组件失败？
- 如何通过挂载配置项方式修改容器部署的组件配置文件？
- 如何处理应用组件接入微服务引擎后在微服务治理下看到的应用名称和ServiceStage应用管理下的不同？
- 持续交付
- 软件中心
- 基础设施
- 应用运维
- 应用开发问题
-
更多文档
- API参考（阿布扎比区域）
-
用户指南（阿布扎比区域）
- 产品介绍
- 快速入门
- 用户指南
-
常见问题
- 如何获取AK/SK？
- 如何处理修改项目名称导致的错误？
- 微服务和普通应用有什么不同？
- 如何查看应用组件部署失败的原因？
- 如何处理部署或升级虚机组件失败？
- Node.js 8软件包打包有哪些约束？
- 如何处理安装Agent失败？
- 如何处理Agent离线？
- 虚机部署的应用组件支持在什么目录写文件？
- 如何处理虚机部署的组件删除失败报host status is not active错误的问题？
- Docker应用程序依赖的问题
- 如何解决Docker客户端push镜像失败的问题？
- 如何获取项目名称？
- 如何处理开启了安全认证的微服务引擎专享版开启IPv6后服务注册失败？
- 如何处理操作微服务引擎专享版时遇到非微服务引擎本身错误？
- 如何处理部署组件时失败，报错日志详情显示connection was closed？
- 如何处理部署虚机组件时遇到ECS错误？
- 如何处理虚机部署端口访问不通的错误？
- 如何处理微服务应用名称与组件所属应用名称不同的问题？
- 如何解释微服务名称与组件名称不同的原因？
- 微服务引擎专享版数据恢复失败
- 用户指南（吉隆坡区域）
- API参考（吉隆坡区域）
- 视频帮助
- 通用参考
链接复制成功！
批量查询微服务实例
功能介绍
实例注册后可以根据微服务版本规则或字段条件批量发现多个微服务的实例。
URI
POST /v4/{project_id}/registry/instances/action
|
参数 |
类型 |
必选 |
说明 |
|---|---|---|---|
|
project_id |
String |
是 |
请填固定值：default。 |
|
参数 |
类型 |
必选 |
说明 |
|---|---|---|---|
|
type |
String |
是 |
操作类型。 填固定值：query。 |
请求消息
|
参数 |
类型 |
必选 |
说明 |
|---|---|---|---|
|
X-ConsumerId |
String |
否 |
服务消费者唯一标识。 |
|
参数 |
类型 |
必选 |
说明 |
|---|---|---|---|
|
services |
Array of objects |
否 |
微服务请求结构体，具体参考表5。 |
|
instances |
Array of objects |
否 |
微服务实例请求结构体，具体参考表6。 |
|
参数 |
类型 |
必选 |
说明 |
|---|---|---|---|
|
service |
Object |
是 |
微服务请求结构体，具体参考DependencyMicroService。 |
|
rev |
String |
否 |
客户端缓存的版本号。 |
|
参数 |
类型 |
必选 |
说明 |
|---|---|---|---|
|
instance |
Object |
是 |
微服务实例请求结构体，具体参考HeartbeatSetElement。 |
|
rev |
String |
否 |
客户端缓存的版本号。 |
响应消息
响应参数
参数说明请参见表7。
|
参数 |
类型 |
说明 |
|---|---|---|
|
failed |
Array of objects |
部分微服务发现失败的响应结构体，具体参考表9。 |
|
notModified |
Array of integers |
实例没有发生变化的索引数组，每一项的值对应请求结构体中微服务数组的索引值。 |
|
updated |
Array of objects |
实例发生变化的响应结构体，具体参考表10。 |
|
参数 |
类型 |
说明 |
|---|---|---|
|
indexes |
Array of integers |
微服务发现失败的索引数组，每一项的值对应请求结构体中微服务数组的索引值。 |
|
error |
Object |
错误信息结构体，具体参考Error。 |
|
参数 |
类型 |
说明 |
|---|---|---|
|
index |
Integer |
实例发生变化的索引数组，每一项的值对应请求结构体中微服务数组的索引值。 |
|
rev |
String |
返回给客户端缓存的版本号。 |
|
instances |
Array of objects |
微服务实例的集合，具体参考MicroServiceInstance。 |
示例
请求示例
curl -X POST "/v4/default/registry/instances/action?type=query" -H "accept: application/json" -H "Content-Type: application/json" -d '
{
"services": [
{
"service": {
"environment": "string",
"appId": "string",
"serviceName": "string",
"version": "string"
},
"rev": "string"
}
],
"instances": [
{
"instance": {
"serviceId": "string",
"instanceId": "string"
},
"rev": "string"
}
]
}响应示例
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
Server: SERVICECENTER/0.0.1
Vary: Accept-Encoding
Vary: Origin
X-Response-Status: 200
Date: Fri, 21 Dec 2018 02:36:48 GMT
Content-Length: 1952
{
"services": {
"failed": [
{
"indexes": [
0
],
"error": {
"errorCode": "string",
"errorMessage": "string",
"detail": "string"
}
}
],
"notModified": [
0
],
"updated": [
{
"index": 0,
"rev": "string",
"instances": [
{
"instanceId": "string",
"serviceId": "string",
"version": "string",
"hostName": "string",
"endpoints": [
"string"
],
"status": "string",
"healthCheck": {
"mode": "string",
"port": 0,
"interval": 0,
"times": 0
},
"dataCenterInfo": {
"name": "string",
"region": "string",
"availableZone": "string"
},
"timestamp": "string",
"modTimestamp": "string"
}
]
}
]
},
"instances": {
"failed": [
{
"indexes": [
0
],
"error": {
"errorCode": "string",
"errorMessage": "string",
"detail": "string"
}
}
],
"notModified": [
0
],
"updated": [
{
"index": 0,
"rev": "string",
"instances": [
{
"instanceId": "string",
"serviceId": "string",
"version": "string",
"hostName": "string",
"endpoints": [
"string"
],
"status": "string",
"healthCheck": {
"mode": "string",
"port": 0,
"interval": 0,
"times": 0
},
"dataCenterInfo": {
"name": "string",
"region": "string",
"availableZone": "string"
},
"timestamp": "string",
"modTimestamp": "string"
}
]
}
]
}
}状态码
状态码请参见状态码。
错误码
错误码请参见CSE错误码。
