Exports the vulnerability list.
Operation description
This operation exports vulnerability lists. You can use it to export lists of Linux software vulnerabilities, Windows system vulnerabilities, Web-CMS vulnerabilities, application vulnerabilities, and emergency vulnerabilities.
This operation is used together with the DescribeVulExportInfo operation. After you use this operation to create a vulnerability export task, you can call the DescribeVulExportInfo operation and specify the ID of the vulnerability export task to view the progress of the export task.
QPS limit
You can call this operation up to 10 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered, which may affect your business. Call this operation at a reasonable frequency.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
yundun-sas:ExportVul |
none |
*All Resource
|
None | None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| Lang |
string |
No |
Specifies the language of the request and response. Default value: zh. Valid values:
|
zh |
| Type |
string |
Yes |
The type of the vulnerabilities to be exported. Valid values:
|
app |
| Uuids |
string |
No |
The UUIDs of the servers on which you want to query vulnerabilities. Separate multiple UUIDs with commas (,). |
1587bedb-fdb4-48c4-9330-**** |
| AliasName |
string |
No |
The name of the vulnerability. |
RHSA-2019:3197-Important: sudo security update |
| Necessity |
string |
No |
The priorities of the vulnerabilities to be queried. Separate multiple priorities with commas (,). Valid values:
|
asap |
| Dealed |
string |
No |
Specifies whether the vulnerabilities to be queried are fixed. Valid values:
|
n |
| GroupId |
string |
No |
The ID of the asset group to which the servers affected by the vulnerabilities to be queried belong. Note
You can call the DescribeAllGroups operation to obtain the value of this parameter. |
8834224 |
| SearchTags |
string |
No |
The tags used for filtering. Valid values:
|
Restart required |
| AttachTypes |
string |
No |
The additional vulnerability type when you query application vulnerabilities. You must configure this parameter when you query application vulnerabilities, which means the Type parameter is set to app. Set the value to sca. Note
If you set this parameter to sca, you can query application vulnerabilities (type app) and software composition analysis (type sca) vulnerabilities. If you do not set this parameter, only application vulnerabilities are queried. |
sca |
| VpcInstanceIds |
string |
No |
The IDs of the VPC-connected instances where the vulnerabilities to be queried reside. Separate multiple IDs with commas (,). Note
You can call the DescribeVpcList operation to obtain the value of this parameter. |
ins-133****,ins-5414**** |
| CveId |
string |
No |
The CVE ID. |
CVE-2022-44702 |
| Path |
string |
No |
The path of the process affected by the vulnerabilities to be queried. |
/etc/test |
| ContainerName |
string |
No |
The name of the container affected by the vulnerabilities to be queried. |
xxljob-7b87597b99-mcskr |
| ImageName |
string |
No |
The name of the image affected by the vulnerabilities to be queried. |
container-***:**** |
| CreateTsStart |
integer |
No |
The start time of the first scan. Note
The value is a UNIX timestamp. Unit: milliseconds. |
1696128144000 |
| CreateTsEnd |
integer |
No |
The end time of the first scan. Note
The value is a UNIX timestamp. Unit: milliseconds. |
1696186800000 |
| RaspDefend |
integer |
No |
Specifies whether Runtime Application Self-Protection (RASP) supports real-time protection against the vulnerability. Valid values:
|
0 |
| VulEntityList |
array<object> |
No |
The list of vulnerability component information. |
|
|
object |
No |
The vulnerability component information. |
||
| EntityVersion |
string |
No |
The version of the component. |
1.0.0 |
| EntityName |
string |
No |
The name of the component. |
Ollama |
| ResourceDirectoryAccountId |
integer |
No |
The ID of the resource directory account. |
1 |
| AssetType |
string |
No |
The asset type where the vulnerability resides. Separate multiple types with commas (,). Valid values:
|
ECS |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The response for exporting the vulnerability list. |
||
| RequestId |
string |
The ID of the request. The ID is a unique identifier generated by Alibaba Cloud for the request and can be used for troubleshooting. |
E1FAB2B8-DF4D-55DF-BC3D-5C3CA6FD5B13 |
| FileName |
string |
The name of the exported file. |
app_20211101 |
| Id |
integer |
The ID of the exported file. |
81634 |
Examples
Success response
JSON format
{
"RequestId": "E1FAB2B8-DF4D-55DF-BC3D-5C3CA6FD5B13",
"FileName": "app_20211101",
"Id": 81634
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | FreeVersionNotPermit | Free version is not permitted. | The free version cannot be used. |
| 500 | ServerError | ServerError | |
| 403 | NoPermission | caller has no permission | You are not authorized to do this operation. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.