getMissingPatches: дутуу патчуудын жагсаалт авах API арга
Энэ хуудсыг AI-аар орчуулж, автоматаар шалгасан. Нарийн тохиргоо хийхээсээ өмнө англи эхтэй тулгаж болно.
Тодорхой endpoint-ууд (төгсгөлийн төхөөрөмж) эсвэл тодорхой компанитай холбоотой дутуу патчуудын жагсаалтыг авахын тулд энэ аргыг ашиглана.
Ерөнхий параметрүүд
Эдгээр нь public API-ийн бүх аргад нийтлэг параметрүүд юм.
| Параметр | Тайлбар | Хүсэлтэд | Төрөл | Утгын шаардлага |
|---|---|---|---|---|
id | Хүсэлтэд тодорхойлогч нэмж, түүнийг харгалзах хариутай холбоно. Хүсэлтийн зорилтот тал хариуд ижил утгыг буцаадаг тул дуудлагыг хялбар мөшгөнө. | Заавал | String | Нэмэлт шаардлага байхгүй. Жишээ: "id": "ad12cb61-52b3-4209-a87a-93a8530d91cb" |
method | Хүсэлт илгээхэд ашиглаж буй аргын нэр. | Заавал | String | Хүчинтэй аргын нэр байх ёстой. Жишээ: "method": "methodName" |
jsonrpc | Хүсэлт ба хариуд ашиглах JSON-RPC-ийн хувилбар. | Заавал | Integer | Цорын ганц боломжит утга нь 2.0. Жишээ: "jsonrpc": "2.0" |
params | Хүсэлтийн тохиргоог агуулсан объект. | Заавал | Object | Нэмэлт шаардлага байхгүй. Жишээ: "params": {...} |
params объект дотор:
| Параметр | Тайлбар | Хүсэлтэд | Төрөл | Утгын шаардлага |
|---|---|---|---|---|
page | Үр дүнгийн хуудасны дугаар. | Заавал биш | Integer | Анхдагч утга: 1. |
perPage | Нэг хуудсанд харуулах үр дүнгийн тоо. | Заавал биш | Integer | Дээд хязгаар нь нэг хуудсанд 100 зүйл. Анхдагч утга: 30. |
Параметрүүд
| Параметр | Тайлбар | Хүсэлтэд | Төрөл | Утгын шаардлага |
|---|---|---|---|---|
endpointsIds | Патчийн мэдээллийг авах endpoint-ийн ID. | Заавал биш | Array | Нэмэлт шаардлага байхгүй. Анхдагч утга: энэ параметрийг хүсэлтэд оруулаагүй бол компанийн удирдагдаж буй бүх endpoint-ийн үр дүнг буцаана. Жишээ: "endpointsIds": ["67bc4a36bf64962c160eb6e4", "67bc4a36bf64962c160eb6d6"], |
filters | Хариунд ямар төрлийн патч оруулахыг тодорхойлно. | Заавал биш | Object | Анхдагч утга: энэ параметрийг хүсэлтэд оруулаагүй бол патчийн төрөл, эрсдлийн түвшнээс үл хамааран бүх шүүлтүүрийг буцаана. Жишээ: "filters":{ "type": 0, "severity": 1 }, |
Объектууд
filters
| Параметр | Тайлбар | Хүсэлтэд | Төрөл | Утгууд |
|---|---|---|---|---|
type | Хариунд оруулах патчийн төрөл. | Заавал биш | Integer | Боломжит утгууд: 0 - Security patch (аюулгүй байдлын патч); 1 - Non security patch (аюулгүй байдлын бус патч); 2 - Manually approved patch (гараар зөвшөөрсөн патч). Анхдагч утга: оруулаагүй бол бүх төрлийн патчийг хариунд оруулна. |
severity | Хариунд оруулах патчийн эрсдлийн түвшин (severity). | Заавал биш | Integer | Боломжит утгууд: 0 - None; 1 - Low; 2 - Moderate; 3 - Important; 4 - Critical; 5 - Unassigned. Анхдагч утга: оруулаагүй бол эрсдлийн бүх түвшний патчийг хариунд оруулна. |
Патчийн тохиргоог харах талаар дэлгэрэнгүйг "Viewing patch details" хэсгээс үзнэ үү.
Буцаах утга
| Атрибут | Төрөл | Тайлбар |
|---|---|---|
endpointId | String | Патч дутуу байгаа endpoint-ийн ID. |
name | String | Патчийн нэр. |
releaseDate | String | Патч гарсан огноо. |
bulletinUrl | String | Энэ патчтай холбоотой бюллетенийн URL. |
cves | Array of strings | Патчтай холбоотой CVE ID-уудын жагсаалт. |
kbNumber | String | Энэ патчтай холбоотой Microsoft Knowledge Base (KB) нийтлэл. |
vendorNames | Array of strings | Патчтай холбоотой вендоруудын жагсаалт. |
operatingSystem | Integer | Патч хамаарах үйлдлийн систем. Боломжит утгууд: 1 - Windows; 2 - Linux; 3 - Mac. |
type | Integer | Патчийн төрөл. Боломжит утгууд: 0 - Security patch; 1 - Non security patch; 2 - Manually approved patch. |
Жишээ
Хүсэлт:
Endpoint-уудын жагсаалтын патчуудыг авах хүсэлт:
{
"params": {
"filters":{
"type": 1
},
"page": 2
},
"jsonrpc": "2.0",
"method": "getMissingPatches",
"id": "301f7b05-ec02-481b-9ed6-c07b97de2b7b"
}Хариу:
{
"id": "301f7b05-ec02-481b-9ed6-c07b97de2b7b",
"jsonrpc": "2.0",
"result": {
"items": [
{
"endpointId": "67bc4a36bf64962c160eb6e0",
"name": "Windows6.0-SP2-KB973768-x64.msu",
"releaseDate": null,
"bulletinUrl": "http://technet.microsoft.com/security/bulletin/ms09-037",
"cves": [
"CVE-2008-0015",
"CVE-2009-0901",
"CVE-2009-2493",
"CVE-2009-2494",
"CVE-2008-0020"
],
"kbNumber": "Q973768",
"vendorNames": [
"Microsoft"
],
"operatingSystem": 1,
"type": 0
}
],
"total": 99,
"page": 1,
"perPage": 1,
"pagesCount": 99
}
}Энэ хуудсанд гарсан нэр томъёо
- Endpoint
- Хамгаалж буй компьютер, сервер, виртуал машин
