diff --git a/tutorials/source_zh_cn/advanced_use/serving.md b/tutorials/source_zh_cn/advanced_use/serving.md
index 1acf851d9e64e5ac62ffbe199cb329af5187c502..1b8e1665ea43c5a9ff54e862690f9616c28cd65a 100644
--- a/tutorials/source_zh_cn/advanced_use/serving.md
+++ b/tutorials/source_zh_cn/advanced_use/serving.md
@@ -10,9 +10,10 @@
- [应用示例](#应用示例)
- [导出模型](#导出模型)
- [启动Serving推理服务](#启动serving推理服务)
- - [客户端示例](#客户端示例)
+ - [gRPC客户端示例](#gRPC客户端示例)
- [Python客户端示例](#python客户端示例)
- [C++客户端示例](#cpp客户端示例)
+ - [REST API客户端示例](#restapi客户端示例)
@@ -37,10 +38,12 @@ ms_serving [--help] [--model_path ] [--model_name ]
|`--help`|可选|显示启动命令的帮助信息。|-|-|-|
|`--model_path=`|必选|指定待加载模型的存放路径。|String|空|-|
|`--model_name=`|必选|指定待加载模型的文件名。|String|空|-|
-|`--port=`|可选|指定Serving对外的端口号。|Integer|5500|1~65535|
+|`--port=`|可选|指定Serving对外的gRPC端口号。|Integer|5500|1~65535|
+|`--rest_api_port=`|可选|指定Serving对外的REST API端口号。|Integer|5501|1~65535|
|`--device_id=`|可选|指定使用的设备号|Integer|0|0~7|
> 执行启动命令前,需将`/{your python path}/lib:/{your python path}/lib/python3.7/site-packages/mindspore/lib`对应的路径加入到环境变量LD_LIBRARY_PATH中 。
+ > port与rest_api_port不可相同。
## 应用示例
下面以一个简单的网络为例,演示MindSpore Serving如何使用。
@@ -57,9 +60,10 @@ python add_model.py
```bash
ms_serving --model_path={model directory} --model_name=tensor_add.mindir
```
-当服务端打印日志`MS Serving Listening on 0.0.0.0:5500`时,表示Serving服务已加载推理模型完毕。
+当服务端打印日志`MS Serving grpc Listening on 0.0.0.0:5500`时,表示Serving gRPC服务已加载推理模型完毕。
+当服务端打印日志`MS Serving restful Listening on 0.0.0.0:5501`时,表示Serving REST服务已加载推理模型完毕。
-### 客户端示例
+### gRPC客户端示例
#### Python客户端示例
获取[ms_client.py](https://gitee.com/mindspore/mindspore/blob/master/serving/example/python_client/ms_client.py),启动Python客户端。
```bash
@@ -91,7 +95,7 @@ ms client received:
```
其中`{grpc_install_dir}`为gRPC安装时的路径,请替换为实际gRPC安装路径。
-2. 启动客户端
+2. 启动gRPC客户端
执行ms_client,向Serving服务发送推理请求:
```bash
@@ -129,7 +133,8 @@ ms client received:
//set shape
TensorShape shape;
- shape.add_dims(4);
+ shape.add_dims(2);
+ shape.add_dims(2);
*data.mutable_tensor_shape() = shape;
//set type
@@ -150,3 +155,24 @@ ms client received:
完整代码参考[ms_client](https://gitee.com/mindspore/mindspore/blob/master/serving/example/cpp_client/ms_client.cc)。
+### REST API客户端示例
+以data形式发送数据:
+```
+curl -X POST -d '{"data": [[1.0, 2.0, 3.0, 4.0], [1.0, 2.0, 3.0, 4.0]]"}' http://127.0.0.1:5501
+```
+
+显示如下返回值,说明Serving服务已正确执行Add网络的推理:
+```
+{"data":[[2,4], [6,8]]}
+```
+
+以tensor形式发送数据:
+```
+curl -X POST -d '{"tensor": [[[1.0, 2.0], [3.0, 4.0]], [[1.0, 2.0], [3.0, 4.0]]]"}' http://127.0.0.1:5501
+```
+
+显示如下返回值,说明Serving服务已正确执行Add网络的推理:
+```
+{"tensor":[[2,4], [6,8]]}
+```
+