az aks maintenanceconfiguration

Remarque

Ce groupe de commandes a des commandes définies dans Azure CLI et au moins une extension. Installez chaque extension pour bénéficier de ses fonctionnalités étendues. En savoir plus sur les extensions.

Commandes pour gérer les configurations de maintenance dans un cluster Kubernetes managé.

Commandes

Nom Description Type Statut
az aks maintenanceconfiguration add

Ajoutez une configuration de maintenance dans un cluster Kubernetes managé.

Core GA
az aks maintenanceconfiguration add (aks-preview extension)

Ajoutez une configuration de maintenance dans un cluster Kubernetes managé.

Extension GA
az aks maintenanceconfiguration delete

Supprimez une configuration de maintenance dans un cluster Kubernetes managé.

Core GA
az aks maintenanceconfiguration delete (aks-preview extension)

Supprimez une configuration de maintenance dans un cluster Kubernetes managé.

Extension GA
az aks maintenanceconfiguration list

Répertoriez les configurations de maintenance dans un cluster Kubernetes managé.

Core GA
az aks maintenanceconfiguration list (aks-preview extension)

Répertoriez les configurations de maintenance dans un cluster Kubernetes managé.

Extension GA
az aks maintenanceconfiguration show

Affichez les détails d’une configuration de maintenance dans un cluster Kubernetes managé.

Core GA
az aks maintenanceconfiguration show (aks-preview extension)

Affichez les détails d’une configuration de maintenance dans un cluster Kubernetes managé.

Extension GA
az aks maintenanceconfiguration update

Mettez à jour une configuration de maintenance d’un cluster Kubernetes managé.

Core GA
az aks maintenanceconfiguration update (aks-preview extension)

Mettez à jour une configuration de maintenance d’un cluster Kubernetes managé.

Extension GA

az aks maintenanceconfiguration add

Ajoutez une configuration de maintenance dans un cluster Kubernetes managé.

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]

Exemples

Ajoutez la configuration de maintenance par défaut avec --week et --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

Ajoutez la configuration de maintenance par défaut avec --week. La maintenance est autorisée à tout moment de cette journée.

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

Ajouter une configuration de maintenance par défaut avec le fichier json de configuration de maintenance

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

Ajoutez la configuration de maintenance aksManagedNodeOSUpgradeSchedule avec une planification quotidienne.

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.

Ajoutez la configuration de maintenance aksManagedNodeOSUpgradeSchedule avec une planification hebdomadaire.

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.

Ajoutez la configuration de maintenance aksManagedAutoUpgradeSchedule avec une planification mensuelle absolue.

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.

Ajoutez la configuration de maintenance aksManagedAutoUpgradeSchedule avec une planification mensuelle relative.

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.

Ajoutez la configuration de maintenance aksManagedAutoUpgradeSchedule avec le fichier json.

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

Paramètres obligatoires

--cluster-name

le nom du cluster ;

--name -n

Nom de la configuration.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--config-file

Fichier json de configuration de maintenance.

--day-of-month

Spécifiez le jour du mois où la maintenance se produit. Par exemple, 1 indique le 1er du mois. Applicable uniquement au type de planification mensuelle absolue.

--day-of-week

Spécifiez le jour de la semaine où la maintenance se produit. Par exemple, « lundi ». Applicable aux types de planification mensuelles hebdomadaires et relatives.

--duration

La durée de la fenêtre de maintenance est comprise entre 4 et 24 heures.

--interval-days

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

--interval-months

Nombre de mois entre chaque ensemble d’occurrences. Applicable aux types de planification mensuelle absolue et relative.

--interval-weeks

Nombre de semaines entre chaque ensemble d’occurrences. Applicable uniquement aux types de planification hebdomadaire.

--schedule-type

Choisissez « Quotidien », « Hebdomadaire », « AbsoluteMonthly » ou « RelativeMonthly » pour votre planification de maintenance. Applicable uniquement à la configuration de maintenance « aksManagedAutoUpgradeSchedule » et « aksManagedNodeOSUpgradeSchedule ».

valeurs acceptées: AbsoluteMonthly, Daily, RelativeMonthly, Weekly
--start-date

Date à laquelle la configuration de maintenance est activée. S’il n’est pas spécifié, la fenêtre de maintenance est active immédiatement. »

--start-hour

Heure de début de la fenêtre de 1 heure autorisée par la maintenance. Par exemple, 1 signifie qu’il est autorisé entre 1h00 et 2h00. Applicable uniquement à la configuration de maintenance par défaut.

--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. Par exemple, « 02:00 » avec « --utc-offset +02:00 » signifie l’heure UTC « 00:00 ».

--utc-offset

Décalage UTC au format +/-HH:mm. Par exemple, « +05:30 » pour IST et « -07:00 » pour PST. S’il n’est pas spécifié, la valeur par défaut est « +00:00 ».

--week-index

Spécifiez sur quelle instance des jours autorisés spécifiés dans « --day-of-week » la maintenance se produit. Applicable uniquement au type de planification mensuelle relative.

valeurs acceptées: First, Fourth, Last, Second, Third
--weekday

Jour en semaine sur lequel la maintenance est autorisée. Par exemple, lundi. Applicable uniquement à la configuration de maintenance par défaut.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az aks maintenanceconfiguration add (aks-preview extension)

Ajoutez une configuration de maintenance dans un cluster Kubernetes managé.

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]

Exemples

Ajoutez la configuration de maintenance par défaut avec --week et --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

Ajoutez la configuration de maintenance par défaut avec --week. La maintenance est autorisée à tout moment de cette journée.

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

Ajouter une configuration de maintenance par défaut avec le fichier json de configuration de maintenance

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

Ajoutez la configuration de maintenance aksManagedNodeOSUpgradeSchedule avec une planification quotidienne.

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.

Ajoutez la configuration de maintenance aksManagedNodeOSUpgradeSchedule avec une planification hebdomadaire.

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.

Ajoutez la configuration de maintenance aksManagedAutoUpgradeSchedule avec une planification mensuelle absolue.

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.

Ajoutez la configuration de maintenance aksManagedAutoUpgradeSchedule avec une planification mensuelle relative.

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.

Ajoutez la configuration de maintenance aksManagedAutoUpgradeSchedule avec le fichier json.

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

Paramètres obligatoires

--cluster-name

le nom du cluster ;

--name -n

Nom de la configuration.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--config-file

Fichier json de configuration de maintenance.

--day-of-month

Spécifiez le jour du mois où la maintenance se produit. Par exemple, 1 indique le 1er du mois. Applicable uniquement au type de planification mensuelle absolue.

--day-of-week

Spécifiez le jour de la semaine où la maintenance se produit. Par exemple, « lundi ». Applicable aux types de planification mensuelles hebdomadaires et relatives.

--duration

La durée de la fenêtre de maintenance est comprise entre 4 et 24 heures.

--interval-days

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

--interval-months

Nombre de mois entre chaque ensemble d’occurrences. Applicable aux types de planification mensuelle absolue et relative.

--interval-weeks

Nombre de semaines entre chaque ensemble d’occurrences. Applicable uniquement aux types de planification hebdomadaire.

--schedule-type

Choisissez « Quotidien », « Hebdomadaire », « AbsoluteMonthly » ou « RelativeMonthly » pour votre planification de maintenance. Applicable uniquement à la configuration de maintenance « aksManagedAutoUpgradeSchedule » et « aksManagedNodeOSUpgradeSchedule ».

valeurs acceptées: AbsoluteMonthly, Daily, RelativeMonthly, Weekly
--start-date

Date à laquelle la configuration de maintenance est activée. S’il n’est pas spécifié, la fenêtre de maintenance est active immédiatement. »

--start-hour

Heure de début de la fenêtre de 1 heure autorisée par la maintenance. Par exemple, 1 signifie qu’il est autorisé entre 1h00 et 2h00. Applicable uniquement à la configuration de maintenance par défaut.

--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. Par exemple, « 02:00 » avec « --utc-offset +02:00 » signifie l’heure UTC « 00:00 ».

--utc-offset

Décalage UTC au format +/-HH:mm. Par exemple, « +05:30 » pour IST et « -07:00 » pour PST. S’il n’est pas spécifié, la valeur par défaut est « +00:00 ».

--week-index

Spécifiez sur quelle instance des jours autorisés spécifiés dans « --day-of-week » la maintenance se produit. Applicable uniquement au type de planification mensuelle relative.

valeurs acceptées: First, Fourth, Last, Second, Third
--weekday

Jour en semaine sur lequel la maintenance est autorisée. Par exemple, lundi. Applicable uniquement à la configuration de maintenance par défaut.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az aks maintenanceconfiguration delete

Supprimez une configuration de maintenance dans un cluster Kubernetes managé.

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

Paramètres obligatoires

--cluster-name

le nom du cluster ;

--name -n

Nom de la configuration.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az aks maintenanceconfiguration delete (aks-preview extension)

Supprimez une configuration de maintenance dans un cluster Kubernetes managé.

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

Paramètres obligatoires

--cluster-name

le nom du cluster ;

--name -n

Nom de la configuration.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az aks maintenanceconfiguration list

Répertoriez les configurations de maintenance dans un cluster Kubernetes managé.

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

Paramètres obligatoires

--cluster-name

le nom du cluster ;

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az aks maintenanceconfiguration list (aks-preview extension)

Répertoriez les configurations de maintenance dans un cluster Kubernetes managé.

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

Paramètres obligatoires

--cluster-name

le nom du cluster ;

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az aks maintenanceconfiguration show

Affichez les détails d’une configuration de maintenance dans un cluster Kubernetes managé.

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

Paramètres obligatoires

--cluster-name

le nom du cluster ;

--name -n

Nom de la configuration.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az aks maintenanceconfiguration show (aks-preview extension)

Affichez les détails d’une configuration de maintenance dans un cluster Kubernetes managé.

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

Paramètres obligatoires

--cluster-name

le nom du cluster ;

--name -n

Nom de la configuration.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az aks maintenanceconfiguration update

Mettez à jour une configuration de maintenance d’un cluster Kubernetes managé.

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]

Exemples

Mettez à jour la configuration de maintenance par défaut avec --week et --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

Mettez à jour la configuration de maintenance par défaut avec --week. La maintenance est autorisée à tout moment de cette journée.

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

Mettre à jour la configuration de maintenance par défaut avec le fichier json de configuration de maintenance

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

Mettez à jour la configuration de maintenance aksManagedNodeOSUpgradeSchedule avec une planification quotidienne.

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.

Mettez à jour la configuration de maintenance aksManagedNodeOSUpgradeSchedule avec une planification hebdomadaire.

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.

Mettez à jour la configuration de maintenance aksManagedAutoUpgradeSchedule avec une planification mensuelle absolue.

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.

Mettez à jour la configuration de maintenance aksManagedAutoUpgradeSchedule avec une planification mensuelle relative.

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.

Mettez à jour la configuration de maintenance aksManagedAutoUpgradeSchedule avec un fichier json.

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

Paramètres obligatoires

--cluster-name

le nom du cluster ;

--name -n

Nom de la configuration.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--config-file

Fichier json de configuration de maintenance.

--day-of-month

Spécifiez le jour du mois où la maintenance se produit. Par exemple, 1 indique le 1er du mois. Applicable uniquement au type de planification mensuelle absolue.

--day-of-week

Spécifiez le jour de la semaine où la maintenance se produit. Par exemple, « lundi ». Applicable aux types de planification mensuelles hebdomadaires et relatives.

--duration

La durée de la fenêtre de maintenance est comprise entre 4 et 24 heures.

--interval-days

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

--interval-months

Nombre de mois entre chaque ensemble d’occurrences. Applicable aux types de planification mensuelle absolue et relative.

--interval-weeks

Nombre de semaines entre chaque ensemble d’occurrences. Applicable uniquement aux types de planification hebdomadaire.

--schedule-type

Choisissez « Quotidien », « Hebdomadaire », « AbsoluteMonthly » ou « RelativeMonthly » pour votre planification de maintenance. Applicable uniquement à la configuration de maintenance « aksManagedAutoUpgradeSchedule » et « aksManagedNodeOSUpgradeSchedule ».

valeurs acceptées: AbsoluteMonthly, Daily, RelativeMonthly, Weekly
--start-date

Date à laquelle la configuration de maintenance est activée. S’il n’est pas spécifié, la fenêtre de maintenance est active immédiatement. »

--start-hour

Heure de début de la fenêtre de 1 heure autorisée par la maintenance. Par exemple, 1 signifie qu’il est autorisé entre 1h00 et 2h00. Applicable uniquement à la configuration de maintenance par défaut.

--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. Par exemple, « 02:00 » avec « --utc-offset +02:00 » signifie l’heure UTC « 00:00 ».

--utc-offset

Décalage UTC au format +/-HH:mm. Par exemple, « +05:30 » pour IST et « -07:00 » pour PST. S’il n’est pas spécifié, la valeur par défaut est « +00:00 ».

--week-index

Spécifiez sur quelle instance des jours autorisés spécifiés dans « --day-of-week » la maintenance se produit. Applicable uniquement au type de planification mensuelle relative.

valeurs acceptées: First, Fourth, Last, Second, Third
--weekday

Jour en semaine sur lequel la maintenance est autorisée. Par exemple, lundi. Applicable uniquement à la configuration de maintenance par défaut.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az aks maintenanceconfiguration update (aks-preview extension)

Mettez à jour une configuration de maintenance d’un cluster Kubernetes managé.

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]

Exemples

Mettez à jour la configuration de maintenance par défaut avec --week et --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

Mettez à jour la configuration de maintenance par défaut avec --week. La maintenance est autorisée à tout moment de cette journée.

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

Mettre à jour la configuration de maintenance par défaut avec le fichier json de configuration de maintenance

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

Mettez à jour la configuration de maintenance aksManagedNodeOSUpgradeSchedule avec une planification quotidienne.

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.

Mettez à jour la configuration de maintenance aksManagedNodeOSUpgradeSchedule avec une planification hebdomadaire.

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.

Mettez à jour la configuration de maintenance aksManagedAutoUpgradeSchedule avec une planification mensuelle absolue.

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.

Mettez à jour la configuration de maintenance aksManagedAutoUpgradeSchedule avec une planification mensuelle relative.

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.

Mettez à jour la configuration de maintenance aksManagedAutoUpgradeSchedule avec un fichier json.

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

Paramètres obligatoires

--cluster-name

le nom du cluster ;

--name -n

Nom de la configuration.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--config-file

Fichier json de configuration de maintenance.

--day-of-month

Spécifiez le jour du mois où la maintenance se produit. Par exemple, 1 indique le 1er du mois. Applicable uniquement au type de planification mensuelle absolue.

--day-of-week

Spécifiez le jour de la semaine où la maintenance se produit. Par exemple, « lundi ». Applicable aux types de planification mensuelles hebdomadaires et relatives.

--duration

La durée de la fenêtre de maintenance est comprise entre 4 et 24 heures.

--interval-days

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

--interval-months

Nombre de mois entre chaque ensemble d’occurrences. Applicable aux types de planification mensuelle absolue et relative.

--interval-weeks

Nombre de semaines entre chaque ensemble d’occurrences. Applicable uniquement aux types de planification hebdomadaire.

--schedule-type

Choisissez « Quotidien », « Hebdomadaire », « AbsoluteMonthly » ou « RelativeMonthly » pour votre planification de maintenance. Applicable uniquement à la configuration de maintenance « aksManagedAutoUpgradeSchedule » et « aksManagedNodeOSUpgradeSchedule ».

valeurs acceptées: AbsoluteMonthly, Daily, RelativeMonthly, Weekly
--start-date

Date à laquelle la configuration de maintenance est activée. S’il n’est pas spécifié, la fenêtre de maintenance est active immédiatement. »

--start-hour

Heure de début de la fenêtre de 1 heure autorisée par la maintenance. Par exemple, 1 signifie qu’il est autorisé entre 1h00 et 2h00. Applicable uniquement à la configuration de maintenance par défaut.

--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. Par exemple, « 02:00 » avec « --utc-offset +02:00 » signifie l’heure UTC « 00:00 ».

--utc-offset

Décalage UTC au format +/-HH:mm. Par exemple, « +05:30 » pour IST et « -07:00 » pour PST. S’il n’est pas spécifié, la valeur par défaut est « +00:00 ».

--week-index

Spécifiez sur quelle instance des jours autorisés spécifiés dans « --day-of-week » la maintenance se produit. Applicable uniquement au type de planification mensuelle relative.

valeurs acceptées: First, Fourth, Last, Second, Third
--weekday

Jour en semaine sur lequel la maintenance est autorisée. Par exemple, lundi. Applicable uniquement à la configuration de maintenance par défaut.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.