az aks maintenanceconfiguration

Nota

Questo gruppo di comandi include comandi definiti sia nell'interfaccia della riga di comando di Azure che in almeno un'estensione. Installare ogni estensione per trarre vantaggio dalle funzionalità estese. Altre informazioni sulle estensioni.

Comandi per gestire le configurazioni di manutenzione nel cluster Kubernetes gestito.

Comandi

Nome Descrizione Tipo Stato
az aks maintenanceconfiguration add

Aggiungere una configurazione di manutenzione nel cluster Kubernetes gestito.

Memoria centrale Disponibilità generale
az aks maintenanceconfiguration add (aks-preview estensione)

Aggiungere una configurazione di manutenzione nel cluster Kubernetes gestito.

Estensione Disponibilità generale
az aks maintenanceconfiguration delete

Eliminare una configurazione di manutenzione nel cluster Kubernetes gestito.

Memoria centrale Disponibilità generale
az aks maintenanceconfiguration delete (aks-preview estensione)

Eliminare una configurazione di manutenzione nel cluster Kubernetes gestito.

Estensione Disponibilità generale
az aks maintenanceconfiguration list

Elencare le configurazioni di manutenzione nel cluster Kubernetes gestito.

Memoria centrale Disponibilità generale
az aks maintenanceconfiguration list (aks-preview estensione)

Elencare le configurazioni di manutenzione nel cluster Kubernetes gestito.

Estensione Disponibilità generale
az aks maintenanceconfiguration show

Visualizzare i dettagli di una configurazione di manutenzione nel cluster Kubernetes gestito.

Memoria centrale Disponibilità generale
az aks maintenanceconfiguration show (aks-preview estensione)

Visualizzare i dettagli di una configurazione di manutenzione nel cluster Kubernetes gestito.

Estensione Disponibilità generale
az aks maintenanceconfiguration update

Aggiornare una configurazione di manutenzione di un cluster Kubernetes gestito.

Memoria centrale Disponibilità generale
az aks maintenanceconfiguration update (aks-preview estensione)

Aggiornare una configurazione di manutenzione di un cluster Kubernetes gestito.

Estensione Disponibilità generale

az aks maintenanceconfiguration add

Aggiungere una configurazione di manutenzione nel cluster Kubernetes gestito.

az aks maintenanceconfiguration add --cluster-name
                                    --name
                                    --resource-group
                                    [--config-file]
                                    [--day-of-month]
                                    [--day-of-week]
                                    [--duration]
                                    [--interval-days]
                                    [--interval-months]
                                    [--interval-weeks]
                                    [--schedule-type {AbsoluteMonthly, Daily, RelativeMonthly, Weekly}]
                                    [--start-date]
                                    [--start-hour]
                                    [--start-time]
                                    [--utc-offset]
                                    [--week-index {First, Fourth, Last, Second, Third}]
                                    [--weekday]

Esempio

Aggiungere la configurazione di manutenzione predefinita con --weekday e --start-hour.

az aks maintenanceconfiguration add -g MyResourceGroup --cluster-name test1 -n default --weekday Monday  --start-hour 1
  The maintenance is allowed on Monday 1:00am to 2:00am

Aggiungere la configurazione di manutenzione predefinita con --weekday. La manutenzione è consentita in qualsiasi momento di quel giorno.

az aks maintenanceconfiguration add -g MyResourceGroup --cluster-name test1 -n default --weekday Monday
  The maintenance is allowed on Monday.

Aggiungere la configurazione di manutenzione predefinita con il file JSON di configurazione della manutenzione

az aks maintenanceconfiguration add -g MyResourceGroup --cluster-name test1 -n default --config-file ./test.json
    The content of json file looks below. It means the maintenance is allowed on UTC time Tuesday 1:00am - 3:00 am and Wednesday 1:00am - 2:00am, 6:00am-7:00am
    No maintenance is allowed from 2020-11-26T03:00:00Z to 2020-11-30T12:00:00Z and from 2020-12-26T03:00:00Z to 2020-12-26T12:00:00Z even if they are allowed in the above weekly setting
    {
          "timeInWeek": [
            {
              "day": "Tuesday",
              "hourSlots": [
                1,
                2
              ]
            },
            {
              "day": "Wednesday",
              "hourSlots": [
                1,
                6
              ]
            }
          ],
          "notAllowedTime": [
            {
              "start": "2021-11-26T03:00:00Z",
              "end": "2021-11-30T12:00:00Z"
            },
            {
              "start": "2021-12-26T03:00:00Z",
              "end": "2021-12-26T12:00:00Z"
            }
          ]
  }

Aggiungere aksManagedNodeOSUpgradeSchedule manutenzione con pianificazione giornaliera.

az aks maintenanceconfiguration add -g MyResourceGroup --cluster-name test1 -n aksManagedNodeOSUpgradeSchedule --schedule-type Daily --interval-days 2 --duration 12 --utc-offset=-08:00 --start-date 2023-01-16 --start-time 00:00
  The maintenance is allowed from 00:00 to 12:00 (adjusted with UTC offset: -08:00) every two days, and this configuration will be effective from 2023-01-16.

Aggiungere aksManagedNodeOSUpgradeSchedule manutenzione con pianificazione settimanale.

az aks maintenanceconfiguration add -g MyResourceGroup --cluster-name test1 -n aksManagedNodeOSUpgradeSchedule --schedule-type Weekly --day-of-week Friday --interval-weeks 3 --duration 8 --utc-offset +05:30 --start-date 2023-01-16 --start-time 09:30
  The maintenance is allowed on Friday from 09:30 to 17:30 (adjusted with UTC offset: +05:30) every three weeks, and this configuration will be effective from 2023-01-16.

Aggiungere aksManagedAutoUpgradeSchedule manutenzione con pianificazione mensile assoluta.

az aks maintenanceconfiguration add -g MyResourceGroup --cluster-name test1 -n aksManagedAutoUpgradeSchedule --schedule-type AbsoluteMonthly --day-of-month 15 --interval-months 1 --duration 6 --utc-offset +05:30 --start-date 2023-01-16 --start-time 09:30
  The maintenance is allowed on the 15th of the month from 09:30 to 15:30 (adjusted with UTC offset: +05:30) every month, and this configuration will be effective from 2023-01-16.

Aggiungere aksManagedAutoUpgradeSchedule manutenzione con pianificazione mensile relativa.

az aks maintenanceconfiguration add -g MyResourceGroup --cluster-name test1 -n aksManagedAutoUpgradeSchedule --schedule-type RelativeMonthly --day-of-week Tuesday --week-index Last --interval-months 3 --duration 6 --start-date 2023-01-16 --start-time 09:30
  The maintenance is allowed on the last Tuesday from 09:30 to 15:30 in default UTC time every 3 months, and this configuration will be effective from 2023-01-16.

Aggiungere aksManagedAutoUpgradeSchedule maintenance configuration with json file (Aggiungere aksManagedAutoUpgradeSchedule maintenance configuration with json file).

az aks maintenanceconfiguration add -g MyResourceGroup --cluster-name test1 -n aksManagedAutoUpgradeSchedule --config-file ./test.json
    The content of json file looks below. It means the maintenance is allowed on the 1st of the month from 09:00 to 13:00 (adjusted with UTC offset: -08:00) every 3 months, and this configuration will be effective from 2023-01-16.
    No maintenance is allowed from 2022-12-23 to 2023-01-05 and from 2023-11-23 to 2023-11-26 even if they are allowed in the above monthly setting
    {
        "maintenanceWindow": {
            "schedule": {
                "absoluteMonthly": {
                    "intervalMonths": 3,
                    "dayOfMonth": 1
                }
            },
            "durationHours": 4,
            "utcOffset": "-08:00",
            "startTime": "09:00",
            "notAllowedDates": [
                {
                    "start": "2022-12-23",
                    "end": "2023-01-05"
                },
                {
                    "start": "2023-11-23",
                    "end": "2023-11-26"
                }
            ]
        }
    }

Parametri necessari

--cluster-name

Il nome del cluster.

--name -n

Nome della configurazione.

--resource-group -g

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

Parametri facoltativi

--config-file

File JSON di configurazione della manutenzione.

--day-of-month

Specificare il giorno del mese in cui viene eseguita la manutenzione. Ad esempio, 1 indica il primo del mese. Applicabile solo al tipo di pianificazione mensile assoluto.

--day-of-week

Specificare il giorno della settimana in cui viene eseguita la manutenzione. Ad esempio "Lunedì". Applicabile ai tipi di pianificazione settimanale e mensile relativa.

--duration

La lunghezza della finestra di manutenzione varia da 4 a 24 ore.

--interval-days

Numero di giorni tra ogni set di occorrenze per il tipo di pianificazione giornaliera.

--interval-months

Numero di mesi tra ogni set di occorrenze. Applicabile ai tipi di pianificazione mensili assoluti e relativi.

--interval-weeks

Numero di settimane tra ogni set di occorrenze. Applicabile solo ai tipi di pianificazione settimanali.

--schedule-type

Scegliere "Daily", "Weekly", "AbsoluteMonthly" o "RelativeMonthly" per la pianificazione della manutenzione. Applicabile solo alla configurazione di manutenzione "aksManagedAutoUpgradeSchedule" e "aksManagedNodeOSUpgradeSchedule".

valori accettati: AbsoluteMonthly, Daily, RelativeMonthly, Weekly
--start-date

Data di attivazione della configurazione di manutenzione. Se non specificato, la finestra di manutenzione sarà immediatamente attiva".

--start-hour

Ora di inizio di 1 ora consentita per la manutenzione. Ad esempio, 1 significa che è consentito tra le 1:00 e le 2:00. Applicabile solo alla configurazione di manutenzione predefinita.

--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. Ad esempio, '02:00' con '--utc-offset +02:00' indica l'ora UTC '00:00'.

--utc-offset

Offset UTC in formato +/-HH:mm. Ad esempio, '+05:30' per IST e '-07:00' per PST. Se non specificato, il valore predefinito è '+00:00'.

--week-index

Specificare in quale istanza dei giorni consentiti specificati in '--day-of-week' viene eseguita la manutenzione. Applicabile solo al tipo di pianificazione mensile relativo.

valori accettati: First, Fourth, Last, Second, Third
--weekday

Giorno della settimana in cui è consentita la manutenzione. Ad esempio lunedì. Applicabile solo alla configurazione di manutenzione predefinita.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--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

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

az aks maintenanceconfiguration add (aks-preview estensione)

Aggiungere una configurazione di manutenzione nel cluster Kubernetes gestito.

az aks maintenanceconfiguration add --cluster-name
                                    --name
                                    --resource-group
                                    [--config-file]
                                    [--day-of-month]
                                    [--day-of-week]
                                    [--duration]
                                    [--interval-days]
                                    [--interval-months]
                                    [--interval-weeks]
                                    [--schedule-type {AbsoluteMonthly, Daily, RelativeMonthly, Weekly}]
                                    [--start-date]
                                    [--start-hour]
                                    [--start-time]
                                    [--utc-offset]
                                    [--week-index {First, Fourth, Last, Second, Third}]
                                    [--weekday]

Esempio

Aggiungere la configurazione di manutenzione predefinita con --weekday e --start-hour.

az aks maintenanceconfiguration add -g MyResourceGroup --cluster-name test1 -n default --weekday Monday  --start-hour 1
  The maintenance is allowed on Monday 1:00am to 2:00am

Aggiungere la configurazione di manutenzione predefinita con --weekday. La manutenzione è consentita in qualsiasi momento di quel giorno.

az aks maintenanceconfiguration add -g MyResourceGroup --cluster-name test1 -n default --weekday Monday
  The maintenance is allowed on Monday.

Aggiungere la configurazione di manutenzione predefinita con il file JSON di configurazione della manutenzione

az aks maintenanceconfiguration add -g MyResourceGroup --cluster-name test1 -n default --config-file ./test.json
    The content of json file looks below. It means the maintenance is allowed on UTC time Tuesday 1:00am - 3:00 am and Wednesday 1:00am - 2:00am, 6:00am-7:00am
    No maintenance is allowed from 2020-11-26T03:00:00Z to 2020-11-30T12:00:00Z and from 2020-12-26T03:00:00Z to 2020-12-26T12:00:00Z even if they are allowed in the above weekly setting
    {
          "timeInWeek": [
            {
              "day": "Tuesday",
              "hourSlots": [
                1,
                2
              ]
            },
            {
              "day": "Wednesday",
              "hourSlots": [
                1,
                6
              ]
            }
          ],
          "notAllowedTime": [
            {
              "start": "2021-11-26T03:00:00Z",
              "end": "2021-11-30T12:00:00Z"
            },
            {
              "start": "2021-12-26T03:00:00Z",
              "end": "2021-12-26T12:00:00Z"
            }
          ]
  }

Aggiungere aksManagedNodeOSUpgradeSchedule manutenzione con pianificazione giornaliera.

az aks maintenanceconfiguration add -g MyResourceGroup --cluster-name test1 -n aksManagedNodeOSUpgradeSchedule --schedule-type Daily --interval-days 2 --duration 12 --utc-offset=-08:00 --start-date 2023-01-16 --start-time 00:00
  The maintenance is allowed from 00:00 to 12:00 (adjusted with UTC offset: -08:00) every two days, and this configuration will be effective from 2023-01-16.

Aggiungere aksManagedNodeOSUpgradeSchedule manutenzione con pianificazione settimanale.

az aks maintenanceconfiguration add -g MyResourceGroup --cluster-name test1 -n aksManagedNodeOSUpgradeSchedule --schedule-type Weekly --day-of-week Friday --interval-weeks 3 --duration 8 --utc-offset +05:30 --start-date 2023-01-16 --start-time 09:30
  The maintenance is allowed on Friday from 09:30 to 17:30 (adjusted with UTC offset: +05:30) every three weeks, and this configuration will be effective from 2023-01-16.

Aggiungere aksManagedAutoUpgradeSchedule manutenzione con pianificazione mensile assoluta.

az aks maintenanceconfiguration add -g MyResourceGroup --cluster-name test1 -n aksManagedAutoUpgradeSchedule --schedule-type AbsoluteMonthly --day-of-month 15 --interval-months 1 --duration 6 --utc-offset +05:30 --start-date 2023-01-16 --start-time 09:30
  The maintenance is allowed on the 15th of the month from 09:30 to 15:30 (adjusted with UTC offset: +05:30) every month, and this configuration will be effective from 2023-01-16.

Aggiungere aksManagedAutoUpgradeSchedule manutenzione con pianificazione mensile relativa.

az aks maintenanceconfiguration add -g MyResourceGroup --cluster-name test1 -n aksManagedAutoUpgradeSchedule --schedule-type RelativeMonthly --day-of-week Tuesday --week-index Last --interval-months 3 --duration 6 --start-date 2023-01-16 --start-time 09:30
  The maintenance is allowed on the last Tuesday from 09:30 to 15:30 in default UTC time every 3 months, and this configuration will be effective from 2023-01-16.

Aggiungere aksManagedAutoUpgradeSchedule maintenance configuration with json file (Aggiungere aksManagedAutoUpgradeSchedule maintenance configuration with json file).

az aks maintenanceconfiguration add -g MyResourceGroup --cluster-name test1 -n aksManagedAutoUpgradeSchedule --config-file ./test.json
    The content of json file looks below. It means the maintenance is allowed on the 1st of the month from 09:00 to 13:00 (adjusted with UTC offset: -08:00) every 3 months, and this configuration will be effective from 2023-01-16.
    No maintenance is allowed from 2022-12-23 to 2023-01-05 and from 2023-11-23 to 2023-11-26 even if they are allowed in the above monthly setting
    {
        "maintenanceWindow": {
            "schedule": {
                "absoluteMonthly": {
                    "intervalMonths": 3,
                    "dayOfMonth": 1
                }
            },
            "durationHours": 4,
            "utcOffset": "-08:00",
            "startTime": "09:00",
            "notAllowedDates": [
                {
                    "start": "2022-12-23",
                    "end": "2023-01-05"
                },
                {
                    "start": "2023-11-23",
                    "end": "2023-11-26"
                }
            ]
        }
    }

Parametri necessari

--cluster-name

Il nome del cluster.

--name -n

Nome della configurazione.

--resource-group -g

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

Parametri facoltativi

--config-file

File JSON di configurazione della manutenzione.

--day-of-month

Specificare il giorno del mese in cui viene eseguita la manutenzione. Ad esempio, 1 indica il primo del mese. Applicabile solo al tipo di pianificazione mensile assoluto.

--day-of-week

Specificare il giorno della settimana in cui viene eseguita la manutenzione. Ad esempio "Lunedì". Applicabile ai tipi di pianificazione settimanale e mensile relativa.

--duration

La lunghezza della finestra di manutenzione varia da 4 a 24 ore.

--interval-days

Numero di giorni tra ogni set di occorrenze per il tipo di pianificazione giornaliera.

--interval-months

Numero di mesi tra ogni set di occorrenze. Applicabile ai tipi di pianificazione mensili assoluti e relativi.

--interval-weeks

Numero di settimane tra ogni set di occorrenze. Applicabile solo ai tipi di pianificazione settimanali.

--schedule-type

Scegliere "Daily", "Weekly", "AbsoluteMonthly" o "RelativeMonthly" per la pianificazione della manutenzione. Applicabile solo alla configurazione di manutenzione "aksManagedAutoUpgradeSchedule" e "aksManagedNodeOSUpgradeSchedule".

valori accettati: AbsoluteMonthly, Daily, RelativeMonthly, Weekly
--start-date

Data di attivazione della configurazione di manutenzione. Se non specificato, la finestra di manutenzione sarà immediatamente attiva".

--start-hour

Ora di inizio di 1 ora consentita per la manutenzione. Ad esempio, 1 significa che è consentito tra le 1:00 e le 2:00. Applicabile solo alla configurazione di manutenzione predefinita.

--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. Ad esempio, '02:00' con '--utc-offset +02:00' indica l'ora UTC '00:00'.

--utc-offset

Offset UTC in formato +/-HH:mm. Ad esempio, '+05:30' per IST e '-07:00' per PST. Se non specificato, il valore predefinito è '+00:00'.

--week-index

Specificare in quale istanza dei giorni consentiti specificati in '--day-of-week' viene eseguita la manutenzione. Applicabile solo al tipo di pianificazione mensile relativo.

valori accettati: First, Fourth, Last, Second, Third
--weekday

Giorno della settimana in cui è consentita la manutenzione. Ad esempio lunedì. Applicabile solo alla configurazione di manutenzione predefinita.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--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

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

az aks maintenanceconfiguration delete

Eliminare una configurazione di manutenzione nel cluster Kubernetes gestito.

az aks maintenanceconfiguration delete --cluster-name
                                       --name
                                       --resource-group

Parametri necessari

--cluster-name

Il nome del cluster.

--name -n

Nome della configurazione.

--resource-group -g

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

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--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

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

az aks maintenanceconfiguration delete (aks-preview estensione)

Eliminare una configurazione di manutenzione nel cluster Kubernetes gestito.

az aks maintenanceconfiguration delete --cluster-name
                                       --name
                                       --resource-group

Parametri necessari

--cluster-name

Il nome del cluster.

--name -n

Nome della configurazione.

--resource-group -g

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

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--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

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

az aks maintenanceconfiguration list

Elencare le configurazioni di manutenzione nel cluster Kubernetes gestito.

az aks maintenanceconfiguration list --cluster-name
                                     --resource-group

Parametri necessari

--cluster-name

Il nome del cluster.

--resource-group -g

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

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--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

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

az aks maintenanceconfiguration list (aks-preview estensione)

Elencare le configurazioni di manutenzione nel cluster Kubernetes gestito.

az aks maintenanceconfiguration list --cluster-name
                                     --resource-group

Parametri necessari

--cluster-name

Il nome del cluster.

--resource-group -g

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

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--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

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

az aks maintenanceconfiguration show

Visualizzare i dettagli di una configurazione di manutenzione nel cluster Kubernetes gestito.

az aks maintenanceconfiguration show --cluster-name
                                     --name
                                     --resource-group

Parametri necessari

--cluster-name

Il nome del cluster.

--name -n

Nome della configurazione.

--resource-group -g

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

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--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

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

az aks maintenanceconfiguration show (aks-preview estensione)

Visualizzare i dettagli di una configurazione di manutenzione nel cluster Kubernetes gestito.

az aks maintenanceconfiguration show --cluster-name
                                     --name
                                     --resource-group

Parametri necessari

--cluster-name

Il nome del cluster.

--name -n

Nome della configurazione.

--resource-group -g

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

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--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

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

az aks maintenanceconfiguration update

Aggiornare una configurazione di manutenzione di un cluster Kubernetes gestito.

az aks maintenanceconfiguration update --cluster-name
                                       --name
                                       --resource-group
                                       [--config-file]
                                       [--day-of-month]
                                       [--day-of-week]
                                       [--duration]
                                       [--interval-days]
                                       [--interval-months]
                                       [--interval-weeks]
                                       [--schedule-type {AbsoluteMonthly, Daily, RelativeMonthly, Weekly}]
                                       [--start-date]
                                       [--start-hour]
                                       [--start-time]
                                       [--utc-offset]
                                       [--week-index {First, Fourth, Last, Second, Third}]
                                       [--weekday]

Esempio

Aggiornare la configurazione di manutenzione predefinita con --weekday e --start-hour.

az aks maintenanceconfiguration update -g MyResourceGroup --cluster-name test1 -n default --weekday Monday  --start-hour 1
  The maintenance is allowed on Monday 1:00am to 2:00am

Aggiornare la configurazione di manutenzione predefinita con --weekday. La manutenzione è consentita in qualsiasi momento di quel giorno.

az aks maintenanceconfiguration update -g MyResourceGroup --cluster-name test1 -n default --weekday Monday
  The maintenance is allowed on Monday.

Aggiornare la configurazione di manutenzione predefinita con il file JSON di configurazione della manutenzione

az aks maintenanceconfiguration update -g MyResourceGroup --cluster-name test1 -n default --config-file ./test.json
    The content of json file looks below. It means the maintenance is allowed on UTC time Tuesday 1:00am - 3:00 am and Wednesday 1:00am - 2:00am, 6:00am-7:00am
    No maintenance is allowed from 2020-11-26T03:00:00Z to 2020-11-30T12:00:00Z and from 2020-12-26T03:00:00Z to 2020-12-26T12:00:00Z even if they are allowed in the above weekly setting
    {
          "timeInWeek": [
            {
              "day": "Tuesday",
              "hourSlots": [
                1,
                2
              ]
            },
            {
              "day": "Wednesday",
              "hourSlots": [
                1,
                6
              ]
            }
          ],
          "notAllowedTime": [
            {
              "start": "2021-11-26T03:00:00Z",
              "end": "2021-11-30T12:00:00Z"
            },
            {
              "start": "2021-12-26T03:00:00Z",
              "end": "2021-12-26T12:00:00Z"
            }
          ]
  }

Aggiornare aksManagedNodeOSUpgradeSchedule manutenzione con pianificazione giornaliera.

az aks maintenanceconfiguration update -g MyResourceGroup --cluster-name test1 -n aksManagedNodeOSUpgradeSchedule --schedule-type Daily --interval-days 2 --duration 12 --utc-offset=-08:00 --start-date 2023-01-16 --start-time 00:00
  The maintenance is allowed from 00:00 to 12:00 (adjusted with UTC offset: -08:00) every two days. This configuration will be effective from 2023-01-16.

Aggiornare aksManagedNodeOSUpgradeSchedule manutenzione con pianificazione settimanale.

az aks maintenanceconfiguration update -g MyResourceGroup --cluster-name test1 -n aksManagedNodeOSUpgradeSchedule --schedule-type Weekly --day-of-week Friday --interval-weeks 3 --duration 8 --utc-offset +05:30 --start-date 2023-01-16 --start-time 09:30
  The maintenance is allowed on Friday from 09:30 to 17:30 (adjusted with UTC offset: +05:30) every three weeks. This configuration will be effective from 2023-01-16.

Aggiornare aksManagedAutoUpgradeSchedule manutenzione con pianificazione mensile assoluta.

az aks maintenanceconfiguration update -g MyResourceGroup --cluster-name test1 -n aksManagedAutoUpgradeSchedule --schedule-type AbsoluteMonthly --day-of-month 15 --interval-months 1 --duration 6 --utc-offset +05:30 --start-date 2023-01-16 --start-time 09:30
  The maintenance is allowed on the 15th of the month from 09:30 to 15:30 (adjusted with UTC offset: +05:30) every month. This configuration will be effective from 2023-01-16.

Aggiornare aksManagedAutoUpgradeSchedule manutenzione con pianificazione mensile relativa.

az aks maintenanceconfiguration update -g MyResourceGroup --cluster-name test1 -n aksManagedAutoUpgradeSchedule --schedule-type RelativeMonthly --day-of-week Tuesday --week-index Last --interval-months 3 --duration 6 --start-date 2023-01-16 --start-time 09:30
  The maintenance is allowed on the last Tuesday from 09:30 to 15:30 in default UTC time every 3 months. This configuration will be effective from 2023-01-16.

Aggiornare aksManagedAutoUpgradeSchedule maintenance configuration with json file (Aggiornare aksManagedAutoUpgradeSchedule maintenance configuration with json file).

az aks maintenanceconfiguration update -g MyResourceGroup --cluster-name test1 -n aksManagedAutoUpgradeSchedule --config-file ./test.json
    The content of json file looks below. It means the maintenance is allowed on the 1st of the month from 09:00 to 13:00 (adjusted with UTC offset: -08:00) every 3 months, and this configuration will be effective from 2023-01-16.
    No maintenance is allowed from 2022-12-23 to 2023-01-05 and from 2023-11-23 to 2023-11-26 even if they are allowed in the above monthly setting
    {
        "maintenanceWindow": {
            "schedule": {
                "absoluteMonthly": {
                    "intervalMonths": 3,
                    "dayOfMonth": 1
                }
            },
            "durationHours": 4,
            "utcOffset": "-08:00",
            "startTime": "09:00",
            "notAllowedDates": [
                {
                    "start": "2022-12-23",
                    "end": "2023-01-05"
                },
                {
                    "start": "2023-11-23",
                    "end": "2023-11-26"
                }
            ]
        }
    }

Parametri necessari

--cluster-name

Il nome del cluster.

--name -n

Nome della configurazione.

--resource-group -g

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

Parametri facoltativi

--config-file

File JSON di configurazione della manutenzione.

--day-of-month

Specificare il giorno del mese in cui viene eseguita la manutenzione. Ad esempio, 1 indica il primo del mese. Applicabile solo al tipo di pianificazione mensile assoluto.

--day-of-week

Specificare il giorno della settimana in cui viene eseguita la manutenzione. Ad esempio "Lunedì". Applicabile ai tipi di pianificazione settimanale e mensile relativa.

--duration

La lunghezza della finestra di manutenzione varia da 4 a 24 ore.

--interval-days

Numero di giorni tra ogni set di occorrenze per il tipo di pianificazione giornaliera.

--interval-months

Numero di mesi tra ogni set di occorrenze. Applicabile ai tipi di pianificazione mensili assoluti e relativi.

--interval-weeks

Numero di settimane tra ogni set di occorrenze. Applicabile solo ai tipi di pianificazione settimanali.

--schedule-type

Scegliere "Daily", "Weekly", "AbsoluteMonthly" o "RelativeMonthly" per la pianificazione della manutenzione. Applicabile solo alla configurazione di manutenzione "aksManagedAutoUpgradeSchedule" e "aksManagedNodeOSUpgradeSchedule".

valori accettati: AbsoluteMonthly, Daily, RelativeMonthly, Weekly
--start-date

Data di attivazione della configurazione di manutenzione. Se non specificato, la finestra di manutenzione sarà immediatamente attiva".

--start-hour

Ora di inizio di 1 ora consentita per la manutenzione. Ad esempio, 1 significa che è consentito tra le 1:00 e le 2:00. Applicabile solo alla configurazione di manutenzione predefinita.

--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. Ad esempio, '02:00' con '--utc-offset +02:00' indica l'ora UTC '00:00'.

--utc-offset

Offset UTC in formato +/-HH:mm. Ad esempio, '+05:30' per IST e '-07:00' per PST. Se non specificato, il valore predefinito è '+00:00'.

--week-index

Specificare in quale istanza dei giorni consentiti specificati in '--day-of-week' viene eseguita la manutenzione. Applicabile solo al tipo di pianificazione mensile relativo.

valori accettati: First, Fourth, Last, Second, Third
--weekday

Giorno della settimana in cui è consentita la manutenzione. Ad esempio lunedì. Applicabile solo alla configurazione di manutenzione predefinita.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--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

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

az aks maintenanceconfiguration update (aks-preview estensione)

Aggiornare una configurazione di manutenzione di un cluster Kubernetes gestito.

az aks maintenanceconfiguration update --cluster-name
                                       --name
                                       --resource-group
                                       [--config-file]
                                       [--day-of-month]
                                       [--day-of-week]
                                       [--duration]
                                       [--interval-days]
                                       [--interval-months]
                                       [--interval-weeks]
                                       [--schedule-type {AbsoluteMonthly, Daily, RelativeMonthly, Weekly}]
                                       [--start-date]
                                       [--start-hour]
                                       [--start-time]
                                       [--utc-offset]
                                       [--week-index {First, Fourth, Last, Second, Third}]
                                       [--weekday]

Esempio

Aggiornare la configurazione di manutenzione predefinita con --weekday e --start-hour.

az aks maintenanceconfiguration update -g MyResourceGroup --cluster-name test1 -n default --weekday Monday  --start-hour 1
  The maintenance is allowed on Monday 1:00am to 2:00am

Aggiornare la configurazione di manutenzione predefinita con --weekday. La manutenzione è consentita in qualsiasi momento di quel giorno.

az aks maintenanceconfiguration update -g MyResourceGroup --cluster-name test1 -n default --weekday Monday
  The maintenance is allowed on Monday.

Aggiornare la configurazione di manutenzione predefinita con il file JSON di configurazione della manutenzione

az aks maintenanceconfiguration update -g MyResourceGroup --cluster-name test1 -n default --config-file ./test.json
    The content of json file looks below. It means the maintenance is allowed on UTC time Tuesday 1:00am - 3:00 am and Wednesday 1:00am - 2:00am, 6:00am-7:00am
    No maintenance is allowed from 2020-11-26T03:00:00Z to 2020-11-30T12:00:00Z and from 2020-12-26T03:00:00Z to 2020-12-26T12:00:00Z even if they are allowed in the above weekly setting
    {
          "timeInWeek": [
            {
              "day": "Tuesday",
              "hourSlots": [
                1,
                2
              ]
            },
            {
              "day": "Wednesday",
              "hourSlots": [
                1,
                6
              ]
            }
          ],
          "notAllowedTime": [
            {
              "start": "2021-11-26T03:00:00Z",
              "end": "2021-11-30T12:00:00Z"
            },
            {
              "start": "2021-12-26T03:00:00Z",
              "end": "2021-12-26T12:00:00Z"
            }
          ]
  }

Aggiornare aksManagedNodeOSUpgradeSchedule manutenzione con pianificazione giornaliera.

az aks maintenanceconfiguration update -g MyResourceGroup --cluster-name test1 -n aksManagedNodeOSUpgradeSchedule --schedule-type Daily --interval-days 2 --duration 12 --utc-offset=-08:00 --start-date 2023-01-16 --start-time 00:00
  The maintenance is allowed from 00:00 to 12:00 (adjusted with UTC offset: -08:00) every two days. This configuration will be effective from 2023-01-16.

Aggiornare aksManagedNodeOSUpgradeSchedule manutenzione con pianificazione settimanale.

az aks maintenanceconfiguration update -g MyResourceGroup --cluster-name test1 -n aksManagedNodeOSUpgradeSchedule --schedule-type Weekly --day-of-week Friday --interval-weeks 3 --duration 8 --utc-offset +05:30 --start-date 2023-01-16 --start-time 09:30
  The maintenance is allowed on Friday from 09:30 to 17:30 (adjusted with UTC offset: +05:30) every three weeks. This configuration will be effective from 2023-01-16.

Aggiornare aksManagedAutoUpgradeSchedule manutenzione con pianificazione mensile assoluta.

az aks maintenanceconfiguration update -g MyResourceGroup --cluster-name test1 -n aksManagedAutoUpgradeSchedule --schedule-type AbsoluteMonthly --day-of-month 15 --interval-months 1 --duration 6 --utc-offset +05:30 --start-date 2023-01-16 --start-time 09:30
  The maintenance is allowed on the 15th of the month from 09:30 to 15:30 (adjusted with UTC offset: +05:30) every month. This configuration will be effective from 2023-01-16.

Aggiornare aksManagedAutoUpgradeSchedule manutenzione con pianificazione mensile relativa.

az aks maintenanceconfiguration update -g MyResourceGroup --cluster-name test1 -n aksManagedAutoUpgradeSchedule --schedule-type RelativeMonthly --day-of-week Tuesday --week-index Last --interval-months 3 --duration 6 --start-date 2023-01-16 --start-time 09:30
  The maintenance is allowed on the last Tuesday from 09:30 to 15:30 in default UTC time every 3 months. This configuration will be effective from 2023-01-16.

Aggiornare aksManagedAutoUpgradeSchedule maintenance configuration with json file (Aggiornare aksManagedAutoUpgradeSchedule maintenance configuration with json file).

az aks maintenanceconfiguration update -g MyResourceGroup --cluster-name test1 -n aksManagedAutoUpgradeSchedule --config-file ./test.json
    The content of json file looks below. It means the maintenance is allowed on the 1st of the month from 09:00 to 13:00 (adjusted with UTC offset: -08:00) every 3 months, and this configuration will be effective from 2023-01-16.
    No maintenance is allowed from 2022-12-23 to 2023-01-05 and from 2023-11-23 to 2023-11-26 even if they are allowed in the above monthly setting
    {
        "maintenanceWindow": {
            "schedule": {
                "absoluteMonthly": {
                    "intervalMonths": 3,
                    "dayOfMonth": 1
                }
            },
            "durationHours": 4,
            "utcOffset": "-08:00",
            "startTime": "09:00",
            "notAllowedDates": [
                {
                    "start": "2022-12-23",
                    "end": "2023-01-05"
                },
                {
                    "start": "2023-11-23",
                    "end": "2023-11-26"
                }
            ]
        }
    }

Parametri necessari

--cluster-name

Il nome del cluster.

--name -n

Nome della configurazione.

--resource-group -g

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

Parametri facoltativi

--config-file

File JSON di configurazione della manutenzione.

--day-of-month

Specificare il giorno del mese in cui viene eseguita la manutenzione. Ad esempio, 1 indica il primo del mese. Applicabile solo al tipo di pianificazione mensile assoluto.

--day-of-week

Specificare il giorno della settimana in cui viene eseguita la manutenzione. Ad esempio "Lunedì". Applicabile ai tipi di pianificazione settimanale e mensile relativa.

--duration

La lunghezza della finestra di manutenzione varia da 4 a 24 ore.

--interval-days

Numero di giorni tra ogni set di occorrenze per il tipo di pianificazione giornaliera.

--interval-months

Numero di mesi tra ogni set di occorrenze. Applicabile ai tipi di pianificazione mensili assoluti e relativi.

--interval-weeks

Numero di settimane tra ogni set di occorrenze. Applicabile solo ai tipi di pianificazione settimanali.

--schedule-type

Scegliere "Daily", "Weekly", "AbsoluteMonthly" o "RelativeMonthly" per la pianificazione della manutenzione. Applicabile solo alla configurazione di manutenzione "aksManagedAutoUpgradeSchedule" e "aksManagedNodeOSUpgradeSchedule".

valori accettati: AbsoluteMonthly, Daily, RelativeMonthly, Weekly
--start-date

Data di attivazione della configurazione di manutenzione. Se non specificato, la finestra di manutenzione sarà immediatamente attiva".

--start-hour

Ora di inizio di 1 ora consentita per la manutenzione. Ad esempio, 1 significa che è consentito tra le 1:00 e le 2:00. Applicabile solo alla configurazione di manutenzione predefinita.

--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. Ad esempio, '02:00' con '--utc-offset +02:00' indica l'ora UTC '00:00'.

--utc-offset

Offset UTC in formato +/-HH:mm. Ad esempio, '+05:30' per IST e '-07:00' per PST. Se non specificato, il valore predefinito è '+00:00'.

--week-index

Specificare in quale istanza dei giorni consentiti specificati in '--day-of-week' viene eseguita la manutenzione. Applicabile solo al tipo di pianificazione mensile relativo.

valori accettati: First, Fourth, Last, Second, Third
--weekday

Giorno della settimana in cui è consentita la manutenzione. Ad esempio lunedì. Applicabile solo alla configurazione di manutenzione predefinita.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--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

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