All Products
Search
Document Center

Security Center:ExportVul

Last Updated:Oct 23, 2026

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

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

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: Chinese

  • en: English

zh

Type

string

Yes

The type of the vulnerabilities to be exported. Valid values:

  • cve: Linux software vulnerability

  • sys: Windows system vulnerability

  • cms: Web-CMS vulnerability

  • app: application vulnerability

  • emg: emergency vulnerability

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: high

  • later: medium

  • nntf: low

asap

Dealed

string

No

Specifies whether the vulnerabilities to be queried are fixed. Valid values:

  • y: fixed

  • n: unfixed

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

  • Remote utilization

  • EXP exists

  • Available

  • Elevation of privilege

  • Code execution

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: not supported

  • 1: supported

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: server asset

  • CONTAINER: container asset

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.