文档首页/应用管理与运维平台 ServiceStage/API参考/ServiceComb API/微服务/删除微服务定义信息 - DeleteDefinitionInformationAboutMicroservice
更新时间：2025-12-03 GMT+08:00
查看PDF
分享

删除微服务定义信息 - DeleteDefinitionInformationAboutMicroservice

功能介绍

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

接口约束

无

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，当前API调用无需身份策略权限。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

  • 微服务引擎专业版，请填租户项目id，长度为1~64，获取方法请参考获取项目ID。也可以填固定值default。
  • 微服务引擎专享版，请填固定值：default。

service_id

是

String

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

表2 Query参数

参数

是否必选

参数类型

描述

force

否

Boolean

是否强制删除。

取值范围：

  • true：表示强制删除。
  • false：表示非强制删除。

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

默认取值：

false

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

Authorization

否

String

若微服务引擎专享版开启了安全认证，此参数必填。否则，无此参数。

开启了安全认证的微服务引擎专享版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错误码。

父主题：微服务

相关文档