检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
获取ServiceComb引擎专享版用户Token 功能介绍 仅用于开启了安全认证的ServiceComb引擎专享版。 在访问开启了安全认证的ServiceComb引擎专享版的接口前，需要先调用该接口获取用户Token，该Token是访问接口的唯一凭据。 发送访问请求时需要在请求头中带上该Token，格式为：
查询微服务唯一标识信息 功能介绍 可通过指定条件，查询微服务serviceId或schema的唯一标识信息。 URI GET /v4/{project_id}/registry/existence 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
查询指定类型治理策略列表 功能介绍 查询指定类型治理策略列表。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /v3/{project_id}/govern/governance/{kind}
批量查询微服务实例 功能介绍 实例注册后可以根据微服务字段条件批量发现多个微服务的实例。 URI POST /v4/{project_id}/registry/instances/action 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
获取项目ID 从控制台获取项目ID 在调用接口的时候，部分URL中需要填入项目D，所以需要获取到项目ID。获取步骤如下： 登录微服务引擎控制台。 鼠标移动到右上角登录用户名上，在下拉菜单选择“我的凭证”。 在“项目列表”中查看项目ID。 图1 查看项目ID 调用API获取项目ID
附录 状态码 CSE错误码 ServiceComb错误码 获取项目ID
注册微服务实例 功能介绍 创建微服务后就可以注册该微服务的实例。 注册微服务实例时，需提供该微服务实例相关的信息。 instanceId可定制，如果定制了，再次注册就直接全内容覆盖；如果没有定制，系统自动生成id，如果endpoints内容重复，则使用原来的id。 URI POST
注销微服务实例 功能介绍 实例注册后可以根据instance_id进行实例注销。 URI DELETE /v4/{project_id}/registry/microservices/{service_id}/instances/{instance_id} 表1 路径参数 参数 是否必选
修改微服务实例扩展信息 功能介绍 实例注册后，可以根据instance_id添加或更新一个微服务实例扩展信息。 接口约束 无 URI PUT /v4/{project_id}/registry/microservices/{service_id}/instances/{instance_id}/properties
按条件查询微服务实例 功能介绍 实例注册后可以根据微服务字段条件发现该微服务的实例。 URI GET /v4/{project_id}/registry/instances 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 请填固定值：default。
修改微服务实例状态 功能介绍 实例注册后可以根据instance_id进行更新一个微服务实例状态。 接口约束 TESTING状态是2.3.X版本才支持的，老版本不支持。 URI PUT /v4/{project_id}/registry/microservices/{servic
应用示例 注册发现
查询微服务实例详细信息 功能介绍 实例注册后可以根据service_id和instance_id获取该实例的详细信息。 URI GET /v4/{project_id}/registry/microservices/{service_id}/instances/{instance_id}
使用前必读 微服务引擎（Cloud Service Engine，CSE），是用于微服务应用的云中间件，支持华为云贡献到Apache社区的注册配置中心Servicecomb引擎、开源增强的注册配置中心Nacos引擎和应用网关。用户可结合其他云服务，快速构建云原生微服务体系，实现微服务应用的快速开发和高可用运维。
修订记录 发布日期 修订记录 2021-11-30 第二次正式发布。 API拆分为CSE API和ServiceComb API两部分。 2021-09-20 第一次正式发布。
注册发现 场景描述 本章节指导用户通过API实现微服务注册与发现。API的调用方法请参见如何调用API。 流程介绍 注册第一个微服务my-provider。 注册微服务my-provider的实例。 注册第二个微服务my-consumer。 my-consumer发现第一个微服务my-provider的实例。
根据service_id查询微服务实例 功能介绍 实例注册后可以根据service_id发现该微服务的所有实例。 URI GET /v4/{project_id}/registry/microservices/{service_id}/instances 表1 路径参数 参数 是否必选
CSE错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 表1 引擎管理类错误码 状态码 错误码 错误信息 描述 处理措施 400 SVCSTG.00501134 The engine type is left blank. 引擎类型不合法
状态码 状态码如表1所示。 表1 状态码 状态码 编码 错误码说明 200 - 操作成功。 204 NoContent 操作成功。 400 BadRequest 非法请求。 建议直接修改该请求为合法请求，不要再重试该请求。 401 Unauthorized 在客户端提供认证信息后
ServiceComb错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 分类 状态码 错误码 错误信息 描述 处理措施 公共错误码 400 400001 Invalid parameter(s) 非法参数 根据错误提示中的规则，修改提示中的参数。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
