调用ExportVul接口导出漏洞列表。

使用说明

本接口用于导出漏洞列表。可用于导出Linux软件漏洞、Windows系统漏洞、Web-CMS漏洞、应用漏洞以及应急漏洞的漏洞列表。

本接口与DescribeVulExportInfo接口配合使用。使用本接口建立漏洞导出任务之后,可调用DescribeVulExportInfo接口录入漏洞导出任务的ID,查看漏洞导出任务的进度。

QPS限制

本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ExportVul

需要执行的操作。取值:ExportVul

Lang String zh

设置请求和接收消息的语言类型,默认为zh。取值:

  • zh:中文
  • en:英文
Type String app

要导出的漏洞列表的漏洞类型。取值:

  • cve:Linux软件漏洞
  • sys:Windows系统漏洞
  • cms:Web-CMS漏洞
  • app:应用漏洞
  • emg:应急漏洞
Uuids String 1587bedb-fdb4-48c4-9330-****

要查询漏洞的服务器的UUID,多个UUID使用半角逗号(,)分隔。

AliasName String OpenSSH权限提升漏洞(CVE-2021-41617)

漏洞名称。

Necessity String asap

要查询的漏洞修复优先级。多个优先级使用半角逗号(,)分隔。取值包括:

  • asap:高
  • later:中
  • nntf:低
Dealed String n

要查询的漏洞是否已修复。取值:

  • y:已修复
  • n:未修复
GroupId String 8834224

要查询的漏洞所在服务器的资产分组ID。您可以调用DescribeAllGroups接口获取该参数。

SearchTags String VPC

按照标签过滤。取值:

  • 扫描方式
  • 资产分组
  • VPC
AttachTypes String sca

查询应用漏洞时的附加漏洞类型。查询应用漏洞(即Type设置为app)时需要设置该参数。该参数固定取值为sca

说明 如果该参数设置为sca,可查询应用漏洞(app类型)及软件成分分析(sca类型)漏洞,如果不设置该参数,只查询应用漏洞。
VpcInstanceIds String ins-133****,ins-5414****

要查询漏洞的VPC实例ID。多个ID使用半角逗号(,)分隔。您可以调用接口DescribeVpcList获取该参数。

返回数据

名称 类型 示例值 描述
RequestId String E1FAB2B8-DF4D-55DF-BC3D-5C3CA6FD5B13

本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

FileName String app_20211101

导出文件的名称。

Id Long 81634

导出文件的ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ExportVul
&Lang=zh
&Type=app
&Uuids=1587bedb-fdb4-48c4-9330-****
&AliasName=OpenSSH权限提升漏洞(CVE-2021-41617)
&Necessity=asap
&Dealed=n
&GroupId=8834224
&SearchTags=VPC
&AttachTypes=sca
&VpcInstanceIds=ins-133****,ins-5414****
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ExportVulResponse>
    <RequestId>E1FAB2B8-DF4D-55DF-BC3D-5C3CA6FD5B13</RequestId>
    <FileName>app_20211101</FileName>
    <Id>81634</Id>
</ExportVulResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "E1FAB2B8-DF4D-55DF-BC3D-5C3CA6FD5B13",
  "FileName" : "app_20211101",
  "Id" : 81634
}

错误码

访问错误中心查看更多错误码。