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

批量删除微服务静态信息

功能介绍

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

接口约束

URI

DELETE /v4/{project_id}/registry/microservices

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

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

参数

是否必选

参数类型

描述

force

Boolean

是否强制删除。

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

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

缺省值:false。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

Authorization

String

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

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

Authorization:Bearer {Token}

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

表4 请求Body参数

参数

是否必选

参数类型

描述

serviceIds

Array of strings

服务ID列表,获取方法请参考查询所有微服务信息

响应参数

状态码: 200

表5 响应Body参数

参数

参数类型

描述

services

Array of DelServicesRspInfo objects

需要删除的服务信息列表。

表6 DelServicesRspInfo

参数

参数类型

描述

serviceId

String

微服务id。

状态码: 400

表7 响应Body参数

参数

参数类型

描述

errorCode

String

错误代码。

errorMessage

String

错误信息。

detail

String

详细定位信息。

状态码: 500

表8 响应Body参数

参数

参数类型

描述

errorCode

String

错误代码。

errorMessage

String

错误信息。

detail

String

详细定位信息。

请求示例

删除微服务ID为id1和id2的微服务的静态信息。

DELETE https://{endpoint}/v4/{project_id}/registry/microservices

{
  "serviceIds" : [ "id1", "id2"]
}

响应示例

状态码: 200

删除成功。

{
  "services" : [ {
    "serviceId" : "id1"
  },
 {
    "serviceId" : "id2"
  }
 ]
}

状态码

状态码

描述

200

删除成功。

400

错误的请求。

500

服务内部错误。

错误码

请参见ServiceComb错误码