az aks maintenancewindow
Note
Ez a hivatkozás a Azure CLI aks-preview bővítményének része (2.85.0-s vagy újabb verzió). A bővítmény automatikusan telepíti az az aks maintenancewindow parancs első futtatásakor. További információ a bővítményekről.
A MaintenanceWindow társ ARM-erőforrások kezelésére szolgáló parancsok.
A MaintenanceWindow egy erőforráscsoport-hatókörű ARM-erőforrás, amely egy újrafelhasználható karbantartási ütemezést határoz meg. A felhasználók összekapcsolhatják ezt az erőforrást egy már meglévő karbantartási konfigurációval maintenanceWindowId, így több managedCluster karbantartási konfiguráció egyetlen MaintenanceWindow-ban osztozik, és az ütemezés egy helyen található.
A Microsoft szükséges. Az előfizetésben regisztrálandó ContainerService/AKSSharedMaintenanceWindowPreview funkció. Az automatikus jóváhagyás engedélyezve van: az feature register --namespace Microsoft.ContainerService --name AKSSharedMaintenanceWindowPreview.
Parancsok
| Name | Description | Típus | Állapot |
|---|---|---|---|
| az aks maintenancewindow create |
Hozzon létre egy MaintenanceWindow-t. |
Extension | GA |
| az aks maintenancewindow delete |
Törölje a MaintenanceWindow parancsot. |
Extension | GA |
| az aks maintenancewindow list |
A MaintenanceWindows listázása egy erőforráscsoportban vagy az előfizetésen belül, ha a --resource-group nincs megadva. |
Extension | GA |
| az aks maintenancewindow show |
MaintenanceWindow megjelenítése. |
Extension | GA |
| az aks maintenancewindow update |
Frissítsen egy MaintenanceWindow-t. |
Extension | GA |
| az aks maintenancewindow wait |
Várjon, amíg a MaintenanceWindow eléri a kívánt állapotot. |
Extension | GA |
az aks maintenancewindow create
Hozzon létre egy MaintenanceWindow-t.
A Microsoft szükséges. Az előfizetésben regisztrálandó ContainerService/AKSSharedMaintenanceWindowPreview funkció. Regisztráljon egyszer (automatikusan jóváhagyva): az feature register --namespace Microsoft.ContainerService --name AKSSharedMaintenanceWindowPreview.
az aks maintenancewindow create --name
--resource-group
[--acquire-policy-token]
[--change-reference]
[--config-file]
[--day-of-month]
[--day-of-week]
[--duration]
[--interval-days]
[--interval-months]
[--interval-weeks]
[--location]
[--no-wait]
[--schedule-type {AbsoluteMonthly, Daily, RelativeMonthly, Weekly}]
[--start-date]
[--start-time]
[--tags]
[--utc-offset]
[--week-index {First, Fourth, Last, Second, Third}]
Példák
Hozzon létre egy heti szombati ablakot (a canonical "production weekends" formát).
az aks maintenancewindow create -g rg-maintenance -n production-weekends -l eastus \
--schedule-type Weekly --day-of-week Saturday --interval-weeks 1 \
--start-time "02:00" --duration 8 --utc-offset=-07:00 \
--tags environment=production
Hozzon létre egy napi ablakot 2 naponta egy adott kezdési dátumtól kezdve.
az aks maintenancewindow create -g rg-maintenance -n nightly -l eastus \
--schedule-type Daily --interval-days 2 \
--start-date 2026-06-01 --start-time "00:00" --duration 6 --utc-offset=-08:00
Hozzon létre egy abszolút havi ablakot 15-én.
az aks maintenancewindow create -g rg-maintenance -n monthly-15 -l eastus \
--schedule-type AbsoluteMonthly --day-of-month 15 --interval-months 1 \
--start-time "09:30" --duration 6 --utc-offset=+05:30
Hozzon létre egy relatív havi ablakot az elmúlt pénteken.
az aks maintenancewindow create -g rg-maintenance -n last-friday -l eastus \
--schedule-type RelativeMonthly --day-of-week Friday --week-index Last --interval-months 1 \
--start-time "01:00" --duration 4 --utc-offset=+00:00
Hozzon létre egy heti ablakot az elsötétítési dátumokkal egy konfigurációs fájlon keresztül.
az aks maintenancewindow create -g rg-maintenance -n weekly-with-holidays -l eastus \
--config-file ./mw-body.json
The contents of mw-body.json:
{
"properties": {
"schedule": { "weekly": { "intervalWeeks": 1, "dayOfWeek": "Saturday" } },
"startTime": "02:00",
"durationHours": 8,
"utcOffset": "-07:00",
"notAllowedDates": [
{ "start": "2026-12-23", "end": "2027-01-05" },
{ "start": "2026-07-04", "end": "2026-07-05" }
]
}
}
Kötelező paraméterek
A karbantartási időszak neve.
Az erőforráscsoport neve. Az alapértelmezett csoportot a az configure --defaults group=<name>használatával konfigurálhatja.
Opcionális paraméterek
Az alábbi paraméterek megadása nem kötelező, de a környezettől függően előfordulhat, hogy a parancs sikeres végrehajtásához egy vagy több is szükséges lehet.
Az erőforrásművelethez automatikusan beszerez egy Azure Policy-jogkivonatot.
| Tulajdonság | Érték |
|---|---|
| Paramétercsoport: | Global Policy Arguments |
Az erőforrásművelet kapcsolódó változáshivatkozás-azonosítója.
| Tulajdonság | Érték |
|---|---|
| Paramétercsoport: | Global Policy Arguments |
A MaintenanceWindow törzset leíró JSON-fájl elérési útja. Akkor használja, ha dedikált jelölők nélkül kell mezőket beállítania (pl. notAllowedDates /blackout date ranges).
A karbantartás hónapjának napja. például 15. Csak AbsoluteMonthly ütemezés.
A karbantartás a hét napján történik. például hétfő. Heti vagy RelativeMonthly ütemezések csak.
A karbantartási időszak hossza órákban. Tartomány: 4-24.
Az előfordulások közötti napok száma. Csak napi ütemezés.
Az előfordulások közötti hónapok száma. Az AbsoluteMonthly vagy a RelativeMonthly ütemezés csak.
Az előfordulások közötti hetek száma. Csak heti ütemezés.
A MaintenanceWindow helye. Az erőforráscsoport helyének alapértelmezett értéke, ha nincs megadva.
Ne várja meg, amíg a hosszú ideig futó művelet befejeződik.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | False |
Ismétlődés típusa. Az egyik napi, heti, absolutemonthly vagy RelativeMonthly.
| Tulajdonság | Érték |
|---|---|
| Elfogadott értékek: | AbsoluteMonthly, Daily, RelativeMonthly, Weekly |
A karbantartási időszak aktiválásának dátuma. pl. 2026-06-01. Ha nincs megadva, az ablak azonnal aktiválódik.
A karbantartási időszak kezdő időpontja. Az elfogadott értékek 00:00 és 23:59 között vannak. --utc-offset vonatkozik erre a mezőre.
Szóközzel elválasztott címkék: key[=value] [key[=value] ...]. Meglévő címkék törlése a "" használatával.
Az UTC eltolás formátuma +/-HH:mm. Például a "+05:30" az IST-hez vagy a "-07:00" a PST-hez. Az alapértelmezett érték a "+00:00".
A karbantartás a hét napjának példánya (első, második, harmadik, negyedik, utolsó). Csak RelativeMonthly ütemezés.
| Tulajdonság | Érték |
|---|---|
| Elfogadott értékek: | First, Fourth, Last, Second, Third |
Globális paraméterek
Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | False |
Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
Csak a hibák megjelenítése, a figyelmeztetések mellőzése.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | False |
Kimeneti formátum.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | json |
| Elfogadott értékek: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .
Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a az account set -s NAME_OR_IDhasználatával konfigurálhatja.
A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | False |
az aks maintenancewindow delete
Törölje a MaintenanceWindow parancsot.
az aks maintenancewindow delete --name
--resource-group
[--acquire-policy-token]
[--change-reference]
[--no-wait]
[--yes]
Kötelező paraméterek
A karbantartási időszak neve.
Az erőforráscsoport neve. Az alapértelmezett csoportot a az configure --defaults group=<name>használatával konfigurálhatja.
Opcionális paraméterek
Az alábbi paraméterek megadása nem kötelező, de a környezettől függően előfordulhat, hogy a parancs sikeres végrehajtásához egy vagy több is szükséges lehet.
Az erőforrásművelethez automatikusan beszerez egy Azure Policy-jogkivonatot.
| Tulajdonság | Érték |
|---|---|
| Paramétercsoport: | Global Policy Arguments |
Az erőforrásművelet kapcsolódó változáshivatkozás-azonosítója.
| Tulajdonság | Érték |
|---|---|
| Paramétercsoport: | Global Policy Arguments |
Ne várja meg, amíg a hosszú ideig futó művelet befejeződik.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | False |
Ne kérje a megerősítést.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | False |
Globális paraméterek
Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | False |
Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
Csak a hibák megjelenítése, a figyelmeztetések mellőzése.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | False |
Kimeneti formátum.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | json |
| Elfogadott értékek: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .
Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a az account set -s NAME_OR_IDhasználatával konfigurálhatja.
A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | False |
az aks maintenancewindow list
A MaintenanceWindows listázása egy erőforráscsoportban vagy az előfizetésen belül, ha a --resource-group nincs megadva.
az aks maintenancewindow list [--resource-group]
Opcionális paraméterek
Az alábbi paraméterek megadása nem kötelező, de a környezettől függően előfordulhat, hogy a parancs sikeres végrehajtásához egy vagy több is szükséges lehet.
Az erőforráscsoport neve. Az alapértelmezett csoportot a az configure --defaults group=<name>használatával konfigurálhatja.
Globális paraméterek
Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | False |
Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
Csak a hibák megjelenítése, a figyelmeztetések mellőzése.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | False |
Kimeneti formátum.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | json |
| Elfogadott értékek: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .
Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a az account set -s NAME_OR_IDhasználatával konfigurálhatja.
A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | False |
az aks maintenancewindow show
MaintenanceWindow megjelenítése.
az aks maintenancewindow show --name
--resource-group
Kötelező paraméterek
A karbantartási időszak neve.
Az erőforráscsoport neve. Az alapértelmezett csoportot a az configure --defaults group=<name>használatával konfigurálhatja.
Globális paraméterek
Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | False |
Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
Csak a hibák megjelenítése, a figyelmeztetések mellőzése.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | False |
Kimeneti formátum.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | json |
| Elfogadott értékek: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .
Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a az account set -s NAME_OR_IDhasználatával konfigurálhatja.
A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | False |
az aks maintenancewindow update
Frissítsen egy MaintenanceWindow-t.
Olvasási-módosítási-írási szemantikai egyeztetés az aks update , és az aks nodepool update: a meglévő MW beolvassa, a megadott mezők egyesülnek rajta, és az eredményül kapott törzs vissza lesz helyezve.
A nem megadott mezők megmaradnak as-is (meglévő címkék, meglévő ütemezési skalárok, meglévő elsötétítési dátumok stb.).
Ha ad meg ütemezési arg (--schedule-type / --interval-* / --day-of-week / --day-of-month / --week-index), az ütemezési alakzat újraépül a végpontok között az args (nem lehet részben keverni Napi + Heti mezők - válasszon egy ütemezési típust, és adja meg a szükséges args).
A --tags a következő konvenciót aks update követi: az átadás –-tags a teljes címkék szótárát helyettesíti; kihagyja a --címkéket a meglévő címkék megtartásához.
--a hely nem módosítható (TrackedResource szemantika – AZ ARM elutasítja a helymódosításokat a PUT-on). Ha a megadott érték eltér a meglévő helyétől, a rendszer figyelmeztetéssel hagyja figyelmen kívül.
--config-file: ha meg van adva, a JSON-fájl blokkja properties lecseréli a meglévő properties nagykereskedelmi fájlt. Ez az egyetlen módja annak, hogy ma mutáljuk notAllowedDates / elsötétített dátumtartományok.
Ezen az útvonalon az egyes ütemezési jelzők figyelmen kívül lesznek hagyva; a címkék ugyanazt --tags a szabályt követik, mint a --config-file nélkül.
az aks maintenancewindow update --name
--resource-group
[--acquire-policy-token]
[--change-reference]
[--config-file]
[--day-of-month]
[--day-of-week]
[--duration]
[--interval-days]
[--interval-months]
[--interval-weeks]
[--location]
[--no-wait]
[--schedule-type {AbsoluteMonthly, Daily, RelativeMonthly, Weekly}]
[--start-date]
[--start-time]
[--tags]
[--utc-offset]
[--week-index {First, Fourth, Last, Second, Third}]
Példák
Csak a címkék frissítése (a meglévő ütemezés megmarad).
az aks maintenancewindow update -g rg-maintenance -n production-weekends --tags environment=staging
Csak az ütemezés hétközi napját frissítse (a meglévő időtartam/ kezdési időpont /címkék megmaradnak).
az aks maintenancewindow update -g rg-maintenance -n production-weekends \
--schedule-type Weekly --day-of-week Sunday --interval-weeks 1
Csak az időtartam módosítása (a meglévő ütemezési alakzat megmarad).
az aks maintenancewindow update -g rg-maintenance -n production-weekends --duration 6
Cserélje le az elsötétítési dátumokat egy konfigurációs fájlon keresztül (megőrzi a címkéket, a helyet).
az aks maintenancewindow update -g rg-maintenance -n production-weekends --config-file ./mw-body.json
The contents of mw-body.json should include a complete properties block, e.g.:
{
"properties": {
"schedule": { "weekly": { "intervalWeeks": 1, "dayOfWeek": "Saturday" } },
"startTime": "02:00",
"durationHours": 8,
"utcOffset": "-07:00",
"notAllowedDates": [ { "start": "2026-12-23", "end": "2027-01-05" } ]
}
}
Kötelező paraméterek
A karbantartási időszak neve.
Az erőforráscsoport neve. Az alapértelmezett csoportot a az configure --defaults group=<name>használatával konfigurálhatja.
Opcionális paraméterek
Az alábbi paraméterek megadása nem kötelező, de a környezettől függően előfordulhat, hogy a parancs sikeres végrehajtásához egy vagy több is szükséges lehet.
Az erőforrásművelethez automatikusan beszerez egy Azure Policy-jogkivonatot.
| Tulajdonság | Érték |
|---|---|
| Paramétercsoport: | Global Policy Arguments |
Az erőforrásművelet kapcsolódó változáshivatkozás-azonosítója.
| Tulajdonság | Érték |
|---|---|
| Paramétercsoport: | Global Policy Arguments |
A MaintenanceWindow törzset leíró JSON-fájl elérési útja. Amikor meg van adva, a JSON teljes mértékben meghatározza az erőforrást a létrehozáskor, vagy lecseréli a meglévő properties blokkot a frissítéskor. Ez az egyetlen elérési út, amely dedikált jelzők (nemAllowedDates stb.) nélkül állíthat be mezőket.
A hónap azon napja, amikor a karbantartás az AbsoluteMonthly ütemezés szerint történik.
A karbantartás a hét azon napján történik, amikor a karbantartás a Heti vagy a RelativeMonthly ütemezés szerint történik.
A karbantartási időszak hossza órákban. Tartomány: 4-24.
A napi ütemezés minden előfordulási halmaza közötti napok száma.
Az AbsoluteMonthly vagy a RelativeMonthly ütemezés egyes előfordulásai közötti hónapok száma.
A heti ütemezés egyes előfordulásai közötti hetek száma.
Location. Értékek innen: az account list-locations. Az alapértelmezett helyet a következővel az configure --defaults location=<location>konfigurálhatja: .
Ne várja meg, amíg a hosszú ideig futó művelet befejeződik.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | False |
Ismétlődés típusa: Napi, Heti, Abszolút vagy Relatív.
| Tulajdonság | Érték |
|---|---|
| Elfogadott értékek: | AbsoluteMonthly, Daily, RelativeMonthly, Weekly |
A karbantartási időszak aktiválásának dátuma. pl. 2026-06-01.
A karbantartási időszak kezdő időpontja. pl. 09:30.
Szóközzel elválasztott címkék: key[=value] [key[=value] ...]. Meglévő címkék törlése a "" használatával.
Az UTC eltolás formátuma +/-HH:mm. például -08:00 vagy +05:30.
A --day-of-weekben megadott hétköznap példánya a RelativeMonthly ütemezés szerint történik.
| Tulajdonság | Érték |
|---|---|
| Elfogadott értékek: | First, Fourth, Last, Second, Third |
Globális paraméterek
Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | False |
Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
Csak a hibák megjelenítése, a figyelmeztetések mellőzése.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | False |
Kimeneti formátum.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | json |
| Elfogadott értékek: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .
Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a az account set -s NAME_OR_IDhasználatával konfigurálhatja.
A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | False |
az aks maintenancewindow wait
Várjon, amíg a MaintenanceWindow eléri a kívánt állapotot.
Ha egy MaintenanceWindow-művelet megszakadt vagy elkezdődött --no-wait, ezzel a paranccsal várja meg, amíg befejeződik.
az aks maintenancewindow wait --name
--resource-group
[--acquire-policy-token]
[--change-reference]
[--created]
[--custom]
[--deleted]
[--exists]
[--interval]
[--timeout]
[--updated]
Példák
Várjon, amíg létrejön egy MaintenanceWindow.
az aks maintenancewindow wait -g rg-maintenance -n production-weekends --created
Kötelező paraméterek
A karbantartási időszak neve.
Az erőforráscsoport neve. Az alapértelmezett csoportot a az configure --defaults group=<name>használatával konfigurálhatja.
Opcionális paraméterek
Az alábbi paraméterek megadása nem kötelező, de a környezettől függően előfordulhat, hogy a parancs sikeres végrehajtásához egy vagy több is szükséges lehet.
Az erőforrásművelethez automatikusan beszerez egy Azure Policy-jogkivonatot.
| Tulajdonság | Érték |
|---|---|
| Paramétercsoport: | Global Policy Arguments |
Az erőforrásművelet kapcsolódó változáshivatkozás-azonosítója.
| Tulajdonság | Érték |
|---|---|
| Paramétercsoport: | Global Policy Arguments |
Várjon, amíg létre nem jön a "provisioningState" a "Sikeres" helyen.
| Tulajdonság | Érték |
|---|---|
| Paramétercsoport: | Wait Condition Arguments |
| Alapértelmezett érték: | False |
Várjon, amíg a feltétel megfelel egy egyéni JMESPath-lekérdezésnek. Pl. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running"?.
| Tulajdonság | Érték |
|---|---|
| Paramétercsoport: | Wait Condition Arguments |
Várjon a törlésig.
| Tulajdonság | Érték |
|---|---|
| Paramétercsoport: | Wait Condition Arguments |
| Alapértelmezett érték: | False |
Várjon, amíg az erőforrás létezik.
| Tulajdonság | Érték |
|---|---|
| Paramétercsoport: | Wait Condition Arguments |
| Alapértelmezett érték: | False |
Lekérdezési időköz másodpercben.
| Tulajdonság | Érték |
|---|---|
| Paramétercsoport: | Wait Condition Arguments |
| Alapértelmezett érték: | 30 |
Maximális várakozás másodpercben.
| Tulajdonság | Érték |
|---|---|
| Paramétercsoport: | Wait Condition Arguments |
| Alapértelmezett érték: | 3600 |
Várjon, amíg frissül a provisioningState a következő helyen: "Sikeres".
| Tulajdonság | Érték |
|---|---|
| Paramétercsoport: | Wait Condition Arguments |
| Alapértelmezett érték: | False |
Globális paraméterek
Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | False |
Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
Csak a hibák megjelenítése, a figyelmeztetések mellőzése.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | False |
Kimeneti formátum.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | json |
| Elfogadott értékek: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .
Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a az account set -s NAME_OR_IDhasználatával konfigurálhatja.
A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.
| Tulajdonság | Érték |
|---|---|
| Alapértelmezett érték: | False |