批量删除厂商 - DeleteVendors
功能介绍
批量删除厂商
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
POST /v1/{project_id}/workspaces/{workspace_id}/soc/vendors/batch-delete
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID,用于明确项目归属,配置后可通过该ID查询项目下资产,可以通过调用API获取,也可以从控制台获取。获取项目ID 约束限制: 不涉及 取值范围: 只能由英文字母、数字组成,且长度为32~64个字符。 默认取值: 不涉及 |
| workspace_id | 是 | String | 参数解释: 工作空间ID,用于明确工作空间归属,配置后可通过该ID查询工作空间下资产,可以通过调用API获取,也可以从控制台获取。 约束限制: 不涉及 取值范围: 只能由英文字母、数字、中划线组成,UUID格式,且长度为32~64个字符。 默认取值: 不涉及 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| ids | 是 | Array of strings | 参数解释: 厂商ID列表,用于指定需要删除的厂商。 约束限制: 不涉及 取值范围: 1~100个UUID格式的ID,每个ID只能由英文字母、数字、中划线组成。 默认取值: 不涉及 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| X-request-id | String | 参数解释: 请求ID,用于任务追踪。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| code | String | 参数解释: 响应码,用于标识请求是否成功。 取值范围: |
| message | String | 参数解释: 响应消息,用于返回操作提示信息。 取值范围: 长度为0~1024个字符。 |
| request_id | String | 参数解释: 请求ID,用于唯一标识一次请求,便于问题追踪。 取值范围: UUID格式,且长度为0~128个字符。 |
| success | Boolean | 参数解释: 是否成功,用于标识请求是否处理成功。 取值范围: |
| data | String | 参数解释: 业务数据,无业务数据返回时为空。 取值范围: 不涉及 |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| X-request-id | String | 参数解释: 请求ID,用于任务追踪。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 | 错误响应 |
错误码
请参见错误码。