查询微服务唯一标识信息 - QueryUniqueServiceOrSchemaIDOfMicroservice

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

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

GET /v4/{project_id}/registry/existence

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	请填固定值：default。

表2 Query参数
参数	是否必选	参数类型	描述
type	是	String	请求类型。取值范围： microservice：微服务。 schema：契约。说明：若type为microservice，参数env、appId、serviceName、version必填。若type为schema，参数serviceId、schemaId必填。
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]+)$。
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 请求Header参数
参数	是否必选	参数类型	描述
Authorization	否	String	若ServiceComb引擎专享版开启了安全认证，此参数必填。否则，无此参数。开启了安全认证的ServiceComb引擎专享版Token，格式为： Authorization:Bearer {Token} Token获取方法，请参考获取ServiceComb引擎专享版用户Token。

状态码： 200

表4 响应Header参数
参数	参数类型	描述
X-Schema-Summary	String	契约的摘要。

表5 响应Body参数
参数	参数类型	描述
serviceId	String	查询实体为服务时，返回服务ID。
schemaId	String	查询实体为契约时，返回契约ID。

状态码： 400

状态码： 500

查询微服务serviceId，指定的查询条件是请求类型为microservice，应用ID为default，微服务名称为service，微服务版本为1.0.0。

GET https://{endpoint}/v4/{project_id}/registry/existence?type=microservice&appId=default&serviceName=service&version=1.0.0

状态码： 200

查询成功，则返回serviceId或者schemaId。

{
  "serviceId" : "8aed80ea052ac04a64dfc79c24f2170224d074f5"
}

父主题：微服务

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试