更新时间:2023-06-26 GMT+08:00

按条件查询微服务实例

功能介绍

实例注册后可以根据微服务版本规则或字段条件发现该微服务的实例。

URI

GET /v4/{project_id}/registry/instances

表1 路径参数

参数

类型

必选

说明

project_id

String

请填固定值:default。

表2 Query参数

参数

类型

必选

说明

appId

String

应用app唯一标识。

字符长度为1~160。

正则表达式为^[a-zA-Z0-9]*$|^[a-zA-Z0-9][a-zA-Z0-9_\-.]*[a-zA-Z0-9]$

serviceName

String

微服务名称。

字符长度为1~128。

正则表达式为^[a-zA-Z0-9]*$|^[a-zA-Z0-9][a-zA-Z0-9_\-.]*[a-zA-Z0-9]$

version

String

版本规则。包括:
  • 1 表示精确版本匹配,如:0.0.1
  • 2 表示后续版本匹配,如:0.0.1+
  • 3 表示最新版本,如:latest
  • 4 表示版本范围,如:0.1.0-0.2.0

env

String

取值为development|testing|acceptance|production。

tags

String

Tag标签过滤服务,多个时逗号分隔。

正则表达式为^[a-zA-Z][a-zA-Z0-9_\-\.]{0,63}$

请求消息

表3 请求Header参数

参数

类型

必选

说明

X-ConsumerId

String

服务消费者唯一标识。

响应消息

响应参数

参数说明请参见表4

表4 参数说明

参数

类型

说明

instances

Array of objects

微服务实例的集合。每一项为MicroServiceInstance

示例

请求示例

GET /v4/default/registry/instances

响应示例

{
  "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错误码