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

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

Параметрүүд

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

Объектууд

downloadSettings

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

installPatchesSettings

• `enabled` — Boolean; идэвхжүүлсэн үед patch автоматаар хэрэгжих эсэхийг заана. GravityZone console дахь Apply patch унтраалгатай тохирно. Нэмэлт шаардлагагүй.
• `ifMissedRunAsSoonAsPossible` — Boolean; таск гүйцэтгэгдээгүй бол аль болох түргэн дахин оролдохыг заана. Нэмэлт шаардлагагүй.
• `specificVendorAndProduct` — Object; patch хийх үед оруулах эсвэл хасах vendor болон бүтээгдэхүүнийг заана. Дараахыг агуулна:

- enabled — оруулах эсвэл хасах тохиргоог зөвшөөрөх эсэхийг заана. Төрөл: Boolean.
- type — vendor эсвэл бүтээгдэхүүнийг patch хийхээс оруулах уу, хасах уу гэдгийг сонгоно. Төрөл: Integer. Боломжит утга: 1 — оруулах (Include), 2 — хасах (Exclude).
- vendorProductsPairs — бүтээгдэхүүн болон vendor-уудыг сонгоход ашиглана. Төрөл: Array of objects. Дэлгэрэнгүйг доорх vendorProductsPairs хэсгээс үзнэ үү.

• `postponeReboot` — Object; patch хэрэглэсний дараах системийн дахин асаалтыг хойшлуулах эсэхийг заана. Дараахыг агуулна:

- option — дахин асаалтыг хэрхэн хойшлуулахыг заана. Төрөл: Integer. Боломжит утга:
- 0 — хэрэглэгчид системийн дахин асаалтыг илүү тохиромжтой цаг хүртэл хойшлуулж болно.
- 1 — хэрэглэгчид системийн дахин асаалтыг зөвхөн тодорхой интервалын дотор хойшлуулж болно. Энэ утгыг оноосон бол afterMinutes, afterCustomMessage, between атрибутыг хүсэлтэд заавал оруулна.
- 2 — систем тодорхой минутын дараа автоматаар дахин асна. Энэ утгыг сонгосон бол postponeReboot объект нь afterMinutes, afterCustomMessage-ийг мөн агуулах ёстой. Энэ утгыг оноосон бол afterMinutes, afterCustomMessage атрибутыг хүсэлтэд заавал оруулна.
- afterMinutes — дахин асаалтыг хойшлуулах минутын тоо. Төрөл: Integer. Боломжит утга: 10, 30, 45, 60.
- afterCustomMessage — дахин асах endpoint дээр харуулах текст. Төрөл: String. Боломжит утга: хамгийн ихдээ 128 тэмдэгттэй дурын мөр.
- between — дахин асалт хийгдэх цагийн интервал. Төрөл: Object. Дэлгэрэнгүйг доорх between хэсгээс үзнэ үү.

• `updateType` — Object; аюулгүй байдлын (security) болон аюулгүй байдлын бус (non-security) шинэчлэлтүүдэд тусгай тохиргоог идэвхжүүлж, хэрэглэхэд ашиглана. Дараахыг агуулна:

- securityPatchesSettings — security patch-уудыг идэвхжүүлж, тохируулна.
- enabled — Boolean, security patch ашиглахыг идэвхжүүлнэ.
- scheduler — тодорхой хуваарь тохируулна. Төрөл: Object. Энэ параметрийг дараах тохиолдолд объектод заавал оруулна: securityPatchesSettings объект доторх enabled параметр true утгатай бол; scanPatchesSettings объект доторх useSameScheduler параметр false утгатай бол. Дараах тохиолдолд энэ параметрийг үл тооно: scanPatchesSettings объект доторх useSameScheduler параметр true утгатай бол. Дэлгэрэнгүйг доорх scheduler хэсгээс үзнэ үү.
- oldScheduler — fallback системээр тодорхой хуваарь тохируулна. Төрөл: Object. Энэ параметрийг дараах тохиолдолд объектод заавал оруулна: securityPatchesSettings объект доторх enabled параметр true утгатай бол; scanPatchesSettings объект доторх useSameScheduler параметр false утгатай бол. Дараах тохиолдолд энэ параметрийг үл тооно: scanPatchesSettings объект доторх useSameScheduler параметр true утгатай бол. Дэлгэрэнгүйг доорх oldScheduler хэсгээс үзнэ үү.
- nonSecurityPatchesSettings — non-security patch-уудыг идэвхжүүлж, тохируулна.
- enabled — Boolean, non-security patch ашиглахыг идэвхжүүлнэ.
- scheduler — тодорхой хуваарь тохируулна. Төрөл: Object. Энэ параметрийг дараах тохиолдолд объектод заавал оруулна: nonSecurityPatchesSettings объект доторх enabled параметр true утгатай бол; scanPatchesSettings объект доторх useSameScheduler параметр false утгатай бол. Дараах тохиолдолд энэ параметрийг үл тооно: scanPatchesSettings объект доторх useSameScheduler параметр true утгатай бол. Дэлгэрэнгүйг доорх scheduler хэсгээс үзнэ үү.
- oldScheduler — fallback системээр тодорхой хуваарь тохируулна. Төрөл: Object. Энэ параметрийг дараах тохиолдолд объектод заавал оруулна: nonSecurityPatchesSettings объект доторх enabled параметр true утгатай бол; scanPatchesSettings объект доторх useSameScheduler параметр false утгатай бол. Дараах тохиолдолд энэ параметрийг үл тооно: scanPatchesSettings объект доторх useSameScheduler параметр true утгатай бол. Дэлгэрэнгүйг доорх oldScheduler хэсгээс үзнэ үү.
- manuallyApprovedPatchesSettings — гараар батлагдсан patch-уудыг идэвхжүүлж, тохируулна.
- enabled — Boolean, гараар батлагдсан patch ашиглахыг идэвхжүүлнэ.
- scheduler — тодорхой хуваарь тохируулна. Төрөл: Object. Энэ параметрийг дараах тохиолдолд объектод заавал оруулна: securityPatchesSettings объект доторх enabled параметр false утгатай бол; scanPatchesSettings объект доторх useSameScheduler параметр false утгатай бол. Дараах тохиолдолд энэ параметрийг үл тооно: scanPatchesSettings объект доторх useSameScheduler параметр true утгатай бол. Дэлгэрэнгүйг доорх scheduler хэсгээс үзнэ үү.
- oldScheduler — fallback системээр тодорхой хуваарь тохируулна. Төрөл: Object. Энэ параметрийг дараах тохиолдолд объектод заавал оруулна: securityPatchesSettings объект доторх enabled параметр false утгатай бол; scanPatchesSettings объект доторх useSameScheduler параметр false утгатай бол. Дараах тохиолдолд энэ параметрийг үл тооно: scanPatchesSettings объект доторх useSameScheduler параметр true утгатай бол. Дэлгэрэнгүйг доорх oldScheduler хэсгээс үзнэ үү.
- Тэмдэглэл: securityPatchesSettings объект доторх enabled параметр true утгатай бол manuallyApprovedPatchesSettings доторх scheduler, oldScheduler тохиргоог үл тооно. securityPatchesSettings объект доторх enabled параметр болон scanPatchesSettings параметр доторх useFallbackSchedule тохиргоо хоёулаа false бол manuallyApprovedPatchesSettings доторх scheduler тохиргоог хүсэлтэд заавал оруулна. securityPatchesSettings объект доторх enabled параметр false, manuallyApprovedPatchesSettings доторх useFallbackSchedule тохиргоо true бол manuallyApprovedPatchesSettings доторх oldScheduler тохиргоог хүсэлтэд заавал оруулна.

• `manuallyApprovedPatchIds` — Array of strings; patch-уудын өвөрмөц ID-ийн жагсаалт. Patch ID-ууд хүчинтэй байх ба maintenance window-ийг үүсгэж буй компанид харьяалагдах ёстой. Зөвлөмж: тодорхой компанийн гараар батлагдсан patch-уудын ID-ийн жагсаалтыг getManuallyApprovedPatches method-оор авч болно.

vendorProductsPairs

• `os` — Integer; vendor-бүтээгдэхүүний хос тохирох үйлдлийн систем. Тодорхой vendor-бүтээгдэхүүний хос олон үйлдлийн системтэй тохирох үед энэ атрибутыг ашиглаж болно. Боломжит утга: 1 — Windows; 2 — Linux; 3 — macOS. Анхдагч утга: vendor объектод харьяалагдах id атрибут зөвхөн тооноос тогтвол 1; vendor объектод харьяалагдах id атрибут үсэг агуулсан бол 2. Чухал: энэ атрибутад өгөх утга хүсэлтэд заасан vendor-бүтээгдэхүүний хостой тохирч байх ёстой. Буруу хослол ашиглавал алдаа гарна.
• `vendor` — Object; нэг буюу хэд хэдэн vendor оруулна. Объект дараах атрибутыг агуулна: id — vendor-ийн ID. Төрөл: String.
• `products` — Array of objects; нэг буюу хэд хэдэн бүтээгдэхүүн оруулна. Объект дараах атрибутыг агуулна: 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 объектыг мөн оруулна); 4 — сар бүр (энэ үед monthlyRecurrence объектыг мөн оруулна).
• `startDate` — Integer; тухайн өдрийг сонгосон бол одоогийн epoch цагийг (10 оронтой, секундийн нарийвчлалтай) заана. 0-ээс их утга байх ёстой.
• `between` — Object; таск ажиллах цагийн интервалыг тохируулна. Дэлгэрэнгүйг дээрх between хэсгээс үзнэ үү.
• `weeklyRecurrence` — Object; долоо хоног бүрийн таскийн давтамжийг тодорхойлно. Энэ параметр зөвхөн recurrence нь 3 үед боломжтой. Дараахыг агуулна:

- every — таскуудын хоорондох хугацааг долоо хоногоор тохируулна. Төрөл: Integer. Боломжит утга: 1 – 4.
- days — таскийг долоо хоногийн тодорхой өдөр давтахаар тохируулна. Төрөл: Array of Integers. Боломжит утга: 0 (Ням) – 6 (Бямба).

• `monthlyRecurrence` — Object; сар бүрийн таскийн давтамжийг тодорхойлно. Энэ параметр зөвхөн recurrence нь 4 үед боломжтой. Дараахыг агуулна:

- every — таскуудын хоорондох хугацааг сараар тохируулна. Төрөл: Integer. Боломжит утга: 1 – 12.
- frequency — давтагдах таскийн давтамжийг тохируулна. Төрөл: Integer. Боломжит утга:
- 0 — сарын тодорхой өдөр ажиллана. Энэ утгыг оноосон бол объект frequencyDayNumber параметрийг заавал агуулна.
- 1 — сарын эхний frequencyDayOfWeek өдөр ажиллана.
- 2 — сарын хоёрдугаар frequencyDayOfWeek өдөр ажиллана.
- 3 — сарын гуравдугаар frequencyDayOfWeek өдөр ажиллана.
- 4 — сарын дөрөвдүгээр frequencyDayOfWeek өдөр ажиллана.
- 5 — сарын сүүлийн frequencyDayOfWeek өдөр ажиллана.
- Тэмдэглэл: frequency-ийн утга 0 бол объект frequencyDayNumber параметрийг агуулах ёстой. frequency-ийн утга 1, 2, 3, 4 эсвэл 5 бол объект 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` — Boolean; шинэ patch хайх шалгалтыг автоматаар хийх эсэхийг заана. GravityZone console дахь Scan for patches унтраалгатай тохирно. Нэмэлт шаардлагагүй.
• `runOnSystemChanges` — Boolean; дэмжигдсэн шинэ программ суулгах бүрд боломжит patch-уудыг шалгах эсэхийг заана. GravityZone console дахь Smart scan for patches when new applications are installed унтраалгатай тохирно. Нэмэлт шаардлагагүй.
• `useFallbackSchedule` — String; одоогийн хуваарийн систем (schedule) болон fallback (oldScheduler)-ийн хооронд шилжүүлнэ. Боломжит утга: enabled — oldScheduler параметрийг installPatchesSettings дотор заавал оруулна; disabled — scheduler параметрийг installPatchesSettings дотор заавал оруулна.
• `useSameSchedule` — Boolean; энэ хуваарийг бүх таскийн үндсэн хуваарь болгоно. GravityZone console дахь Use the same schedule for all targeted operations унтраалгатай тохирно. Нэмэлт шаардлагагүй.
• `scheduler` — Objects; тодорхой хуваарь тохируулна. Дараахыг агуулна:

- recurrence — Integer, тодорхой таскийн давтамжийг тохируулна. Дараах утгуудын аль нэгийг авч болно: 3 — долоо хоног бүр (энэ үед weeklyRecurrence объектыг мөн оруулна); 4 — сар бүр (энэ үед monthlyRecurrence объектыг мөн оруулна).
- 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 массив, 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 объект frequencyDayNumber-ийг мөн агуулах ёстой. frequency-ийн утга 1, 2, 3, 4 эсвэл 5 бол monthlyRecurrence объект frequencyDayOfWeek-ийг мөн агуулах ёстой.
- frequencyDayNumber — Integer, таск сарын хэддэх өдөр ажиллахыг заана. Утга нь 1-ээс 31 хүртэл.
- frequencyDayOfWeek — Integer, таск долоо хоногийн аль өдөр ажиллахыг заана. Утга нь 0-ээс 6 хүртэл, 0 нь Sunday (Ням), 6 нь Saturday (Бямба).
- Тэмдэглэл: enabled = true ба useFallbackSchedule = false бол заавал оруулна.

• `oldScheduler` — Object; fallback системээр тодорхой хуваарь тохируулна. Дараахыг агуулна:

- recurrence — Integer, таск ажиллах давтамжийг тохируулна. Дараах утгуудын аль нэгийг авч болно: 2 — өдөр бүр; 3 — долоо хоног бүр.
- startHour — Integer. 0-ээс 23 хүртэл утгатай байж болно.
- startMinute — Integer. 0-ээс 59 хүртэл утгатай байж болно.
- days — Integer массив, 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
   }
}