更新时间:2024-10-16 GMT+08:00

API概览

表1 接口简介

类型

子类型

说明

应用管理API(v3版本)

环境接口

环境的相关接口。

环境是用于组件部署和运行的计算(如云容器引擎 CCE、弹性云服务器 ECS等)、网络(如弹性负载均衡 ELB、弹性IP EIP等)和中间件(如分布式缓存 DCS、云数据库 RDS等)等基础资源的集合。ServiceStage把多种基础资源组合为一个环境,如:开发环境、测试环境、预生产环境和生产环境。按环境维度来管理资源、部署组件,可以减少具体基础资源运维管理的复杂性。

应用接口

应用的相关接口。

应用是一个功能相对完备的业务系统,由一个或多个特性相关的组件组成。

组件接口

组件的相关接口。

组件是组成应用的某个业务特性实现,以代码或者软件包为载体,可独立部署在环境下运行。

泳道组接口

泳道组的相关接口。

泳道组是一组泳道的集合,用于区分不同的组织或场景。

说明:

“亚太-新加坡”区域支持调用泳道组接口。

泳道接口

泳道的相关接口。

泳道用于为相同版本组件定义一套隔离环境。只有满足了流控路由规则的请求流量才会路由到对应泳道里的打标签组件。

说明:

“亚太-新加坡”区域支持调用泳道接口。

运行时接口

运行时的相关接口。

部署任务接口

部署任务的相关接口。

插件管理接口

管理插件的相关接口。

访问Git仓库API

访问Git仓库接口

Git仓库授权、仓库命名空间、项目、分支、tags、commits、hooks、仓库文件目录、内容的相关接口。

CSE API

动态配置

提供从配置管理中心导入、导出配置信息的接口。

引擎管理

提供创建、查询、删除微服务引擎专享版的引擎管理接口。

ServiceComb API

认证

微服务身份认证功能的相关操作接口。

微服务

微服务管理的相关操作接口。

契约

微服务契约查询、上传等相关操作接口。

微服务实例

微服务实例注册、上报心跳等相关操作接口。

依赖关系

微服务依赖关系查询接口。

配置管理

提供配置中心配置管理功能的相关操作接口。

环境接口

表2 环境接口

API

说明

创建环境

此API用来创建环境。

获取所有环境

此API用来获取所有环境。

根据环境ID删除环境

此API用来通过环境ID删除环境。

根据环境ID修改环境

此API用来通过环境ID修改环境。

根据环境ID获取环境详细信息

此API用来通过环境ID获取环境详细信息。

根据环境ID修改环境资源

此API用来通过环境ID修改环境资源。

根据环境ID查询环境资源

此API用来根据环境ID查询环境资源。

应用接口

表3 应用接口

API

说明

创建应用

此API用来创建应用。

获取所有应用

此API用来获取所有应用。

根据应用ID修改应用信息

此API用来通过应用ID修改应用信息。

根据应用ID删除应用

此API用来通过应用ID删除应用。

根据应用ID获取应用详细信息

此API用来通过应用ID获取应用详细信息。

根据应用ID获取应用配置

此API用来通过应用ID获取应用配置信息。

根据应用ID修改应用配置

此API用来通过应用ID修改应用配置。

根据应用ID删除应用配置

此API用来通过应用ID删除应用配置。

组件接口

表4 组件接口

API

说明

应用中创建组件

此API用来在应用中创建组件。

获取应用所有组件

此API用来获取应用下所有组件。

获取所有组件

此API用来获取所有应用组件。

根据组件ID修改组件信息

此API用来通过组件ID修改组件信息。

根据组件ID删除组件

此API用来通过组件ID删除组件。

根据组件ID获取组件信息

此API用来通过组件ID获取组件信息。

根据组件ID下发组件任务

此API用来通过组件ID下发组件任务。

根据组件ID获取记录

此API用来通过组件ID获取记录。

泳道组接口

表5 泳道组接口

API

说明

创建泳道组

此API用来在创建泳道组。

泳道组是一组泳道的集合,用于区分不同的组织或场景。同一个项目下,最多支持创建300个泳道组。

获取所有泳道组

此API用来获取所有已经创建的泳道组。

根据泳道组ID获取泳道组信息

此API用来根据泳道组ID获取泳道组信息。

根据泳道组ID修改泳道组

此API用来根据泳道组ID修改泳道组。

根据泳道组ID删除泳道组

此API用来根据泳道组ID删除泳道组。

根据网关ID获取目标服务列表

此API用来根据网关ID获取目标服务列表。

根据泳道组ID修改泳道组网关路由配置

此API用来根据泳道组ID修改泳道组网关路由配置。

泳道接口

表6 泳道接口

API

说明

泳道组下创建泳道

此API用来在泳道组下创建泳道。

根据微服务引擎ID获取所有泳道

此API用来根据微服务引擎ID获取所有泳道。

获取泳道组下所有泳道

此API用来获取泳道组下所有泳道。

根据泳道ID获取泳道信息

此API用来根据泳道ID获取泳道信息。

根据泳道ID修改泳道信息

此API用来根据泳道ID修改泳道信息。

根据泳道ID删除泳道

此API用来根据泳道ID删除泳道。

根据泳道ID控制泳道路由开关

此API用来根据泳道ID控制泳道路由开关。

根据泳道ID关联组件

此API用来根据泳道ID为泳道关联组件。

运行时接口

表7 运行时接口

API

说明

查询运行时栈

此API用来获取运行时信息。

部署任务接口

表8 部署任务接口

API

说明

获取部署任务详细信息

此API用来获取部署任务详细信息。

插件管理接口

表9 插件管理接口

API

说明

创建插件

此API用来创建插件。

查询插件列表

此API用来查询环境下的插件列表。

查询插件元数据信息

此API用来查询环境下插件的元数据信息。

根据插件ID查询插件详情

此API用来查询环境下指定插件详情。

根据插件ID下发插件任务

此API用来根据插件ID下发插件任务。

根据插件ID删除插件

此API用来根据插件ID删除插件。

访问Git仓库接口

表10 访问Git仓库接口

API

说明

获取仓库授权列表

此API用来获取Git仓库所有授权信息。

获取授权重定向URL

此API用来获取授权重定向URL。

创建OAuth授权

此API用来创建OAuth授权。

创建私人令牌授权

此API用来创建私有令牌授权。

创建口令授权

此API用来创建Git仓库口令授权。

删除仓库授权

此API用来通过名称删除仓库授权。

获取仓库namespaces

此API用来获取仓库namespaces。

通过clone url获取仓库信息

此API用来通过clone url获取仓库信息。

获取命名空间下所有项目

此API用来获取命名空间下所有项目。

创建软件仓库项目

此API用来创建软件仓库项目。

获取项目分支

此API用来获取项目分支。

获取项目tags

此API用来获取项目tags。

创建项目tags

此API用来创建项目tags。

删除项目tags

此API用来删除项目tags。

获取项目commits

此API用来获取项目最近10次commits。

获取项目hooks

此API用来获取项目hooks。

创建项目hook

此API用来创建项目hook。

删除项目hook

此API用来删除项目hook。

获取仓库文件目录

此API用来获取仓库文件目录。

获取仓库文件内容

此API用来获取仓库文件内容。

创建仓库文件

此API用来创建仓库文件。

修改仓库文件内容

此API用来修改仓库文件内容。

删除仓库文件

此API用来删除仓库文件内容。

动态配置

表11 动态配置接口

API

说明

导入配置

此API用来从配置管理中心导入配置信息。

导出配置

此API用来从配置管理中心导出配置信息。

引擎管理

表12 引擎管理接口

API

说明

查询微服务引擎专享版支持规格

此API用来查询微服务引擎专享版支持的规格。

查询微服务引擎专享版列表

此API用来查询微服务引擎专享版列表。

创建微服务引擎专享版

此API用来创建微服务引擎专享版。

查询微服务引擎专享版详情

此API用来查询微服务引擎专享版详情。

删除微服务引擎专享版

此API用来删除微服务引擎专享版。

查询微服务引擎专享版任务详情

此API用来查询微服务引擎专享版任务详情。

认证

表13 认证接口

API

说明

获取微服务引擎专享版用户Token

此API仅用于开启了安全认证的微服务引擎专享版。

在访问开启了安全认证的微服务引擎专享版的接口前,需要先调用该接口获取用户Token,该Token是访问接口的唯一凭据。

微服务

表14 微服务接口

API

说明

查询指定微服务信息

此API用来根据serviceId查询微服务定义信息。

删除微服务定义信息

此API用来删除一个微服务定义及其相关信息,同时注销其所有实例信息。

查询所有微服务信息

此API用来根据条件组合,查询满足所有条件的微服务定义信息。

创建微服务静态信息

此API用来在注册微服务实例前创建服务静态信息,之后注册的微服务实例根据serviceId这个字段与静态信息关联,一个服务对应对多个实例。serviceId可以定制。如果定制了,系统将使用定制的serviceId;如果没定制,系统会随机生成serviceId。

批量删除微服务静态信息

此API用来批量删除指定的微服务定义及其相关信息,同时注销其所有实例信息。

修改微服扩展属性信息

此API用来创建微服务静态信息后对服务部分字段进行更新。每次更新都需要传入完整的服务静态信息json,也就是说,即便不更新部分的字段也要作为json的属性传过去。

查询微服务唯一标识信息

此API用来通过指定条件,查询微服务serviceId或schema的唯一标识信息。

契约

表15 契约接口

API

说明

查询微服务契约

此API用来根据service_id和schema_id查询微服务的契约信息。

修改微服务契约

此API用来根据schema_id更新微服务的契约内容。

查询微服务的所有契约

此API用来查询一个微服务的所有契约信息,包括schemaId和summary信息。

微服务实例

表16 微服务实例接口

API

说明

注册微服务实例

此API用来在创建微服务后注册该微服务的实例。 注册微服务实例时,需提供该微服务实例相关的信息。 instanceId可定制,如果定制了,再次注册就直接全内容覆盖。如果没定制,逻辑如下:系统自动生成id,如果endpoints内容重复,则使用原来的id。

根据service_id查询微服务实例

此API用来在实例注册后根据service_id发现该微服务的所有实例。

注销微服务实例

此API用来在实例注册后根据instance_id进行实例注销。

查询微服务实例详细信息

此API用来在实例注册后根据service_id和instance_id获取该实例的详细信息。

修改微服务实例扩展信息

此API用来在实例注册后根据instance_id添加/更新一个微服务实例的扩展信息。

修改微服务实例状态

此API用来在实例注册后根据instance_id更新一个微服务实例的状态。

发送心跳信息

此API用来在服务提供端向服务中心发送心跳信息,以保证服务中心知道服务实例是否健康。

按条件查询微服务实例

此API用来在实例注册后根据微服务版本规则或字段条件发现该微服务的实例。

批量查询微服务实例

此API用来在实例注册后根据微服务版本规则或字段条件批量发现多个微服务的实例。

依赖关系

表17 依赖关系接口

API

说明

查询服务providers

此API用来根据consumer_id获取该服务的所有providers。比如A->B A->C,那么根据A的服务Id,可以查询到B、C的微服务信息。

配置管理

表18 配置管理接口

API

说明

创建配置

此API用来创建一条配置。

修改配置

此API用来修改指定一条配置。

查询指定配置

此API用来查询指定一条配置。

查询配置列表

此API用来查询配置列表。

删除指定配置

此API用来删除指定一条配置。

删除所有配置

此API用来删除所有配置。