az aks maintenancewindow

Note

Cette référence fait partie de l’extension aks-preview pour l’Azure CLI (version 2.85.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az aks maintenancewindow . Apprenez-en davantage sur les extensions.

Commandes pour gérer les ressources ARM homologue MaintenanceWindow.

MaintenanceWindow est une ressource ARM délimitée par un groupe de ressources qui définit une planification de maintenance réutilisable. Les utilisateurs peuvent lier cette ressource à une configuration de maintenance préexistante via maintenanceWindowId, de sorte que plusieurs configurations de maintenance managedCluster partagent un seul MaintenanceWindow et la planification réside dans un seul endroit.

Nécessite le Microsoft. Fonctionnalité ContainerService/AKSSharedMaintenanceWindowPreview à inscrire sur l’abonnement. L’approbation automatique est activée : az feature register --namespace Microsoft.ContainerService --name AKSSharedMaintenanceWindowPreview.

Commandes

Nom	Description	Type	État
az aks maintenancewindow create	Créez un MaintenanceWindow.	Extension	GA
az aks maintenancewindow delete	Supprimez un MaintenanceWindow.	Extension	GA
az aks maintenancewindow list	Répertoriez MaintenanceWindows dans un groupe de ressources ou dans l’abonnement si --resource-group est omis.	Extension	GA
az aks maintenancewindow show	Afficher un MaintenanceWindow.	Extension	GA
az aks maintenancewindow update	Mettez à jour un MaintenanceWindow.	Extension	GA
az aks maintenancewindow wait	Attendez qu’un MaintenanceWindow atteigne un état souhaité.	Extension	GA

az aks maintenancewindow create

Créez un MaintenanceWindow.

Nécessite le Microsoft. Fonctionnalité ContainerService/AKSSharedMaintenanceWindowPreview à inscrire sur l’abonnement. Inscrivez-vous une seule fois (approuvé automatiquement) : 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}]

Exemples

Créez une fenêtre samedi hebdomadaire (forme « week-ends de production » canonique).

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

Créez une fenêtre quotidienne tous les 2 jours à partir d’une date de début spécifique.

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

Créez une fenêtre mensuelle absolue le 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

Créez une fenêtre mensuelle relative le vendredi dernier.

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

Créez une fenêtre hebdomadaire avec des dates d’expiration par le biais d’un fichier config.

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

Paramètres obligatoires

--name -n

Nom de la fenêtre de maintenance.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété	Valeur
Groupe de paramètres:	Global Policy Arguments

--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété	Valeur
Groupe de paramètres:	Global Policy Arguments

--config-file

Chemin d’accès à un fichier JSON décrivant le corps MaintenanceWindow. Utilisez quand vous devez définir des champs sans indicateurs dédiés (par exemple, notAllowedDates /blackout date ranges).

--day-of-month

Jour du mois où la maintenance se produit. par exemple, 15. Planification mensuelle absolue uniquement.

--day-of-week

Le jour de la semaine, la maintenance se produit. par exemple, lundi. Planifications hebdomadaires ou mensuelles relatives uniquement.

--duration

Durée de la fenêtre de maintenance en heures. Plage 4-24.

--interval-days

Nombre de jours entre les occurrences. Planification quotidienne uniquement.

--interval-months

Nombre de mois entre les occurrences. Planifications AbsoluteMonthly ou RelativeMonthly uniquement.

--interval-weeks

Nombre de semaines entre les occurrences. Planification hebdomadaire uniquement.

--location -l

Emplacement de MaintenanceWindow. La valeur par défaut est l’emplacement du groupe de ressources lorsqu’il est omis.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété	Valeur
Valeur par défaut:	False

--schedule-type

Type de récurrence. L’un des mensuels quotidiens, hebdomadaires, absolus ou mensuels relatifs.

Propriété	Valeur
Valeurs acceptées:	AbsoluteMonthly, Daily, RelativeMonthly, Weekly

--start-date

Date à laquelle la fenêtre de maintenance s’active. par exemple, 2026-06-01. Si elle n’est pas spécifiée, la fenêtre s’active immédiatement.

--start-time

Heure de début de la fenêtre de maintenance. Les valeurs acceptées sont comprises entre « 00:00 » et « 23:59 ». --utc-offset s’applique à ce champ.

--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

--utc-offset

Décalage UTC au format +/-HH :mm. Par exemple, ' +05:30' pour IST ou '-07:00' pour PST. La valeur par défaut est « +00:00 ».

--week-index

Instance du jour de la semaine la maintenance se produit (Premier, Deuxième, Troisième, Quatrième, Dernier). Planification mensuelle relative uniquement.

Propriété	Valeur
Valeurs acceptées:	First, Fourth, Last, Second, Third

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété	Valeur
Valeur par défaut:	False

az aks maintenancewindow delete

Supprimez un MaintenanceWindow.

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

Paramètres obligatoires

--name -n

Nom de la fenêtre de maintenance.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété	Valeur
Groupe de paramètres:	Global Policy Arguments

--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété	Valeur
Groupe de paramètres:	Global Policy Arguments

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété	Valeur
Valeur par défaut:	False

--yes -y

Ne pas demander de confirmation.

Propriété	Valeur
Valeur par défaut:	False

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété	Valeur
Valeur par défaut:	False

az aks maintenancewindow list

Répertoriez MaintenanceWindows dans un groupe de ressources ou dans l’abonnement si --resource-group est omis.

az aks maintenancewindow list [--resource-group]

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété	Valeur
Valeur par défaut:	False

az aks maintenancewindow show

Afficher un MaintenanceWindow.

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

Paramètres obligatoires

--name -n

Nom de la fenêtre de maintenance.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété	Valeur
Valeur par défaut:	False

az aks maintenancewindow update

Mettez à jour un MaintenanceWindow.

Correspondances sémantiques az aks update de modification-écriture en lecture-écriture et az aks nodepool update: le MW existant est récupéré, vos champs fournis sont fusionnés sur celui-ci et le corps résultant est MIS en arrière. Les champs que vous ne fournissez pas sont conservés as-is (balises existantes, scalaires de planification existantes, dates de blackout existantes, etc.).

Lorsque vous fournissez un argument de planification (--schedule-type / --interval-* / --day-of-week / --day-of-month / --week-index), la forme de planification est recréé de bout en bout à partir de vos arguments (vous ne pouvez pas mélanger partiellement les champs Quotidien + Hebdomadaire , choisir un type de planification et fournir ses arguments requis).

--tags suit aks update la convention : le passage de --tags remplace le dictionnaire des balises entières ; omettez --tags pour conserver les balises existantes.

--location ne peut pas être modifié (sémantique TrackedResource : ARM rejette les modifications d’emplacement sur PUT). S’il est fourni avec une valeur différente de l’emplacement existant, il est ignoré avec un avertissement.

--config-file : lorsqu’il est fourni, le bloc du properties fichier JSON remplace la vente en gros existante properties . C’est la seule façon aujourd’hui de muter les plages de dates notAllowedDates /blackout. Les indicateurs de planification individuels sont ignorés sur ce chemin ; les balises suivent la même --tags règle que sans --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}]

Exemples

Mettre à jour uniquement les balises (la planification existante est conservée).

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

Mettez à jour uniquement le jour de la semaine de la planification (durée existante / heure de début / balises conservées).

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

Modifier la durée uniquement (forme de planification existante conservée).

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

Remplacez les dates de panne par le biais d’un fichier de configuration (conserve les balises, l’emplacement).

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

Paramètres obligatoires

--name -n

Nom de la fenêtre de maintenance.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété	Valeur
Groupe de paramètres:	Global Policy Arguments

--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété	Valeur
Groupe de paramètres:	Global Policy Arguments

--config-file

Chemin d’accès à un fichier JSON décrivant le corps MaintenanceWindow. Lorsqu’il est fourni, le json définit entièrement la ressource lors de la création ou remplace le bloc existant properties lors de la mise à jour. Il s’agit du seul chemin qui peut définir des champs sans indicateurs dédiés (notAllowedDates, etc.).

--day-of-month

Jour du mois, la maintenance se produit pour la planification AbsoluteMonthly.

--day-of-week

Le jour de la semaine, la maintenance se produit pour la planification hebdomadaire ou mensuelle relative.

--duration

Durée de la fenêtre de maintenance en heures. Plage 4-24.

--interval-days

Nombre de jours entre chaque ensemble d’occurrences pour la planification quotidienne.

--interval-months

Nombre de mois entre chaque ensemble d’occurrences pour la planification AbsoluteMonthly ou RelativeMonthly.

--interval-weeks

Nombre de semaines entre chaque ensemble d’occurrences pour la planification hebdomadaire.

--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété	Valeur
Valeur par défaut:	False

--schedule-type

Type de périodicité : Quotidien, Hebdomadaire, AbsoluteMonthly ou RelativeMonthly.

Propriété	Valeur
Valeurs acceptées:	AbsoluteMonthly, Daily, RelativeMonthly, Weekly

--start-date

Date à laquelle la fenêtre de maintenance s’active. par exemple, 2026-06-01.

--start-time

Heure de début de la fenêtre de maintenance. par exemple, 09:30.

--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

--utc-offset

Décalage UTC au format +/-HH :mm. par exemple - 08:00 ou +05:30.

--week-index

Instance du jour de la semaine spécifiée en ---day-of-week, la maintenance se produit pour la planification mensuelle relative.

Propriété	Valeur
Valeurs acceptées:	First, Fourth, Last, Second, Third

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété	Valeur
Valeur par défaut:	False

az aks maintenancewindow wait

Attendez qu’un MaintenanceWindow atteigne un état souhaité.

Si une opération sur un MaintenanceWindow a été interrompue ou a été démarrée --no-wait, utilisez cette commande pour attendre qu’elle se termine.

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

Exemples

Attendez qu’un MaintenanceWindow soit créé.

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

Paramètres obligatoires

--name -n

Nom de la fenêtre de maintenance.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété	Valeur
Groupe de paramètres:	Global Policy Arguments

--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété	Valeur
Groupe de paramètres:	Global Policy Arguments

--created

Attendez la création avec « provisioningState » sur « Succeeded ».

Propriété	Valeur
Groupe de paramètres:	Wait Condition Arguments
Valeur par défaut:	False

--custom

Attendez que la condition réponde à une requête JMESPath personnalisée. Par exemple, provisioningState !='InProgress', instanceView.statuses[ ?code=='PowerState/running'].

Propriété	Valeur
Groupe de paramètres:	Wait Condition Arguments

--deleted

Attendez la suppression.

Propriété	Valeur
Groupe de paramètres:	Wait Condition Arguments
Valeur par défaut:	False

--exists

Attendez que la ressource existe.

Propriété	Valeur
Groupe de paramètres:	Wait Condition Arguments
Valeur par défaut:	False

--interval

Intervalle d’interrogation en secondes.

Propriété	Valeur
Groupe de paramètres:	Wait Condition Arguments
Valeur par défaut:	30

--timeout

Délai maximal d’attente en secondes.

Propriété	Valeur
Groupe de paramètres:	Wait Condition Arguments
Valeur par défaut:	3600

--updated

Attendez la mise à jour avec provisioningState sur « Réussi ».

Propriété	Valeur
Groupe de paramètres:	Wait Condition Arguments
Valeur par défaut:	False

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété	Valeur
Valeur par défaut:	False

Commentaires

Cette page a-t-elle été utile ?