# 注册发现
#### 场景描述
本章节指导用户通过API实现微服务注册与发现。API的调用方法请参见[如何调用API](https://support.huaweicloud.com/api-cse/cse_06_0008.html)。
#### 流程介绍
1. 注册第一个微服务my-provider。
2. 注册微服务my-provider的实例。
3. 注册第二个微服务my-consumer。
4. my-consumer发现第一个微服务my-provider的实例。
![](https://support.huaweicloud.com/api-cse/public_sys-resources/note_3.0-zh-cn.png)
以上微服务名称均为示例。
#### 前提条件
已获取ServiceComb引擎实例的注册发现地址，参考[服务注册发现地址](https://support.huaweicloud.com/api-cse/cse_06_0002.html#cse_06_0002__section135612434013)，以下示例中以{cse_endpoint}代替。
#### 操作步骤
1. 注册微服务my-provider。 
   调用[创建微服务静态信息](https://support.huaweicloud.com/api-cse/cse_06_0040.html)接口，请求示例如下。
   ```
   curl -k -H "x-domain-name:default" -XPOST "https://{cse_endpoint}/v4/default/registry/microservices" -d '{
       "service": {
           "serviceName": "my-provider",
           "appId": "default",
           "version": "1.0.0",
           "description": "test",
           "level": "MIDDLE",
           "status": "UP"
       }
   }'
   ```
   返回结果：
   ```
   {"serviceId":"918282e8562dc5fdc9a8dcd4d1baabb492190aa4"}
   ```
   得到的serviceId，后续示例中以{providerServiceId}代替。
   
   
2. 注册微服务my-provider的实例。 
   调用[注册微服务实例](https://support.huaweicloud.com/api-cse/cse_06_0049.html)接口。实例有效期1小时，到期自动下线。假设provider实例监听的地址为127.0.0.1:8080，请求示例如下。
   ```
   curl -k -H "x-domain-name:default" -XPOST "https://{cse_endpoint}/v4/default/registry/microservices/{providerServiceId}/instances" -d '{
       "instance": {
           "hostName": "test",
           "endpoints": [
               "rest:127.0.0.1:8080"
           ],
           "status": "UP",
           "healthCheck": {
               "mode": "push",
               "interval": 900,
               "times": 3
           }
       }
   }'
   ```
   返回结果：
   ```
   {"instanceId":"2be605a095ed11eabcbe0255ac100fa3"}
   ```
   
   
3. 注册微服务my-consumer。 
   调用[创建微服务静态信息](https://support.huaweicloud.com/api-cse/cse_06_0040.html)接口，请求示例如下。
   ```
   curl -k -H "x-domain-name:default" -XPOST "https://{cse_endpoint}/v4/default/registry/microservices" -d '{
       "service": {
           "serviceName": "my-consumer",
           "appId": "default",
           "version": "1.0.0",
           "description": "test",
           "level": "MIDDLE",
           "status": "UP"
       }
   }'
   ```
   返回结果：
   ```
   {"serviceId":"9db248934c31fc754d6e922b48ede4a5c004d3c1"}
   ```
   得到的serviceId，后续示例中以{consumerServiceId}代替。
   
   
4. my-consumer发现my-provider的实例。 
   调用[按条件查询微服务实例](https://support.huaweicloud.com/api-cse/cse_06_0056.html)接口，consumer带着自身的serviceId去服务中心查询provider的实例信息，请求示例如下。
   ```
   curl -k -H "x-domain-name:default" -H "X-ConsumerId:{consumerServiceId}" -XGET "https://{cse_endpoint}/v4/default/registry/instances?appId=default&serviceName=my-provider&version=0.0.0%2B"
   ```
   返回结果：
   ```
   {
       "instances": [
           {
               "instanceId": "2be605a095ed11eabcbe0255ac100fa3", 
               "serviceId": "918282e8562dc5fdc9a8dcd4d1baabb492190aa4", 
               "endpoints": [
                   "rest:127.0.0.1:8080"
               ], 
               "hostName": "test", 
               "status": "UP", 
               "healthCheck": {
                   "mode": "push", 
                   "interval": 150, 
                   "times": 3
               }, 
               "timestamp": "1589465646", 
               "modTimestamp": "1589465646", 
               "version": "1.0.0"
           }
       ]
   }
   ```
   在实际业务中，consumer可从实例查询结果中的"endpoint"字段获取provider实例的地址，发起业务调用。
   您还可以进入微服务引擎控制台的"微服务目录"，查看服务注册信息。