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

查询微服务唯一标识信息

功能介绍

可通过指定条件,查询微服务serviceId或schema的唯一标识信息。

URI

GET /v4/{project_id}/registry/existence

表1 路径参数

参数

类型

必选

说明

project_id

String

请填固定值:default。

表2 Query参数

参数

类型

必选

说明

type

String

请求类型:

  • microservice
  • schema

env

String

微服务的环境信息,取值为development|testing|acceptance|production,默认为development。

appId

String

资源类型为microservice时,需传入应用app唯一标识。

字符长度为1~160。

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

serviceName

String

资源类型为microservice时,需传入微服务名称。

字符长度为1~128

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

version

String

资源类型为microservice时,需传入微服务版本。

字符长度为1~64。

正则表达式为^[0-9]*$|^[0-9]+(\.[0-9]+)*$

serviceId

String

资源类型为schema时,需传入微服务唯一标识。

字符长度为1~64。

正则表达式为^.*$

schemaId

String

资源类型为schema时,需传入schema唯一标识。字符长度为1~160。

正则表达式为^[a-zA-Z0-9]{1,160}$|^[a-zA-Z0-9][a-zA-Z0-9_\-.]{0,158}[a-zA-Z0-9]$

请求消息

响应消息

响应参数

参数说明请参见表3

表3 参数说明

参数

类型

说明

serviceId

String

微服务唯一标识,当查询微服务时返回该字段。

schemaId

String

访问契约唯一标识,当查询契约时返回该字段。

示例

请求示例

GET /v4/default/registry/existence

响应示例

{
  "serviceId": "string"
}

状态码

状态码请参见状态码

错误码

错误码请参见CSE错误码