欢迎使用弹性微服务（Tencent Elastic Microservice，以下简称 TEM）。
腾讯云弹性微服务（Tencent Elastic Microservice，TEM）是面向微服务应用的 Serverless PaaS 平台，为用户提供应用托管、生命周期管理、服务治理及多维度监控等微服务管理能力。实现 IaaS 资源 Serverless 化，微服务自动弹性扩缩容，帮助用户免运维，解决成本和效率问题，进一步降低微服务应用上云的门槛。
弹性微服务向用户提供弹性的计算、存储和网络资源。用户可以使用本文档介绍的 API，并参照相应的示例，对弹性微服务进行相关操作：如创建命名空间、部署服务、配置公网访问等；支持的全部操作可参见 API 概览。
请确保在使用这些接口前，已充分了解了 弹性微服务产品概述。
注意：
- 本章节弹性微服务 API 接口均为最新 API 3.0 接口，后续 TEM 相关新增功能都会在此章节更新。我们强烈推荐您使用最新 API 3.0 接口。
- 现有旧版 API 接口功能依然保持，未来可能停止维护，如您仍需使用旧版接口可参考相关文档。
术语表
本文档涉及的一些常用术语如下：
| 术语 | 英文 | 说明 |
|---|---|---|
| 命名空间 | Namespace | 用于隔离和管理微服务应用的逻辑单元，不同命名空间之间的资源相互隔离。 |
| 服务 | Service | 指一个完整的微服务应用，包含应用代码、运行环境和配置信息。 |
| 应用版本 | Application Version | 服务的特定版本，支持多版本并存和灰度发布。 |
| 实例 | Pod | 服务部署后运行的最小单元，对应 Kubernetes 中的一个 Pod。 |
| 公网访问 | Public Network Access | 通过 Ingress 规则将服务暴露到公网，实现外部访问。 |
| 弹性伸缩 | Auto-scaling | 根据流量自动调整服务实例数量的能力。 |
输入参数与返回参数释义
Limit 和 Offset
用来控制分页的参数。Limit 为单次返回的最多条目数量，Offset 为偏移量。当相应结果是列表形式时，如果数量超过了 Limit 所限定的值，那么只返回 Limit 个值。
举例来说，参数 Offset=0&Limit=20 返回第 0 到 19 项，Offset=20&Limit=20 返回第 20 到 39 项，Offset=40&Limit=20 返回第 40 到 59 项；以此类推。
Ids.N
同时输入多个参数的格式。当遇到形如这样的格式时，那么该输入参数可以同时传多个。例如：
GET 请求或者 POST x-www-form-urlencoded 请求：Ids.0=ins-r8hr2upy&Ids.1=ins-5d8a23rs&Ids.2=ins--dcs9x3gz
以此类推（以下标 0 开始）。
POST json 请求：{"Ids": ["ins-r8hr2upy", "ins-5d8a23rs", "ins-dcs9x3gz"]}
API 快速入门
这里针对几个典型的使用场景对弹性微服务 API 的使用方式进行说明：
- 通过使用 创建命名空间 API，提供命名空间名称等必要信息，即可创建一个新的命名空间用于隔离微服务资源。
- 通过使用 创建服务 API，提供镜像地址、资源配置等参数，即可创建一个新的微服务应用。
- 通过使用 部署服务 API，选择目标服务和版本，即可将服务部署到指定命名空间。
- 如需对外提供访问能力，可以使用 创建或更新 Ingress 规则 API 配置公网访问路由。
- 如需查看服务运行状态，可以使用 获取服务下面运行 Pod 列表 API 查看实例运行情况。
- 如需重启服务实例，可以使用 重启实例 API 对指定 Pod 进行重启操作。
使用限制
- API 创建的资源遵循弹性微服务产品文档所描述的数量限制，和官网所创建的资源共用配额。
- 更具体的限制请参考对应 API 接口文档或产品文档。
- 默认接口请求频率限制请根据具体接口文档说明，超出频率限制时会返回错误码
RequestLimitExceeded。
