文档首页 > > API参考> CSE API> 微服务> 查询微服务唯一标识信息

查询微服务唯一标识信息

分享
更新时间:2020/06/24 GMT+08:00

功能介绍

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

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 微服务的环境信息

缺省值: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]+)$

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

租户账号名称。

响应参数

状态码为 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 时:

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

状态码为 400 时:

{
  "errorCode" : "string",
  "errorMessage" : "string",
  "detail" : "string"
}

状态码为 500 时:

{
  "errorCode" : "string",
  "errorMessage" : "string",
  "detail" : "string"
}

状态码

状态码

描述

200

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

400

错误的请求

500

服务内部错误

错误码

请参见错误码

分享:

    相关文档

    相关产品

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

提交成功!

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

智能客服提问云社区提问