az aks maintenancewindow

Note

Tento odkaz je součástí rozšíření aks-Preview pro Azure CLI (verze 2.85.0 nebo vyšší). Rozšíření se automaticky nainstaluje při prvním spuštění příkazu az aks maintenancewindow . Přečtěte si další informace o rozšířeních.

Příkazy pro správu prostředků ARM partnerského vztahu MaintenanceWindow

MaintenanceWindow je prostředek ARM s oborem skupiny prostředků, který definuje opakovaně použitelný plán údržby. Uživatelé mohou tento prostředek propojit s předem existující údržbouConfiguration prostřednictvím maintenanceWindowId, takže více spravovaných konfigurací údržby sdílí jednu údržbuWindow a plán se nachází na jednom místě.

Vyžaduje Microsoft. Funkce ContainerService/AKSSharedMaintenanceWindowPreview, která se má zaregistrovat v předplatném. Automatické schválení je povoleno: az feature register --namespace Microsoft.ContainerService --name AKSSharedMaintenanceWindowPreview.

Příkazy

Název	Description	Typ	Stav
az aks maintenancewindow create	Vytvořte údržbuWindow.	Rozšíření	GA
az aks maintenancewindow delete	Odstraňte příkaz MaintenanceWindow.	Rozšíření	GA
az aks maintenancewindow list	Vypsat údržbuWindows ve skupině prostředků nebo v rámci předplatného, pokud je vynechána --resource-group.	Rozšíření	GA
az aks maintenancewindow show	Zobrazení údržbyWindow	Rozšíření	GA
az aks maintenancewindow update	Aktualizace údržbyWindow	Rozšíření	GA
az aks maintenancewindow wait	Počkejte, až služba MaintenanceWindow dosáhne požadovaného stavu.	Rozšíření	GA

az aks maintenancewindow create

Vytvořte údržbuWindow.

Vyžaduje Microsoft. Funkce ContainerService/AKSSharedMaintenanceWindowPreview, která se má zaregistrovat v předplatném. Zaregistrujte se jednou (automaticky schváleno): 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říklady

Vytvořte týdenní sobotní okno (kanonický tvar "produkční víkendy").

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

Každé 2 dny od konkrétního počátečního data vytvořte denní okno.

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

Vytvořte absolutní měsíční okno na 15.

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

Vytvořte relativní měsíční okno v posledním pátek.

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

Vytvořte týdenní okno s daty začernění prostřednictvím konfiguračního souboru.

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" }
      ]
    }
  }

Povinné parametry

--name -n

Název časového období údržby.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--acquire-policy-token

Získání tokenu Azure Policy automaticky pro tuto operaci prostředku

Vlastnost	Hodnota
Skupina parametrů:	Global Policy Arguments

--change-reference

Související referenční ID odkazu na změnu pro tuto operaci prostředku.

Vlastnost	Hodnota
Skupina parametrů:	Global Policy Arguments

--config-file

Cesta k souboru JSON popisující tělo MaintenanceWindow Použijte, když potřebujete nastavit pole bez vyhrazených příznaků (např. notAllowedDates / blackout date ranges).

--day-of-month

Den v měsíci, kdy dojde k údržbě. např. 15. Pouze absolutní plán.

--day-of-week

Den v týdnu k údržbě. např. pondělí. Pouze týdenní nebo Relativnímonthly.

--duration

Délka časového období údržby v hodinách. Rozsah 4–24.

--interval-days

Počet dní mezi výskyty Pouze denní plán.

--interval-months

Počet měsíců mezi výskyty Pouze plány AbsoluteMonthly nebo RelativeMonthly.

--interval-weeks

Počet týdnů mezi výskyty Pouze týdenní plán.

--location -l

Umístění pro MaintenanceWindow. Při vynechání se použije výchozí umístění skupiny prostředků.

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Vlastnost	Hodnota
Default value:	False

--schedule-type

Typ opakování. Jeden z denních, týdenních, absolutních nebo relativníchmontů.

Vlastnost	Hodnota
Přípustné hodnoty:	AbsoluteMonthly, Daily, RelativeMonthly, Weekly

--start-date

Datum aktivace časového období údržby. např. 2026-06-01. Pokud není zadané, okno se aktivuje okamžitě.

--start-time

Čas spuštění časového období údržby. Přijaté hodnoty jsou od 00:00 do 23:59. --utc-offset se vztahuje na toto pole.

--tags

Značky oddělené mezerami: klíč[=hodnota] [klíč[=hodnota] ...]. K vymazání existujících značek použijte "".

--utc-offset

Posun UTC ve formátu +/-HH:mm. Například +05:30 pro IST nebo -07:00 pro PST. Výchozí hodnota je +00:00.

--week-index

K instanci dne v týdnu dochází k údržbě (první, druhá, třetí, čtvrtá, poslední). Pouze plán RelativeMonthly.

Vlastnost	Hodnota
Přípustné hodnoty:	First, Fourth, Last, Second, Third

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost	Hodnota
Default value:	False

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost	Hodnota
Default value:	False

az aks maintenancewindow delete

Odstraňte příkaz MaintenanceWindow.

az aks maintenancewindow delete --name
                                --resource-group
                                [--acquire-policy-token]
                                [--change-reference]
                                [--no-wait]
                                [--yes]

Povinné parametry

--name -n

Název časového období údržby.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--acquire-policy-token

Získání tokenu Azure Policy automaticky pro tuto operaci prostředku

Vlastnost	Hodnota
Skupina parametrů:	Global Policy Arguments

--change-reference

Související referenční ID odkazu na změnu pro tuto operaci prostředku.

Vlastnost	Hodnota
Skupina parametrů:	Global Policy Arguments

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Vlastnost	Hodnota
Default value:	False

--yes -y

Nevyzývejte k potvrzení.

Vlastnost	Hodnota
Default value:	False

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost	Hodnota
Default value:	False

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost	Hodnota
Default value:	False

az aks maintenancewindow list

Vypsat údržbuWindows ve skupině prostředků nebo v rámci předplatného, pokud je vynechána --resource-group.

az aks maintenancewindow list [--resource-group]

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost	Hodnota
Default value:	False

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost	Hodnota
Default value:	False

az aks maintenancewindow show

Zobrazení údržbyWindow

az aks maintenancewindow show --name
                              --resource-group

Povinné parametry

--name -n

Název časového období údržby.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost	Hodnota
Default value:	False

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost	Hodnota
Default value:	False

az aks maintenancewindow update

Aktualizace údržbyWindow

Sémantika az aks update čtení-úpravy zápisu a az aks nodepool update: stávající MW se načte, vaše zadaná pole se sloučí do něj a výsledný text se vrátí zpět. Pole, která nezadáte, se zachovají as-is (existující značky, existující skaláry plánu, existující data výpadku atd.).

Když zadáte arg plánu (--schedule-type / --interval-* / --day-of-week / --day-of-month / --week-index), obrazec plánu je znovu sestaven z argumentů args (nelze částečně kombinovat pole Denně + Týdně – vyberte jeden typ plánu a zadejte požadované argumenty).

--tags se řídí aks update konvencí: předávání --tags nahrazuje celý slovník značek; vynecháte --tags, aby se zachovaly stávající značky.

--location nejde změnit (sémantika TrackedResource – ARM odmítne změny umístění v put). Pokud je zadána jiná hodnota než u existujícího umístění, bude ignorována upozorněním.

--config-file: při zadání nahradí blok souboru properties JSON stávající properties velkoobchod. Toto je jediný způsob, jak dnes ztlumit notAllowedDates / začernit rozsahy kalendářních dat. Jednotlivé příznaky plánu jsou na této cestě ignorovány; značky se řídí stejným --tags pravidlem jako bez souboru --config-file.

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říklady

Aktualizace pouze značek (existující plán se zachová).

az aks maintenancewindow update -g rg-maintenance -n production-weekends --tags environment=staging

Aktualizujte pouze den v týdnu plánu (stávající doba trvání, čas zahájení nebo zachování značek).

az aks maintenancewindow update -g rg-maintenance -n production-weekends \
  --schedule-type Weekly --day-of-week Sunday --interval-weeks 1

Změnit pouze dobu trvání (existující obrazec plánu je zachován).

az aks maintenancewindow update -g rg-maintenance -n production-weekends --duration 6

Data začernění nahraďte konfiguračním souborem (zachová značky, umístění).

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" } ]
    }
  }

Povinné parametry

--name -n

Název časového období údržby.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--acquire-policy-token

Získání tokenu Azure Policy automaticky pro tuto operaci prostředku

Vlastnost	Hodnota
Skupina parametrů:	Global Policy Arguments

--change-reference

Související referenční ID odkazu na změnu pro tuto operaci prostředku.

Vlastnost	Hodnota
Skupina parametrů:	Global Policy Arguments

--config-file

Cesta k souboru JSON popisující tělo MaintenanceWindow Při zadání json zcela definuje prostředek při vytvoření nebo nahradí existující properties blok při aktualizaci. Toto je jediná cesta, která může nastavit pole bez vyhrazených příznaků (notAllowedDates atd.).

--day-of-month

Den v měsíci nastane údržba pro plán AbsoluteMonthly.

--day-of-week

Den v týdnu probíhá údržba pro týdenní nebo relativní plán.

--duration

Délka časového období údržby v hodinách. Rozsah 4–24.

--interval-days

Počet dní mezi každou sadou výskytů denního plánu.

--interval-months

Počet měsíců mezi jednotlivými sadami výskytů pro plán AbsoluteMonthly nebo RelativeMonthly.

--interval-weeks

Počet týdnů mezi každou sadou výskytů týdenního plánu.

--location -l

Location. Hodnoty z: az account list-locations. Výchozí umístění můžete nakonfigurovat pomocí .az configure --defaults location=<location>

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Vlastnost	Hodnota
Default value:	False

--schedule-type

Typ opakování: Denně, Týdně, AbsolutníMonthly nebo RelativeMonthly.

Vlastnost	Hodnota
Přípustné hodnoty:	AbsoluteMonthly, Daily, RelativeMonthly, Weekly

--start-date

Datum aktivace časového období údržby. např. 2026-06-01.

--start-time

Čas spuštění časového období údržby. např. 09:30.

--tags

Značky oddělené mezerami: klíč[=hodnota] [klíč[=hodnota] ...]. K vymazání existujících značek použijte "".

--utc-offset

Posun UTC ve formátu +/-HH:mm. např. -08:00 nebo +05:30.

--week-index

Instance dne v týdnu zadaného v týdnu probíhá údržba pro plán RelativeMonthly.

Vlastnost	Hodnota
Přípustné hodnoty:	First, Fourth, Last, Second, Third

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost	Hodnota
Default value:	False

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost	Hodnota
Default value:	False

az aks maintenancewindow wait

Počkejte, až služba MaintenanceWindow dosáhne požadovaného stavu.

Pokud došlo k přerušení nebo spuštění --no-waitoperace v maintenanceWindow, použijte tento příkaz a počkejte na dokončení operace.

az aks maintenancewindow wait --name
                              --resource-group
                              [--acquire-policy-token]
                              [--change-reference]
                              [--created]
                              [--custom]
                              [--deleted]
                              [--exists]
                              [--interval]
                              [--timeout]
                              [--updated]

Příklady

Počkejte, než se vytvoří údržbaWindow.

az aks maintenancewindow wait -g rg-maintenance -n production-weekends --created

Povinné parametry

--name -n

Název časového období údržby.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--acquire-policy-token

Získání tokenu Azure Policy automaticky pro tuto operaci prostředku

Vlastnost	Hodnota
Skupina parametrů:	Global Policy Arguments

--change-reference

Související referenční ID odkazu na změnu pro tuto operaci prostředku.

Vlastnost	Hodnota
Skupina parametrů:	Global Policy Arguments

--created

Počkejte na vytvoření s 'provisioningState' v 'Succeeded'.

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	False

--custom

Počkejte, až podmínka splňuje vlastní dotaz JMESPath. Například provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments

--deleted

Počkejte na odstranění.

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	False

--exists

Počkejte, až prostředek existuje.

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	False

--interval

Interval dotazování v sekundách

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	30

--timeout

Maximální čekání v sekundách.

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	3600

--updated

Počkejte, dokud se neaktualizuje stav zřizování ve stavu Úspěch.

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	False

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost	Hodnota
Default value:	False

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost	Hodnota
Default value:	False