更新时间:2024-12-12 GMT+08:00
分享

删除微服务定义信息

功能介绍

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

接口约束

URI

DELETE /v4/{project_id}/registry/microservices/{service_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

请填固定值:default。

service_id

String

微服务唯一标识。字符长度为1~64。正则表达式为^.*$,获取方法请参考查询所有微服务信息

表2 Query参数

参数

是否必选

参数类型

描述

force

Boolean

是否强制删除。

true表示强制删除,false表示非强制删除。

选择强制删除会自动注销所有服务实例,并且删除相关的服务依赖关系。如果未传此参数,那么在服务拥有实例时,无法被删除。

缺省值:false

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

Authorization

String

若ServiceComb引擎专享版开启了安全认证,此参数必填。否则,无此参数。

开启了安全认证的ServiceComb引擎专享版Token,格式为:

Authorization:Bearer {Token}

Token获取方法,请参考获取ServiceComb引擎专享版用户Token

响应参数

状态码: 400

表4 响应Body参数

参数

参数类型

描述

errorCode

String

错误代码。

errorMessage

String

错误信息。

detail

String

详细定位信息。

状态码: 500

表5 响应Body参数

参数

参数类型

描述

errorCode

String

错误代码。

errorMessage

String

错误信息。

detail

String

详细定位信息。

请求示例

删除一个ID为e0f0da073f2c91e8979a89ff2d7c69t6的微服务。

DELETE https://{endpoint}/v4/d9f4da085f2c11e8959a00ff2d7c69b7/registry/microservices/e0f0da073f2c91e8979a89ff2d7c69t6

响应示例

状态码

状态码

描述

200

删除成功。

400

错误的请求。

500

服务内部错误。

错误码

请参见ServiceComb错误码

相关文档