API概览
类型 |
子类型 |
说明 |
---|---|---|
应用管理API(v3版本) |
环境的相关接口。 环境是用于组件部署和运行的计算(如云容器引擎 CCE、弹性云服务器 ECS等)、网络(如弹性负载均衡 ELB、弹性IP EIP等)和中间件(如分布式缓存 DCS、云数据库 RDS等)等基础资源的集合。ServiceStage把多种基础资源组合为一个环境,如:开发环境、测试环境、预生产环境和生产环境。按环境维度来管理资源、部署组件,可以减少具体基础资源运维管理的复杂性。 |
|
应用的相关接口。 应用是一个功能相对完备的业务系统,由一个或多个特性相关的组件组成。 |
||
组件的相关接口。 组件是组成应用的某个业务特性实现,以代码或者软件包为载体,可独立部署在环境下运行。 |
||
泳道组的相关接口。 泳道组是一组泳道的集合,用于区分不同的组织或场景。
说明:
仅“华东-上海1”、“亚太-新加坡”区域支持调用泳道组接口。 |
||
泳道的相关接口。 泳道用于为相同版本组件定义一套隔离环境。只有满足了流控路由规则的请求流量才会路由到对应泳道里的打标签组件。
说明:
仅“华东-上海1”、“亚太-新加坡”区域支持调用泳道接口。 |
||
运行时的相关接口。 |
||
部署任务的相关接口。 |
||
管理插件的相关接口。 |
||
访问Git仓库API |
Git仓库授权、仓库命名空间、项目、分支、tags、commits、hooks、仓库文件目录、内容的相关接口。 |
|
CSE API |
提供从配置管理中心导入、导出配置信息的接口。 |
|
提供创建、查询、删除微服务引擎专享版的引擎管理接口。 |
||
ServiceComb API |
微服务身份认证功能的相关操作接口。 |
|
微服务管理的相关操作接口。 |
||
微服务契约查询、上传等相关操作接口。 |
||
微服务实例注册、上报心跳等相关操作接口。 |
||
微服务依赖关系查询接口。 |
||
提供配置中心配置管理功能的相关操作接口。 |
环境接口
API |
说明 |
---|---|
此API用来创建环境。 |
|
此API用来获取所有环境。 |
|
此API用来通过环境ID删除环境。 |
|
此API用来通过环境ID修改环境。 |
|
此API用来通过环境ID获取环境详细信息。 |
|
此API用来通过环境ID修改环境资源。 |
|
此API用来根据环境ID查询环境资源。 |
应用接口
API |
说明 |
---|---|
此API用来创建应用。 |
|
此API用来获取所有应用。 |
|
此API用来通过应用ID修改应用信息。 |
|
此API用来通过应用ID删除应用。 |
|
此API用来通过应用ID获取应用详细信息。 |
|
此API用来通过应用ID获取应用配置信息。 |
|
此API用来通过应用ID修改应用配置。 |
|
此API用来通过应用ID删除应用配置。 |
组件接口
API |
说明 |
---|---|
此API用来在应用中创建组件。 |
|
此API用来获取应用下所有组件。 |
|
此API用来获取所有应用组件。 |
|
此API用来通过组件ID修改组件信息。 |
|
此API用来通过组件ID删除组件。 |
|
此API用来通过组件ID获取组件信息。 |
|
此API用来通过组件ID下发组件任务。 |
|
此API用来通过组件ID获取记录。 |
泳道组接口
API |
说明 |
---|---|
此API用来在创建泳道组。 泳道组是一组泳道的集合,用于区分不同的组织或场景。同一个项目下,最多支持创建300个泳道组。 |
|
此API用来获取所有已经创建的泳道组。 |
|
此API用来根据泳道组ID获取泳道组信息。 |
|
此API用来根据泳道组ID修改泳道组。 |
|
此API用来根据泳道组ID删除泳道组。 |
|
此API用来根据网关ID获取目标服务列表。 |
|
此API用来根据泳道组ID修改泳道组网关路由配置。 |
泳道接口
API |
说明 |
---|---|
此API用来在泳道组下创建泳道。 |
|
此API用来根据微服务引擎ID获取所有泳道。 |
|
此API用来获取泳道组下所有泳道。 |
|
此API用来根据泳道ID获取泳道信息。 |
|
此API用来根据泳道ID修改泳道信息。 |
|
此API用来根据泳道ID删除泳道。 |
|
此API用来根据泳道ID控制泳道路由开关。 |
|
此API用来根据泳道ID为泳道关联组件。 |
插件管理接口
API |
说明 |
---|---|
此API用来创建插件。 |
|
此API用来查询环境下的插件列表。 |
|
此API用来查询环境下插件的元数据信息。 |
|
此API用来查询环境下指定插件详情。 |
|
此API用来根据插件ID下发插件任务。 |
|
此API用来根据插件ID删除插件。 |
访问Git仓库接口
API |
说明 |
---|---|
此API用来获取Git仓库所有授权信息。 |
|
此API用来获取授权重定向URL。 |
|
此API用来创建OAuth授权。 |
|
此API用来创建私有令牌授权。 |
|
此API用来创建Git仓库口令授权。 |
|
此API用来通过名称删除仓库授权。 |
|
此API用来获取仓库namespaces。 |
|
此API用来通过clone url获取仓库信息。 |
|
此API用来获取命名空间下所有项目。 |
|
此API用来创建软件仓库项目。 |
|
此API用来获取项目分支。 |
|
此API用来获取项目tags。 |
|
此API用来创建项目tags。 |
|
此API用来删除项目tags。 |
|
此API用来获取项目最近10次commits。 |
|
此API用来获取项目hooks。 |
|
此API用来创建项目hook。 |
|
此API用来删除项目hook。 |
|
此API用来获取仓库文件目录。 |
|
此API用来获取仓库文件内容。 |
|
此API用来创建仓库文件。 |
|
此API用来修改仓库文件内容。 |
|
此API用来删除仓库文件内容。 |
引擎管理
API |
说明 |
---|---|
此API用来查询微服务引擎专享版支持的规格。 |
|
此API用来查询微服务引擎专享版列表。 |
|
此API用来创建微服务引擎专享版。 |
|
此API用来查询微服务引擎专享版详情。 |
|
此API用来删除微服务引擎专享版。 |
|
此API用来查询微服务引擎专享版任务详情。 |
认证
API |
说明 |
---|---|
此API仅用于开启了安全认证的微服务引擎专享版。 在访问开启了安全认证的微服务引擎专享版的接口前,需要先调用该接口获取用户Token,该Token是访问接口的唯一凭据。 |
微服务
API |
说明 |
---|---|
此API用来根据serviceId查询微服务定义信息。 |
|
此API用来删除一个微服务定义及其相关信息,同时注销其所有实例信息。 |
|
此API用来根据条件组合,查询满足所有条件的微服务定义信息。 |
|
此API用来在注册微服务实例前创建服务静态信息,之后注册的微服务实例根据serviceId这个字段与静态信息关联,一个服务对应对多个实例。serviceId可以定制。如果定制了,系统将使用定制的serviceId;如果没定制,系统会随机生成serviceId。 |
|
此API用来批量删除指定的微服务定义及其相关信息,同时注销其所有实例信息。 |
|
此API用来创建微服务静态信息后对服务部分字段进行更新。每次更新都需要传入完整的服务静态信息json,也就是说,即便不更新部分的字段也要作为json的属性传过去。 |
|
此API用来通过指定条件,查询微服务serviceId或schema的唯一标识信息。 |
契约
API |
说明 |
---|---|
此API用来根据service_id和schema_id查询微服务的契约信息。 |
|
此API用来根据schema_id更新微服务的契约内容。 |
|
此API用来查询一个微服务的所有契约信息,包括schemaId和summary信息。 |
微服务实例
API |
说明 |
---|---|
此API用来在创建微服务后注册该微服务的实例。 注册微服务实例时,需提供该微服务实例相关的信息。 instanceId可定制,如果定制了,再次注册就直接全内容覆盖。如果没定制,逻辑如下:系统自动生成id,如果endpoints内容重复,则使用原来的id。 |
|
此API用来在实例注册后根据service_id发现该微服务的所有实例。 |
|
此API用来在实例注册后根据instance_id进行实例注销。 |
|
此API用来在实例注册后根据service_id和instance_id获取该实例的详细信息。 |
|
此API用来在实例注册后根据instance_id添加/更新一个微服务实例的扩展信息。 |
|
此API用来在实例注册后根据instance_id更新一个微服务实例的状态。 |
|
此API用来在服务提供端向服务中心发送心跳信息,以保证服务中心知道服务实例是否健康。 |
|
此API用来在实例注册后根据微服务版本规则或字段条件发现该微服务的实例。 |
|
此API用来在实例注册后根据微服务版本规则或字段条件批量发现多个微服务的实例。 |