az aks maintenancewindow

Note

Questo riferimento fa parte dell'estensione aks-preview per il interfaccia della riga di comando di Azure (versione 2.85.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az aks maintenancewindow . Altre informazioni sulle estensioni.

Comandi per gestire le risorse arm peer di MaintenanceWindow.

MaintenanceWindow è una risorsa ARM con ambito gruppo di risorse che definisce una pianificazione di manutenzione riutilizzabile. Gli utenti possono collegare questa risorsa a una manutenzione preesistenteConfigurazione tramite maintenanceWindowId, quindi più configurazioni di manutenzione managedCluster condividono un'unica finestra di manutenzione e la pianificazione si trova in un'unica posizione.

Richiede l'Microsoft. Funzionalità ContainerService/AKSSharedMaintenanceWindowPreview da registrare nella sottoscrizione. L'approvazione automatica è abilitata: az feature register --namespace Microsoft.ContainerService --name AKSSharedMaintenanceWindowPreview.

Comandi

Nome Descrizione Tipo Status
az aks maintenancewindow create

Creare un oggetto MaintenanceWindow.

 Estensione GA
az aks maintenancewindow delete

Eliminare un oggetto MaintenanceWindow.

 Estensione GA
az aks maintenancewindow list

Elencare MaintenanceWindows in un gruppo di risorse o nella sottoscrizione se --resource-group viene omesso.

 Estensione GA
az aks maintenancewindow show

Mostra un oggetto MaintenanceWindow.

 Estensione GA
az aks maintenancewindow update

Aggiornare un oggetto MaintenanceWindow.

 Estensione GA
az aks maintenancewindow wait

Attendere che un oggetto MaintenanceWindow raggiunga uno stato desiderato.

 Estensione GA

az aks maintenancewindow create

Creare un oggetto MaintenanceWindow.

Richiede l'Microsoft. Funzionalità ContainerService/AKSSharedMaintenanceWindowPreview da registrare nella sottoscrizione. Registra una volta (approvato automaticamente): 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}]

Esempio

Creare una finestra del sabato settimanale (forma canonica "fine settimana di produzione").

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

Creare una finestra giornaliera ogni 2 giorni da una data di inizio specifica.

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

Creare una finestra mensile assoluta sul 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

Creare una finestra mensile relativa l'ultimo venerdì.

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

Creare una finestra settimanale con date di black-out tramite un file di configurazione.

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

Parametri necessari

--name -n

Nome della finestra di manutenzione.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--config-file

Percorso di un file JSON che descrive il corpo di MaintenanceWindow. Usare quando è necessario impostare campi senza flag dedicati ,ad esempio notAllowedDates/intervalli di date di blackout.

--day-of-month

Giorno del mese in cui viene eseguita la manutenzione. ad esempio 15. Solo pianificazione AbsoluteMonthly.

--day-of-week

Giorno della settimana in cui viene eseguita la manutenzione. ad esempio lunedì. Solo pianificazioni settimanali o RelativeMonthly.

--duration

Lunghezza della finestra di manutenzione in ore. Intervallo da 4 a 24.

--interval-days

Numero di giorni tra le occorrenze. Solo pianificazione giornaliera.

--interval-months

Numero di mesi tra occorrenze. Solo le pianificazioni AbsoluteMonthly o RelativeMonthly.

--interval-weeks

Numero di settimane tra occorrenze. Solo pianificazione settimanale.

--location -l

Percorso per MaintenanceWindow. Il valore predefinito è la posizione del gruppo di risorse quando viene omesso.

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
Valore predefinito: False
--schedule-type

Tipo di ricorrenza. Uno di daily, weekly, AbsoluteMonthly o RelativeMonthly.

Proprietà Valore
Valori accettati: AbsoluteMonthly, Daily, RelativeMonthly, Weekly
--start-date

Data di attivazione della finestra di manutenzione. ad esempio 2026-06-01. Se non specificato, la finestra viene attivata immediatamente.

--start-time

Ora di inizio della finestra di manutenzione. I valori accettati sono compresi tra '00:00' e '23:59'. --utc-offset si applica a questo campo.

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

--utc-offset

Offset UTC in formato +/-HH:mm. Ad esempio, '+05:30' per IST o '-07:00' per PST. Il valore predefinito è '+00:00'.

--week-index

L'istanza del giorno della settimana viene eseguita la manutenzione (First, Second, Third, Fourth, Last). Solo pianificazione relativaMonthly.

Proprietà Valore
Valori accettati: First, Fourth, Last, Second, Third
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az aks maintenancewindow delete

Eliminare un oggetto MaintenanceWindow.

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

Parametri necessari

--name -n

Nome della finestra di manutenzione.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
Valore predefinito: False
--yes -y

Non richiedere conferma.

Proprietà Valore
Valore predefinito: False
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az aks maintenancewindow list

Elencare MaintenanceWindows in un gruppo di risorse o nella sottoscrizione se --resource-group viene omesso.

az aks maintenancewindow list [--resource-group]

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az aks maintenancewindow show

Mostra un oggetto MaintenanceWindow.

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

Parametri necessari

--name -n

Nome della finestra di manutenzione.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az aks maintenancewindow update

Aggiornare un oggetto MaintenanceWindow.

Corrispondenza semantica az aks update di lettura-modifica/scrittura e az aks nodepool update: il MW esistente viene recuperato, i campi forniti vengono uniti e il corpo risultante è PUT back. I campi non forniti vengono mantenuti as-is (tag esistenti, scalari di pianificazione esistenti, date di blackout esistenti e così via).

Quando si specifica un arg di pianificazione (--schedule-type / --interval-* / --day-of-week / --day-of-month / --week-index), la forma della pianificazione viene ricreata end-to-end dagli argomenti (non è possibile combinare parzialmente i campi Giornaliero + Settimanale - selezionare un tipo di pianificazione e specificare gli argomenti necessari).

--tags segue aks update la convenzione: il passaggio di --tags sostituisce l'intero dizionario tag; omettere --tags per mantenere i tag esistenti.

--location non può essere modificato (semantica TrackedResource: ARM rifiuta le modifiche alla posizione in PUT). Se specificato con un valore diverso da quello esistente, viene ignorato con un avviso.

--config-file: se specificato, il blocco del properties file JSON sostituisce l'ingrosso esistente properties . Questo è l'unico modo oggi per modificare gli intervalli di date notAllowedDates/blackout. I singoli flag di pianificazione vengono ignorati in questo percorso; I tag seguono la stessa --tags regola di senza --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}]

Esempio

Aggiornare solo i tag (la pianificazione esistente viene mantenuta).

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

Aggiornare solo il giorno della settimana della pianificazione (durata esistente/ ora di inizio/tag mantenuti).

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

Modifica solo durata (forma di pianificazione esistente mantenuta).

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

Sostituire le date di black-out tramite un file di configurazione (mantiene i tag, la posizione).

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

Parametri necessari

--name -n

Nome della finestra di manutenzione.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--config-file

Percorso di un file JSON che descrive il corpo di MaintenanceWindow. Se specificato, il codice JSON definisce completamente la risorsa in caso di creazione o sostituisce il blocco esistente properties in caso di aggiornamento. Questo è l'unico percorso che può impostare campi senza flag dedicati (notAllowedDates e così via).

--day-of-month

Giorno del mese la manutenzione viene eseguita per la pianificazione AbsoluteMonthly.

--day-of-week

Giorno della settimana la manutenzione viene eseguita per la pianificazione settimanale o RelativaMonthly.

--duration

Lunghezza della finestra di manutenzione in ore. Intervallo da 4 a 24.

--interval-days

Numero di giorni tra ogni set di occorrenze per la pianificazione giornaliera.

--interval-months

Numero di mesi tra ogni set di occorrenze per la pianificazione AbsoluteMonthly o RelativeMonthly.

--interval-weeks

Numero di settimane tra ogni set di occorrenze per la pianificazione settimanale.

--location -l

Location. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
Valore predefinito: False
--schedule-type

Tipo di ricorrenza: Daily, Weekly, AbsoluteMonthly o RelativeMonthly.

Proprietà Valore
Valori accettati: AbsoluteMonthly, Daily, RelativeMonthly, Weekly
--start-date

Data di attivazione della finestra di manutenzione. ad esempio 2026-06-01.

--start-time

Ora di inizio della finestra di manutenzione. ad esempio 09:30.

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

--utc-offset

Offset UTC in formato +/-HH:mm. ad esempio -08:00 o +05:30.

--week-index

Istanza del giorno feriale specificato in --day-of-week, la manutenzione viene eseguita per la pianificazione RelativeMonthly.

Proprietà Valore
Valori accettati: First, Fourth, Last, Second, Third
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az aks maintenancewindow wait

Attendere che un oggetto MaintenanceWindow raggiunga uno stato desiderato.

Se un'operazione su maintenanceWindow è stata interrotta o è stata avviata con --no-wait, usare questo comando per attendere il completamento.

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

Esempio

Attendere la creazione di un oggetto MaintenanceWindow.

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

Parametri necessari

--name -n

Nome della finestra di manutenzione.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--created

Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.

Proprietà Valore
Gruppo di parametri: Wait Condition Arguments
Valore predefinito: False
--custom

Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Proprietà Valore
Gruppo di parametri: Wait Condition Arguments
--deleted

Attendere l'eliminazione.

Proprietà Valore
Gruppo di parametri: Wait Condition Arguments
Valore predefinito: False
--exists

Attendere che la risorsa esista.

Proprietà Valore
Gruppo di parametri: Wait Condition Arguments
Valore predefinito: False
--interval

Intervallo di polling in secondi.

Proprietà Valore
Gruppo di parametri: Wait Condition Arguments
Valore predefinito: 30
--timeout

Attesa massima in secondi.

Proprietà Valore
Gruppo di parametri: Wait Condition Arguments
Valore predefinito: 3600
--updated

Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.

Proprietà Valore
Gruppo di parametri: Wait Condition Arguments
Valore predefinito: False
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False