应用管理与运维平台 ServiceStage应用管理与运维平台 ServiceStage

更新时间:2021/06/25 GMT+08:00
分享

查询微服务唯一标识信息

功能介绍

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

调试

您可以在API Explorer中调试该接口。

URI

GET /v4/{project_id}/registry/existence

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

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

表2 Query参数

参数

是否必选

参数类型

描述

type

String

资源类型分为两种,microservice微服务 schema微服务访问契约。

env

String

development|testing|acceptance|production 微服务的环境信息

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]+)$

service_id

String

资源类型为 schema时 需传入微服务唯一标识。 字符长度为1~64。正则表达式为^.*$

schema_id

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 请求Header参数

参数

是否必选

参数类型

描述

x-domain-name

String

租户帐号名称。

X-Auth-Token

String

用户Token。

响应参数

状态码: 200

表4 响应Header参数

参数

参数类型

描述

X-Schema-Summary

String

契约的摘要

表5 响应Body参数

参数

参数类型

描述

serviceId

String

查询实体为服务时,返回服务ID。

schemaId

String

查询实体为契约时,返回契约ID。

状态码: 400

表6 响应Body参数

参数

参数类型

描述

errorCode

String

错误代码。

errorMessage

String

错误信息。

detail

String

详细定位信息。

状态码: 500

表7 响应Body参数

参数

参数类型

描述

errorCode

String

错误代码。

errorMessage

String

错误信息。

detail

String

详细定位信息。

请求示例

GET https://{endpoint}/v4/{project_id}/registry/existence

响应示例

状态码: 200

查询成功,则返回 service_id 或者 schema_id。

{
  "serviceId" : "string",
  "schemaId" : "string"
}

状态码

状态码

描述

200

查询成功,则返回 service_id 或者 schema_id。

400

错误的请求。

500

服务内部错误

错误码

请参见错误码

分享:

    相关文档

    相关产品