删除微服务定义信息
功能介绍
删除一个微服务定义及其相关信息,同时注销其所有实例信息。
接口约束
无
URI
DELETE /v4/{project_id}/registry/microservices/{service_id}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
请填固定值:default。 |
service_id |
是 |
String |
微服务唯一标识。字符长度为1~64。正则表达式为^.*$,获取方法请参考查询所有微服务信息。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
force |
否 |
Boolean |
是否强制删除。 true表示强制删除,false表示非强制删除。 选择强制删除会自动注销所有服务实例,并且删除相关的服务依赖关系。如果未传此参数,那么在服务拥有实例时,无法被删除。 缺省值:false |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
Authorization |
否 |
String |
若ServiceComb引擎专享版开启了安全认证,此参数必填。否则,无此参数。 开启了安全认证的ServiceComb引擎专享版Token,格式为: Authorization:Bearer {Token} Token获取方法,请参考获取ServiceComb引擎专享版用户Token。 |
响应参数
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
errorCode |
String |
错误代码。 |
errorMessage |
String |
错误信息。 |
detail |
String |
详细定位信息。 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
errorCode |
String |
错误代码。 |
errorMessage |
String |
错误信息。 |
detail |
String |
详细定位信息。 |
请求示例
删除一个ID为e0f0da073f2c91e8979a89ff2d7c69t6的微服务。
DELETE https://{endpoint}/v4/d9f4da085f2c11e8959a00ff2d7c69b7/registry/microservices/e0f0da073f2c91e8979a89ff2d7c69t6
响应示例
无
状态码
状态码 |
描述 |
---|---|
200 |
删除成功。 |
400 |
错误的请求。 |
500 |
服务内部错误。 |
错误码
请参见错误码。