更新时间:2026-09-24 GMT+08:00
分享

批量删除厂商 - DeleteVendors

功能介绍

批量删除厂商

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。

URI

POST /v1/{project_id}/workspaces/{workspace_id}/soc/vendors/batch-delete

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID,用于明确项目归属,配置后可通过该ID查询项目下资产,可以通过调用API获取,也可以从控制台获取。获取项目ID

约束限制:

不涉及

取值范围:

只能由英文字母、数字组成,且长度为32~64个字符。

默认取值:

不涉及

workspace_id

是

String

参数解释:

工作空间ID,用于明确工作空间归属,配置后可通过该ID查询工作空间下资产,可以通过调用API获取,也可以从控制台获取。

约束限制:

不涉及

取值范围:

只能由英文字母、数字、中划线组成,UUID格式,且长度为32~64个字符。

默认取值:

不涉及

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

ids

是

Array of strings

参数解释:

厂商ID列表,用于指定需要删除的厂商。

约束限制:

不涉及

取值范围:

1~100个UUID格式的ID,每个ID只能由英文字母、数字、中划线组成。

默认取值:

不涉及

响应参数

状态码:200

表3 响应Header参数

参数

参数类型

描述

X-request-id

String

参数解释:

请求ID,用于任务追踪。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表4 响应Body参数

参数

参数类型

描述

code

String

参数解释:

响应码,用于标识请求是否成功。

取值范围:

  • 00000000:成功

message

String

参数解释:

响应消息,用于返回操作提示信息。

取值范围:

长度为0~1024个字符。

request_id

String

参数解释:

请求ID,用于唯一标识一次请求,便于问题追踪。

取值范围:

UUID格式,且长度为0~128个字符。

success

Boolean

参数解释:

是否成功,用于标识请求是否处理成功。

取值范围:

  • true:成功

  • false:失败

data

String

参数解释:

业务数据,无业务数据返回时为空。

取值范围:

不涉及

状态码:400

表5 响应Header参数

参数

参数类型

描述

X-request-id

String

参数解释:

请求ID,用于任务追踪。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,用于标识错误类型。

取值范围:

只能由英文字母、数字、点号组成,且长度为0~64个字符。

error_msg

String

参数解释:

错误描述,用于描述错误的详细信息。

取值范围:

长度为0~1024个字符。

请求示例

在某个工作空间批量删除厂商的请求样例

https://{endpoint}/v1/{project_id}/workspaces/{workspace_id}/soc/vendors/batch-delete

{
  "ids" : [ "28f61af50fc9452aa0ed5ea25c3cc3d3" ]
}

响应示例

状态码:200

{
  "code" : "00000000",
  "message" : "",
  "data" : "",
  "request_id" : "",
  "success" : true
}

状态码

状态码

描述

200

成功响应

400

错误响应

错误码

请参见错误码。

相关文档