文档首页 > > API参考> API说明> 微服务引擎> 按条件查询微服务实例

按条件查询微服务实例

分享
更新时间: 2019/09/20 GMT+08:00

功能介绍

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

URI

GET /v4/{project_id}/registry/instances

参数说明请参见表1

表1 参数说明

参数

位于

类型

必选

说明

project_id

path

String

租户子项目的唯一标识。字符长度为1~64。

请求消息

请求参数

参数说明请参见表2

表2 参数说明

参数

位于

类型

必选

说明

X-ConsumerId

header

String

微服务消费者的微服务唯一标识。

x-domain-name

header

String

租户账号名称。

appId

query

String

应用app唯一标识。

字符长度为1~160。

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

serviceName

query

String

微服务名称。

字符长度为1~128。

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

version

query

String

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

tags

query

String

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

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

响应消息

响应参数

参数说明请参见表3

表3 参数说明

参数

类型

说明

instances

GetInstancesResponse

成功获取微服务实例的响应结构体。

表4 GetInstancesResponse参数说明

参数

类型

必选

说明

instances

array

每一项为MicroServiceInstance

微服务实例的集合。

示例

请求示例

GET /v4/d9f4da085f2c11e8959a00ff2d7c69b7/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"
    }
  ]
}

状态码

状态码请参见状态码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区