getInstalledPatches: суулгасан патчуудын жагсаалт авах API арга

Тодорхой endpoint-ууд эсвэл тодорхой компанитай холбоотой суулгасан патчуудын жагсаалтыг авахын тулд энэ аргыг ашиглана.

Ерөнхий параметрүүд

Эдгээр нь public API-ийн бүх аргад нийтлэг параметрүүд юм.

• id — хүсэлтэд: заавал; төрөл: String. Хүсэлтэд тодорхойлогч нэмж, түүнийг харгалзах хариутай холбоно. Хүсэлтийн зорилтот тал хариуд ижил утгыг буцаадаг тул дуудлагыг хялбар мөшгөнө. Нэмэлт шаардлага байхгүй. Жишээ: "id": "ad12cb61-52b3-4209-a87a-93a8530d91cb"
• method — хүсэлтэд: заавал; төрөл: String. Хүсэлт илгээхэд ашиглаж буй аргын нэр. Хүчинтэй аргын нэр байх ёстой. Жишээ: "method": "methodName"
• jsonrpc — хүсэлтэд: заавал; төрөл: Integer. Хүсэлт ба хариуд ашиглах JSON-RPC-ийн хувилбар. Цорын ганц боломжит утга нь 2.0. Жишээ: "jsonrpc": "2.0"
• params — хүсэлтэд: заавал; төрөл: Object. Хүсэлтийн тохиргоог агуулсан объект. Нэмэлт шаардлага байхгүй. Жишээ: "params": {...}
• params объект дотор:

- page — хүсэлтэд: заавал биш; төрөл: Integer. Үр дүнгийн хуудасны дугаар. Анхдагч утга: 1.
- perPage — хүсэлтэд: заавал биш; төрөл: Integer. Нэг хуудсанд харуулах үр дүнгийн тоо. Дээд хязгаар нь нэг хуудсанд 100 зүйл. Анхдагч утга: 30.

Параметрүүд

• endpointsIds — хүсэлтэд: заавал; төрөл: Array. Патчийн мэдээллийг авах endpoint-ийн ID. Нэмэлт шаардлага байхгүй. Жишээ: "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 — хүсэлтэд: заавал биш; төрөл: Integer. Хариунд оруулах патчийн эрсдлийн түвшин (severity). Боломжит утга:

- 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 — төрөл: патчийн төрөл. Патчийн төрөл. Боломжит утга:

- 0 — Security patch
- 1 — Non security patch
- 2 — Manually approved patch

Жишээ

Хүсэлт:

Тодорхой компанийн патчуудын жагсаалтыг авах хүсэлт:

  {
       "params": {
            "companyId": "67bc4346c9c8243e9c0f6314",
            "filters":{
                "type": 0,
                "severity": 1
            },
            "page": 1,
            "perPage": 5
       },
       "jsonrpc": "2.0",
       "method": "getInstalledPatches",
       "id": "301f7b05-ec02-481b-9ed6-c07b97de2b7b"
  }

Endpoint-уудын жагсаалтын патчуудыг авах хүсэлт:

 {
       "params": {
            "filters":{
                "type": 1
            },
            "page": 2
       },
       "jsonrpc": "2.0",
       "method": "getInstalledPatches",
       "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
    }
}