membphis commented on a change in pull request #1258: Supplement admin-api-cn.md, add route/service/consumer/upstream/ssl definitions. URL: https://github.com/apache/incubator-apisix/pull/1258#discussion_r392544819
########## File path: doc/admin-api-cn.md ########## @@ -147,3 +173,269 @@ curl http://127.0.0.1:9080/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f13 [Back to TOC](#目录) +## Service + +*地址*：/apisix/admin/services/{id} + +*说明*：`Service` 是某类 API 的抽象（也可以理解为一组 Route 的抽象）。它通常与上游服务抽象是一一对应的，`Route` +与 `Service` 之间，通常是 N:1 的关系。 + +> 请求方法： + +|名字 |请求 uri|请求 body|说明 | +|---------|-------------------------|--|------| +|GET |/apisix/admin/services/{id}|无|获取资源| +|PUT |/apisix/admin/services/{id}|{...}|根据 id 创建资源| +|POST |/apisix/admin/services |{...}|创建资源，id 由后台服务自动生成| +|DELETE |/apisix/admin/services/{id}|无|删除资源| +|PATCH |/apisix/admin/services/{id}/{path}|{...}|修改已有 Service 的部分内容，其他不涉及部分会原样保留。| + +> body 请求参数： + +|名字 |可选项 |类型 |说明 |示例| +|---------|---------|----|-----------|----| +|plugins |可选 |Plugin|详见 [Plugin](architecture-design-cn.md#plugin) || +|upstream | upstream 或 upstream_id 两个选一个 |Upstream|启用的 Upstream 配置，详见 [Upstream](architecture-design-cn.md#upstream)|| +|upstream_id| upstream 或 upstream_id 两个选一个 |Upstream|启用的 upstream id，详见 [Upstream](architecture-design-cn.md#upstream)|| +|desc |可选 |辅助 |标识服务名称、使用场景等。|| + +serivce 对象 json 配置内容： + +```json +{ Review comment: ditto ---------------------------------------------------------------- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: us...@infra.apache.org With regards, Apache Git Services
