API概览
ServiceStage API为开发者、合作伙伴提供开发、部署、托管、运维的开放接口，帮助用户快速、低成本地实现业务创新，缩短应用上线周期。
对应的接口参考请参考下表：
类型 |
子类型 |
说明 |
|---|---|---|
应用管理接口（v3版本） 请使用如下Endpoint： servicestage.<regionname>.myhuaweicloud.com |
环境的相关接口。 |
|
应用的相关接口。 |
||
组件的相关接口。 |
||
运行时的相关接口。 |
||
应用管理接口（v2版本） 请使用如下Endpoint： servicestage.<regionname>.myhuaweicloud.com
说明：
应用管理v2版本接口即将下线，推荐使用应用管理v3版本接口。 |
应用模板、运行时、应用资源规格的相关接口。 |
|
应用环境的相关接口。 |
||
应用的相关接口。 |
||
应用组件的相关接口。 |
||
应用组件实例的相关接口。 |
||
部署任务的相关接口。 |
||
访问Git仓库接口 请使用如下Endpoint： servicestage.<regionname>.myhuaweicloud.com |
Git仓库授权、仓库命名空间、项目、分支、tags、commits、hooks、仓库文件目录、内容的相关接口。 |
|
CSE接口 请使用如下Endpoint： cse.<regionname>.myhuaweicloud.com |
|
|
ServiceComb原生接口 |
|
环境接口（v3版本）
API |
说明 |
|---|---|
此API用来创建环境。 |
|
此API用来获取所有环境。 |
|
此API用来通过环境ID删除环境。 |
|
此API用来通过环境ID修改环境。 |
|
此API用来通过环境ID获取环境详细信息。 |
|
此API用来通过环境ID修改环境资源。 |
|
此API用来根据环境ID查询环境资源。 |
应用接口（v3版本）
API |
说明 |
|---|---|
此API用来创建应用。 |
|
此API用来获取所有应用。 |
|
此API用来通过应用ID修改应用信息。 |
|
此API用来通过应用ID删除应用。 |
|
此API用来通过应用ID获取应用详细信息。 |
|
此API用来通过应用ID获取应用配置信息。 |
|
此API用来通过应用ID修改应用配置。 |
|
此API用来通过应用ID删除应用配置。 |
组件接口（v3版本）
API |
说明 |
|---|---|
此API用来在应用中创建组件。 |
|
此API用来获取应用下所有组件。 |
|
此API用来获取所有应用组件。 |
|
此API用来通过组件ID修改组件信息。 |
|
此API用来通过组件ID删除组件。 |
|
此API用来通过组件ID获取组件信息。 |
|
此API用来通过组件ID下发组件任务。 |
|
此API用来通过组件ID获取记录。 |
环境接口（v2版本）
API |
说明 |
|---|---|
此API用来创建环境。 |
|
此API用来获取所有环境。 |
|
此API用来通过环境ID修改环境。 |
|
此API用来通过环境ID删除环境。 |
|
此API用来通过环境ID获取环境详细信息。 |
|
此API用来修改环境资源。 |
应用接口（v2版本）
API |
说明 |
|---|---|
此API用来创建应用。 |
|
此API用来获取所有已经创建的应用。 |
|
此API用来通过应用ID修改应用信息。 |
|
此API用来通过应用ID删除应用。 |
|
此API用来通过应用ID获取应用详细信息。 |
|
此API用来添加或修改应用配置信息。 |
|
此API用来删除应用配置信息。 |
|
此API用来获取应用配置信息。 |
组件接口（v2版本）
API |
说明 |
|---|---|
此API用来在应用中创建组件。 |
|
此API用来获取应用下所有组件。 |
|
此API用来通过组件ID修改组件信息。 |
|
此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用来在实例注册后根据微服务版本规则或字段条件批量发现多个微服务的实例。 |
