微服务引擎 CSE-批量查询微服务实例:请求参数

时间:2023-11-01 16:20:04

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-consumerId

String

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

Authorization

String

若微服务引擎专享版开启了安全认证,此参数必填。否则,无此参数。

开启了安全认证的微服务引擎专享版Token,格式为:

Authorization:Bearer {Token}

Token获取方法,请参考获取微服务引擎专享版用户Token

表4 请求Body参数

参数

是否必选

参数类型

描述

services

两个参数至少必须选择一个。

Array of FindService objects

查询服务信息结构体。

instances

Array of FindInstance objects

查询实例信息结构体。

表5 FindService

参数

是否必选

参数类型

描述

service

DependencyKey object

依赖关系条目。

rev

String

客户端缓存的版本号,用于判断本地缓存和服务中心微服务的差异。

  • 首次传值0。
  • 若传入的rev值与当前的微服务的rev一致,则返回notModified;若不一致,则返回updated信息。
  • 下次请求若需要传入rev,则该值为当前返回body体中的updated中的rev的值 。
表6 DependencyKey

参数

是否必选

参数类型

描述

environment

String

环境信息:development、testing、acceptance、production。

appId

String

应用app唯一标识。

serviceName

String

微服务名称。

表7 FindInstance

参数

是否必选

参数类型

描述

instance

HeartbeatSetElement object

微服务实例请求结构体。

rev

String

客户端缓存的版本号,

客户端缓存的版本号,用于判断本地缓存和服务中心微服务实例的差异。

  • 首次传值0。
  • 若传入的rev值与当前的微服务实例的rev一致,则返回notModified;若不一致,则返回updated信息。
  • 下次请求若需要传入rev,则该值为当前返回body体中的updated中的rev的值 。

表8 HeartbeatSetElement

参数

是否必选

参数类型

描述

serviceId

String

微服务id。

instanceId

String

微服务实例id。

support.huaweicloud.com/api-cse/servicecomb_api_0024.html