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

查询微服务实例(根据serviceId)

功能介绍

实例注册后可以根据service_id发现该微服务的所有实例。

URI

GET /v4/{project_id}/registry/microservices/{serviceId}/instances

表1 路径参数

参数

类型

必选

说明

project_id

String

请填固定值:default。

serviceId

String

微服务唯一标识。

字符长度为1~64。

正则表达式为^.*$

请求消息

表2 请求Header参数

参数

类型

必选

说明

X-ConsumerId

String

服务消费者唯一标识。

响应消息

响应参数

表3 参数说明

参数

类型

说明

instances

Array of objects

微服务实例的集合,具体参考MicroServiceInstance

示例

请求示例

GET /v4/default/registry/microservices/e0f0da073f2c91e8979a89ff2d7c69t6/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错误码