updatePatchManagementMaintenanceWindow API: maintenance window-г хэрхэн өөрчлөх вэ?

Bitdefender-ийн албан ёсны баримтаас орчуулавАнгли эх (EN) · Орчуулсан: 2026.11.12

Энэ хуудсыг AI-аар орчуулж, автоматаар шалгасан. Нарийн тохиргоо хийхээсээ өмнө англи эхтэй тулгаж болно.

Энэ method нь patch management-ийн maintenance window (засвар үйлчилгээний цонх)-ийг өөрчилнө.

Параметрүүд

name — Patch Management цонхонд өгөх нэр; хүсэлтэд: заавал; төрөл: String; боломжит утга:
- 1-ээс 80 тэмдэгтийн урттай байх ёстой.
- Давхцахгүй (өвөрмөц) байх ёстой.
- Жишээ: "name": "QXPzQWvgtqtI4FlCRSU9z"
allowChangeByOtherUsers — Зорилтот объект нь Customer company мөн эсэхийг заана; хүсэлтэд: заавал; төрөл: Boolean; нэмэлт шаардлага байхгүй.
- Жишээ: "allowChangeByOtherUsers": "1"
id — Maintenance window-ийн ID (params дотор, settings-ийн хажууд); хүсэлтэд: заавал; төрөл: String; нэмэлт шаардлага байхгүй.
- Жишээ: "id": "61974ab63bdfe97a6c34fe4d"
settings — Өөрчилж буй maintenance window-ийн Patch Management тохиргоог энэ массивт тохируулна; хүсэлтэд: заавал; төрөл: Array of objects; Objects хэсгийг үзнэ үү.
- Жишээ: "settings": { "downloadSettings": {...}, "installPatchesSettings": {...}, "scanPatchesSettings": {...} },

Objects

`downloadSettings`

cachingServers — Ашиглах patch caching server-үүдийг заана. Массив дахь байрлал нь тэргүүлэх эрэмбийг илтгэнэ; төрөл: Array of objects; дараах мэдээллийг агуулна:
- id - String, patch caching server-ийн ID.
fallbackOnDirectDownload — Direct Download тохиргоо идэвхтэй эсэхийг тодорхойлно; төрөл: Boolean; нэмэлт шаардлага байхгүй.

`installPatchesSettings`

enabled — Идэвхтэй үед patch автоматаар суулгагдах эсэхийг заана. GravityZone console дахь Apply patch унтраалгатай харгалзана; төрөл: Boolean; нэмэлт шаардлага байхгүй.
ifMissedRunAsSoonAsPossible — Даалгавар биелээгүй бол аль болох эрт дахин оролдохыг заана; төрөл: Boolean; нэмэлт шаардлага байхгүй.
specificVendorAndProduct — Patch суулгахад аль vendor болон бүтээгдэхүүнийг оруулах эсвэл хасахыг заана; төрөл: Object; дараах мэдээллийг агуулна:
- enabled - Оруулах эсвэл хасах тохиргоог зөвшөөрөх эсэхийг заана.
  Төрөл: Boolean
- type - Vendor эсвэл бүтээгдэхүүнийг patch-аас оруулах уу, хасах уу гэдгийг сонгоно.
  Төрөл: Integer
  Боломжит утга:
  - 1 - Include (оруулах),
  - 2 - Exclude (хасах).
- vendorProductsPairs - Бүтээгдэхүүн болон vendor-ийг сонгоход ашиглана.
  Төрөл: Array of objects
  Дэлгэрэнгүйг vendorProductsPairs хэсгээс үзнэ үү.
postponeReboot — Patch суулгасны дараах системийн дахин асаалтыг хойшлуулах эсэхийг заана; төрөл: Object; дараах мэдээллийг агуулна:
- option - Дахин асаалтыг хэрхэн хойшлуулахыг заана.
  Төрөл: Integer
  Боломжит утга:
  - 0 - Хэрэглэгч системийг дахин асаахыг илүү тохиромжтой цаг хүртэл хойшлуулж болно.
  - 1 - Хэрэглэгч системийг дахин асаахыг зөвхөн тодорхой цагийн завсарт хойшлуулж болно.
    Энэ утгыг өгвөл afterMinutes, afterCustomMessage, between шинж чанаруудыг хүсэлтэд заавал оруулна.
  - 2 - Систем тодорхой минутын дараа автоматаар дахин асна. Үүнийг сонговол postponeReboot object нь afterMinutes, afterCustomMessage-ийг мөн агуулсан байх ёстой.
    Энэ утгыг өгвөл afterMinutes болон afterCustomMessage шинж чанаруудыг хүсэлтэд заавал оруулна.
- afterMinutes - дахин асаалтыг хойшлуулах минутын тоо.
  Төрөл: Integer
  Боломжит утга: 10, 30, 45, 60.
- afterCustomMessage - Дахин асалт болох төгсгөлийн төхөөрөмж дээр харуулах текст.
  Төрөл: String
  Боломжит утга: 128 хүртэлх тэмдэгттэй дурын мөр.
- between - Дахин асалт болох цагийн завсар.
  Төрөл: Object
  Дэлгэрэнгүйг between хэсгээс үзнэ үү.
updateType — Security эсвэл non-security шинэчлэлтэд тусгайлсан тохиргоог идэвхжүүлж хэрэгжүүлнэ; төрөл: Object; дараах мэдээллийг агуулна:
- securityPatchesSettings - Security patch-уудыг идэвхжүүлж тохируулна.
  - enabled - Boolean, security patch ашиглахыг идэвхжүүлнэ.
  - scheduler - Тусгай хуваарь тохируулна.
    Төрөл: Object
    Энэ параметрийг дараах тохиолдолд object-д заавал оруулна:
    securityPatchesSettings object доторх enabled параметр true утгатай бол.
    scanPatchesSettings object доторх useSameScheduler параметр false утгатай бол.
    Энэ параметрийг дараах тохиолдолд үл тооно:
    scanPatchesSettings object доторх useSameScheduler параметр true утгатай бол.
    Дэлгэрэнгүйг scheduler хэсгээс үзнэ үү.
  - oldScheduler - Fallback системийг ашиглан тусгай хуваарь тохируулна.
    Төрөл: Object
    Энэ параметрийг дараах тохиолдолд object-д заавал оруулна:
    securityPatchesSettings object доторх enabled параметр true утгатай бол.
    scanPatchesSettings object доторх useSameScheduler параметр false утгатай бол.
    Энэ параметрийг дараах тохиолдолд үл тооно:
    scanPatchesSettings object доторх useSameScheduler параметр true утгатай бол.
    Дэлгэрэнгүйг oldScheduler хэсгээс үзнэ үү.
- nonSecurityPatchesSettings - Non-security patch-уудыг идэвхжүүлж тохируулна.
  - enabled - Boolean, non-security patch ашиглахыг идэвхжүүлнэ.
  - scheduler - Тусгай хуваарь тохируулна.
    Төрөл: Object
    Энэ параметрийг дараах тохиолдолд object-д заавал оруулна:
    nonSecurityPatchesSettings object доторх enabled параметр true утгатай бол.
    scanPatchesSettings object доторх useSameScheduler параметр false утгатай бол.
    Энэ параметрийг дараах тохиолдолд үл тооно:
    scanPatchesSettings object доторх useSameScheduler параметр true утгатай бол.
    Дэлгэрэнгүйг scheduler хэсгээс үзнэ үү.
  - oldScheduler - Fallback системийг ашиглан тусгай хуваарь тохируулна.
    Төрөл: Object
    Энэ параметрийг дараах тохиолдолд object-д заавал оруулна:
    nonSecurityPatchesSettings object доторх enabled параметр true утгатай бол.
    scanPatchesSettings object доторх useSameScheduler параметр false утгатай бол.
    Энэ параметрийг дараах тохиолдолд үл тооно:
    scanPatchesSettings object доторх useSameScheduler параметр true утгатай бол.
    Дэлгэрэнгүйг oldScheduler хэсгээс үзнэ үү.
- manuallyApprovedPatchesSettings - Гараар зөвшөөрсөн patch-уудыг идэвхжүүлж тохируулна.
  - enabled - Boolean, гараар зөвшөөрсөн patch ашиглахыг идэвхжүүлнэ.
  - scheduler - Тусгай хуваарь тохируулна.
    Төрөл: Object
    Энэ параметрийг дараах тохиолдолд object-д заавал оруулна:
    securityPatchesSettings object доторх enabled параметр false утгатай бол.
    scanPatchesSettings object доторх useSameScheduler параметр false утгатай бол.
    Энэ параметрийг дараах тохиолдолд үл тооно:
    scanPatchesSettings object доторх useSameScheduler параметр true утгатай бол.
    Дэлгэрэнгүйг scheduler хэсгээс үзнэ үү.
  - oldScheduler - Fallback системийг ашиглан тусгай хуваарь тохируулна.
    Төрөл: Object
    Энэ параметрийг дараах тохиолдолд object-д заавал оруулна:
    securityPatchesSettings object доторх enabled параметр false утгатай бол.
    scanPatchesSettings object доторх useSameScheduler параметр false утгатай бол.
    Энэ параметрийг дараах тохиолдолд үл тооно:
    scanPatchesSettings object доторх useSameScheduler параметр true утгатай бол.
    Дэлгэрэнгүйг oldScheduler хэсгээс үзнэ үү.
    Тэмдэглэл
    securityPatchesSettings object доторх enabled параметр true утгатай бол manuallyApprovedPatchesSettings доторх scheduler болон oldScheduler тохиргоог үл тооно.
    securityPatchesSettings object доторх enabled параметр болон scanPatchesSettings параметр доторх useFallbackSchedule тохиргоо хоёулаа false утгатай бол manuallyApprovedPatchesSettings доторх scheduler тохиргоог хүсэлтэд заавал оруулна.
    securityPatchesSettings object доторх enabled параметр false утгатай, мөн manuallyApprovedPatchesSettings доторх useFallbackSchedule тохиргоо true утгатай бол manuallyApprovedPatchesSettings доторх oldScheduler тохиргоог хүсэлтэд заавал оруулна.
manuallyApprovedPatchIds — Өвөрмөц patch ID-уудын жагсаалт; төрөл: Array of strings; patch ID-ууд хүчинтэй бөгөөд maintenance window үүсгэж буй компанид харьяалагдах ёстой.
- Зөвлөмж: Тодорхой компанийн гараар зөвшөөрсөн patch ID-уудын жагсаалтыг getManuallyApprovedPatches method-оор авч болно.

`vendorProductsPairs`

os — Vendor-бүтээгдэхүүний хос ямар үйлдлийн систем дээр нийцтэй вэ. Тодорхой vendor-бүтээгдэхүүний хос олон үйлдлийн системд нийцтэй үед энэ шинж чанарыг ашиглаж болно; төрөл: Integer. Боломжит утга:
- 1 - Windows
- 2 - Linux
- 3 - macOS
Анхдагч утга:
- vendor object-д харьяалагдах id шинж чанар зөвхөн цифр агуулж байвал 1.
- vendor object-д харьяалагдах id шинж чанар үсэг агуулж байвал 2.
Чухал
Энэ шинж чанарт өгөх утга хүсэлтэд заасан vendor-бүтээгдэхүүний хостой нийцтэй байх ёстой. Буруу хослол ашиглавал алдаа гарна.
vendor — Нэг буюу хэд хэдэн vendor оруулна; төрөл: Object. Object дараах шинж чанаруудыг агуулна:
- id - Vendor-ийн ID.
  Төрөл: String.
products — Нэг буюу хэд хэдэн бүтээгдэхүүн оруулна; төрөл: Array of objects. Object дараах шинж чанаруудыг агуулна:
- id - Бүтээгдэхүүний ID.
  Төрөл: String.

`between`

startHour — Үйл явдал эхлэх цаг; төрөл: Integer; 0-ээс 23 хүртэлх утгатай байж болно.
startMinute — Үйл явдал эхлэх минут; төрөл: Integer; 0-ээс 59 хүртэлх утгатай байж болно.
endHour — Үйл явдал дуусах цаг; төрөл: Integer; startHour-оос 23 хүртэлх утгатай байж болно.
endMinute — Үйл явдал дуусах минут; төрөл: Integer; 0-ээс 59 хүртэлх утгатай байж болно.

`scheduler`

recurrence — Тодорхой даалгаврын давтамжийг тохируулна; төрөл: Integer. Боломжит утга:
- 1 - тэр даруй.
- 3 - долоо хоног бүр. Энэ тохиолдолд weeklyRecurrence object-ийг мөн заавал оруулна.
  Энэ утгыг өгвөл object нь weeklyRecurrence параметрийг мөн агуулсан байх ёстой.
- 4 - сар бүр. Энэ тохиолдолд monthlyRecurrence object-ийг мөн заавал оруулна.
  Энэ утгыг сонговол object нь monthlyRecurrence параметрийг мөн агуулсан байх ёстой.
startDate — Одоогийн өдрийг сонгосон бол одоогийн epoch цагийг (10 оронтой, секундийн нарийвчлалтай) заана; төрөл: Integer. 0-ээс их утга байх ёстой.
between — Даалгавар ажиллах цагийн завсрыг тохируулна; төрөл: Object. Дэлгэрэнгүйг between хэсгээс үзнэ үү.
weeklyRecurrence — Долоо хоног бүрийн даалгаврын давтамжийг тодорхойлно. Энэ параметр зөвхөн recurrence нь 3 үед боломжтой; төрөл: Object. Дараах мэдээллийг агуулна:
- every - Даалгавруудын хоорондох хугацааг долоо хоногоор заана.
  Төрөл: Integer
  Боломжит утга: 1 - 4.
- days - Даалгаврыг долоо хоногийн тодорхой өдөр давтахаар тохируулна.
  Төрөл: Array of Integers
  Боломжит утга: 0 (Ням) - 6 (Бямба).
monthlyRecurrence — Сар бүрийн даалгаврын давтамжийг тодорхойлно. Энэ параметр зөвхөн recurrence нь 4 үед боломжтой; төрөл: Object. Дараах мэдээллийг агуулна:
- every - Даалгавруудын хоорондох хугацааг сараар заана.
  Төрөл: Integer
  Боломжит утга: 1 - 12.
- frequency - Давтагдах даалгаврын давтамжийг заана.
  Төрөл: Integer
  Боломжит утга:
  - 0 - сарын тодорхой өдөр ажиллана.
    Энэ утгыг өгвөл object нь frequencyDayNumber параметрийг заавал агуулна.
    Тэмдэглэл
    frequency-ийн утга 0 бол monthlyRecurrence object
  - 1 - сар доторх долоо хоногийн эхний frequencyDayOfWeek дээр ажиллана.
  - 2 - сар доторх долоо хоногийн хоёр дахь frequencyDayOfWeek дээр ажиллана.
  - 3 - сар доторх долоо хоногийн гурав дахь frequencyDayOfWeek дээр ажиллана.
  - 4 - сар доторх долоо хоногийн дөрөв дэх frequencyDayOfWeek дээр ажиллана.
  - 5 - сар доторх долоо хоногийн сүүлийн frequencyDayOfWeek дээр ажиллана.
    Тэмдэглэл
    frequency-ийн утга 1, 2, 3, 4 эсвэл 5 бол object нь frequencyDayOfWeek параметрийг заавал агуулна.
- frequencyDayNumber - Даалгавар сарын аль өдөр ажиллахыг заана.
  Төрөл: Integer
  Боломжит утга: 1 - 31
- frequencyDayOfWeek - Даалгавар долоо хоногийн аль өдөр ажиллахыг заана.
  Төрөл: Integer
  Боломжит утга: 0 (Ням) - 6 (Бямба).

`oldScheduler`

recurrence — Даалгавар ажиллах давтамжийг тохируулна; төрөл: Integer. Боломжит утга:
- 1 - тэр даруй
- 2 - өдөр бүр
- 3 - долоо хоног бүр
startHour — Үйл явдал эхлэх цаг; төрөл: Integer; боломжит утга: 0 - 23.
startMinute — Үйл явдал эхлэх минут; төрөл: Integer; боломжит утга: 0 - 59.
days — Даалгаврыг долоо хоногийн тодорхой өдөр давтахаар тохируулна; төрөл: Array of Integers. Боломжит утга: 0 (Ням) - 6 (Бямба).

`scanPatchesSettings`

enabled — Шинэ patch хайх шалгалт автоматаар хийгдэх эсэхийг заана. GravityZone console дахь Scan for patches унтраалгатай харгалзана; төрөл: Boolean; нэмэлт шаардлага байхгүй.
runOnSystemChanges — Дэмжигдсэн шинэ программ суулгах бүрд боломжит patch-уудыг шалгах эсэхийг заана. GravityZone console дахь Smart scan for patches when new applications are installed унтраалгатай харгалзана; төрөл: Boolean; нэмэлт шаардлага байхгүй.
useFallbackSchedule — Одоогийн хуваарийн систем (schedule) ба fallback (oldScheduler)-ийн хооронд сэлгэнэ; төрөл: String. Боломжит утга:
- enabled - oldScheduler параметрийг installPatchesSettings-д заавал оруулна.
- disabled - scheduler параметрийг installPatchesSettings-д заавал оруулна.
useSameSchedule — Энэ хуваарийг бүх даалгаврын анхдагч болгоно. GravityZone console дахь Use the same schedule for all targeted operations унтраалгатай харгалзана; төрөл: Boolean; нэмэлт шаардлага байхгүй.
scheduler — Тусгай хуваарь тохируулна; төрөл: Objects. Дараах мэдээллийг агуулна:
- recurrence - Integer, тодорхой даалгаврын давтамжийг тохируулна. Дараах утгуудын аль нэгийг авч болно:
  - 3 - долоо хоног бүр. Энэ тохиолдолд weeklyRecurrence object-ийг мөн заавал оруулна.
  - 4 - сар бүр. Энэ тохиолдолд monthlyRecurrence object-ийг мөн заавал оруулна.
- startDate - Integer, одоогийн өдрийг сонгосон бол одоогийн epoch цагийг (10 оронтой, секундийн нарийвчлалтай) заана. 0-ээс их утга байх ёстой.
- between - Object, даалгавар ажиллах цагийн завсрыг тохируулна. Бүрэлдэхүүн:
  - startHour - Integer, 0-ээс 23 хооронд
  - startMinute - Integer, 0-ээс 59 хооронд
  - endHour - Integer, startHour-оос 23 хооронд
  - endMinute - Integer, 0-ээс 59 хооронд
  Тэмдэглэл
  startHour:startMinute нь endHour:endMinute-ээс бага байх ёстой.
- weeklyRecurrence - Object, recurrence = 3 бол заавал. Бүрэлдэхүүн:
  - every - Integer, утгын хүрээ 1-ээс 4. Даалгавруудын хоорондох хугацааг долоо хоногоор заана.
  - days - Integer array, утгын хүрээ 0-ээс 6 (0 нь Ням, 6 нь Бямба). Даалгаврыг долоо хоногийн тодорхой өдөр давтахаар тохируулна.
- monthlyRecurrence - Object, recurrence = 4 бол заавал. Бүрэлдэхүүн:
  - every - Integer, утгын хүрээ 1-ээс 12. Даалгавруудын хоорондох хугацааг сараар заана.
  - frequency - Integer, давтагдах даалгаврын давтамжийг заана. Дараах утгуудын аль нэгийг авч болно:
    0 - тодорхой өдөр ажиллана
    1 - сар доторх долоо хоногийн эхний frequencyDayOfWeek дээр ажиллана.
    2 - сар доторх долоо хоногийн хоёр дахь frequencyDayOfWeek дээр ажиллана.
    3 - сар доторх долоо хоногийн гурав дахь frequencyDayOfWeek дээр ажиллана.
    4 - сар доторх долоо хоногийн дөрөв дэх frequencyDayOfWeek дээр ажиллана.
    5 - сар доторх долоо хоногийн сүүлийн frequencyDayOfWeek дээр ажиллана.
    Тэмдэглэл
    frequency-ийн утга 0 бол monthlyRecurrence object нь frequencyDayNumber-ийг мөн агуулах ёстой. frequency-ийн утга 1, 2, 3, 4 эсвэл 5 бол monthlyRecurrence object нь frequencyDayOfWeek-ийг мөн агуулах ёстой.
  - frequencyDayNumber - Integer, даалгавар сарын аль өдөр ажиллахыг заана. Утга 1-ээс 31 хооронд байна.
  - frequencyDayOfWeek - Integer, даалгавар долоо хоногийн аль өдөр ажиллахыг заана. Утга 0-ээс 6 хооронд, 0 нь Sunday (Ням), 6 нь Saturday (Бямба).
  Тэмдэглэл
  enabled = true ба useFallbackSchedule = false үед заавал оруулна.
oldScheduler — Fallback системийг ашиглан тусгай хуваарь тохируулна; төрөл: Object; дараах мэдээллийг агуулна:
- recurrence - Integer, даалгавар ажиллах давтамжийг тохируулна. Дараах утгуудын аль нэгийг авч болно:
  - 2 - өдөр бүр
  - 3 - долоо хоног бүр
- startHour - Integer. 0-ээс 23 хооронд утгатай байж болно.
- startMinute - Integer. 0-ээс 59 хооронд утгатай байж болно.
- days - Integer array, утгын хүрээ 0-ээс 6 (0 нь Ням, 6 нь Бямба). Даалгаврыг долоо хоногийн тодорхой өдөр давтахаар тохируулна.
Тэмдэглэл
enabled = true үед заавал оруулна. recurrence = 2 бол үл тооно.

Буцаах утга

Энэ method нь maintenance window амжилттай шинэчлэгдсэн эсэхийг заасан true эсвэл false утга буцаана.

Жишээ

Хүсэлт:

{
  "method": "updatePatchManagementMaintenanceWindow",
  "id": "a7f1d11d-3c94-47f0-a599-b48d2fc44241",
  "jsonrpc": "2.0",
  "params": {
    "id": "61974ab63bdfe97a6c34fe4d",
    "settings": {
      "downloadSettings": {
        "cachingServers": [

        ],
        "fallbackOnDirectDownload": true
      },
      "installPatchesSettings": {
        "enabled": true,
        "ifMissedRunAsSoonAsPossible": true,
        "specificVendorAndProduct": {
          "type": 1,
          "enabled": false,
          "vendorProductsPairs": [
                        {
                            "os": 3,
                            "vendor": {
                                "id": "Oracle"
                            },
                            "products": [
                                {
                                    "id": "java-11-openjdk 11"
                                },
                                {
                                    "id": "java-1.8.0-openjdk"
                                }
                            ]
                        },
                        {
                            "vendor": {
                                "id": "Inkscape"
                            },
                            "products": [
                                {
                                    "id": "0"
                                }
                            ]
                        },
                        {
                            "vendor": {
                                "id": "65"
                            },
                            "products": [
                                {
                                    "id": "15694"
                                }
                            ]
                        }
          ]
        },
        "postponeReboot": {
          "option": 0
        },
        "updateType": {
          "nonSecurityPatchesSettings": {
            "enabled": true,
            "scheduler": {
              "recurrence": 3,
              "startDate": 1637258826,
              "between": {
                "startHour": 21,
                "startMinute": 0,
                "endHour": 23,
                "endMinute": 59
              },
              "weeklyRecurrence": {
                "every": 1,
                "days": [
                  1,
                  2,
                  3,
                  4,
                  5,
                  6,
                  0
                ]
              }
            },
          },
          "securityPatchesSettings": {
            "enabled": true,
            "scheduler": {
              "recurrence": 1
            },
          "manuallyApprovedPatchesSettings": {
            "enabled": True,
            "scheduler": {
            "recurrence": 1
            }
          }
        }
        "manuallyApprovedPatchIds": [
          "{00016C6E-0000-0000-0000-000000000000}",
          "{0001354A-0000-0000-0000-000000000000}"
        ]
      },
      "scanPatchesSettings": {
        "enabled": true,
        "useSameSchedule": false,
        "useFallbackSchedule": true,
        "runOnSystemChanges": true,
        "scheduler": {
          "recurrence": 3,
          "startDate": 1637258826,
          "between": {
            "startHour": 21,
            "startMinute": 0,
            "endHour": 23,
            "endMinute": 59
          },
          "weeklyRecurrence": {
            "every": 1,
            "days": [
              1,
              2,
              3,
              4,
              5,
              6,
              0
            ]
          }
        },
      }
    }
  }
}

Хариу:

{
   "id" : "a7f1d11d-3c94-47f0-a599-b48d2fc44241",
   "jsonrpc" : "2.0",
   "result" : {
      "success" : true
   }
}

Энэ хуудсанд гарсан нэр томъёо

Patch Management: Программын шинэчлэлтийг (patch) төвлөрсөн байдлаар суулгах нэмэлт модуль

Асуулт байна уу?AI туслах GravityZone-ийн монгол баримтаас хайна. Нарийн асуудлыг таны гэрээт борлуулагч, Bitdefender Mongolia-ийн инженер шийднэ.