匯出漏洞清單。
介面說明
本介面用於匯出漏洞清單。可用於匯出 Linux 軟體漏洞、Windows 系統漏洞、Web-CMS 漏洞、應用程式漏洞以及緊急漏洞的漏洞清單。
本介面與 DescribeVulExportInfo 介面配合使用。使用本介面建立漏洞匯出任務之後,可呼叫 DescribeVulExportInfo 介面輸入漏洞匯出任務的 ID,檢視漏洞匯出任務的進度。
QPS 限制
本介面的單使用者 QPS 限制為 10 次/秒。超過限制,API 呼叫會被限流,這可能會影響您的業務,請合理呼叫。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| Lang |
string |
否 |
設定請求和接收訊息的語言類型,預設為 zh。取值:
|
zh |
| Type |
string |
是 |
要匯出的漏洞清單的漏洞類型。取值:
|
app |
| Uuids |
string |
否 |
要查詢漏洞的伺服器的 UUID,多個 UUID 使用半形逗號(,)分隔。 |
1587bedb-fdb4-48c4-9330-**** |
| AliasName |
string |
否 |
漏洞名稱。 |
RHSA-2019:3197-Important: sudo security update |
| Necessity |
string |
否 |
要查詢的漏洞修復優先順序。多個優先順序使用半形逗號(,)分隔。取值包括:
|
asap |
| Dealed |
string |
否 |
要查詢的漏洞是否已修復。取值:
|
n |
| GroupId |
string |
否 |
要查詢的漏洞所在伺服器的資產分組 ID。 說明
您可以呼叫 DescribeAllGroups 介面取得該參數。 |
8834224 |
| SearchTags |
string |
否 |
按照標籤篩選。取值:
|
Restart required |
| AttachTypes |
string |
否 |
查詢應用程式漏洞時的附加漏洞類型。查詢應用程式漏洞(即 Type 設定為 app)時需要設定該參數。該參數固定取值為 sca。 說明
如果該參數設定為 sca,可查詢應用程式漏洞(app 類型)及軟體成分分析(sca 類型)漏洞,如果不設定該參數,只查詢應用程式漏洞。 |
sca |
| VpcInstanceIds |
string |
否 |
要查詢漏洞的 VPC 執行個體 ID。多個 ID 使用半形逗號(,)分隔。 說明
您可以呼叫 DescribeVpcList 介面取得該參數。 |
ins-133****,ins-5414**** |
| CveId |
string |
否 |
CVE 編號。 |
CVE-2022-44702 |
| Path |
string |
否 |
要查詢漏洞影響的處理程序路徑。 |
/etc/test |
| ContainerName |
string |
否 |
要查詢漏洞影響的容器名稱。 |
xxljob-7b87597b99-mcskr |
| ImageName |
string |
否 |
要查詢漏洞影響的映像名稱。 |
container-***:**** |
| CreateTsStart |
integer |
否 |
首次掃描時間起始時間。 說明
時間戳記,單位為毫秒。 |
1696128144000 |
| CreateTsEnd |
integer |
否 |
首次掃描時間結束時間。 說明
時間戳記,單位為毫秒。 |
1696186800000 |
| RaspDefend |
integer |
否 |
應用程式防護(RASP)是否支援即時防護該漏洞。取值:
|
0 |
| VulEntityList |
array<object> |
否 |
漏洞元件資訊清單。 |
|
|
object |
否 |
漏洞元件資訊。 |
||
| EntityVersion |
string |
否 |
元件版本。 |
1.0.0 |
| EntityName |
string |
否 |
元件名稱。 |
Ollama |
| ResourceDirectoryAccountId |
integer |
否 |
資源目錄帳戶 ID。 |
1 |
| AssetType |
string |
否 |
漏洞所在資產類型。多個類型使用半形逗號(,)分隔。取值:
|
ECS |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
匯出漏洞清單返回結果。 |
||
| RequestId |
string |
本次呼叫請求的 ID,是由阿里雲為該請求產生的唯一識別碼,可用於排查和定位問題。 |
E1FAB2B8-DF4D-55DF-BC3D-5C3CA6FD5B13 |
| FileName |
string |
匯出檔案的名稱。 |
app_20211101 |
| Id |
integer |
匯出檔案的 ID。 |
81634 |
樣本
正常返回樣本
JSON格式
{
"RequestId": "E1FAB2B8-DF4D-55DF-BC3D-5C3CA6FD5B13",
"FileName": "app_20211101",
"Id": 81634
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | FreeVersionNotPermit | Free version is not permitted. | |
| 500 | ServerError | ServerError | |
| 403 | NoPermission | caller has no permission |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。