az aks maintenanceconfiguration

Nota:

Este grupo de comandos tiene comandos definidos en la CLI de Azure y al menos una extensión. Instale cada extensión para beneficiarse de sus funcionalidades extendidas. Obtenga más información sobre las extensiones.

Comandos para administrar configuraciones de mantenimiento en el clúster de Kubernetes administrado.

Comandos

Nombre Description Tipo Estado
az aks maintenanceconfiguration add

Agregue una configuración de mantenimiento en el clúster de Kubernetes administrado.

Principal GA
az aks maintenanceconfiguration add (aks-preview extensión)

Agregue una configuración de mantenimiento en el clúster de Kubernetes administrado.

Extensión GA
az aks maintenanceconfiguration delete

Elimine una configuración de mantenimiento en el clúster de Kubernetes administrado.

Principal GA
az aks maintenanceconfiguration delete (aks-preview extensión)

Elimine una configuración de mantenimiento en el clúster de Kubernetes administrado.

Extensión GA
az aks maintenanceconfiguration list

Enumere las configuraciones de mantenimiento en el clúster de Kubernetes administrado.

Principal GA
az aks maintenanceconfiguration list (aks-preview extensión)

Enumere las configuraciones de mantenimiento en el clúster de Kubernetes administrado.

Extensión GA
az aks maintenanceconfiguration show

Muestre los detalles de una configuración de mantenimiento en el clúster de Kubernetes administrado.

Principal GA
az aks maintenanceconfiguration show (aks-preview extensión)

Muestre los detalles de una configuración de mantenimiento en el clúster de Kubernetes administrado.

Extensión GA
az aks maintenanceconfiguration update

Actualice una configuración de mantenimiento de un clúster de Kubernetes administrado.

Principal GA
az aks maintenanceconfiguration update (aks-preview extensión)

Actualice una configuración de mantenimiento de un clúster de Kubernetes administrado.

Extensión GA

az aks maintenanceconfiguration add

Agregue una configuración de mantenimiento en el clúster de Kubernetes administrado.

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]

Ejemplos

Agregue la configuración de mantenimiento predeterminada con --weekday y --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

Agregue la configuración de mantenimiento predeterminada con --weekday. El mantenimiento se permite en cualquier momento de ese día.

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

Adición de la configuración de mantenimiento predeterminada con el archivo JSON de configuración de mantenimiento

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

Agregue la configuración de mantenimiento aksManagedNodeOSUpgradeSchedule con programación diaria.

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.

Agregue la configuración de mantenimiento aksManagedNodeOSUpgradeSchedule con programación semanal.

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.

Agregue la configuración de mantenimiento aksManagedAutoUpgradeSchedule con una programación mensual absoluta.

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.

Agregue la configuración de mantenimiento aksManagedAutoUpgradeSchedule con una programación mensual 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.

Agregue la configuración de mantenimiento aksManagedAutoUpgradeSchedule con el archivo 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"
                }
            ]
        }
    }

Parámetros requeridos

--cluster-name

El nombre del clúster.

--name -n

Nombre de la configuración.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--config-file

El archivo JSON de configuración de mantenimiento.

--day-of-month

Especifique el día del mes en que se produce el mantenimiento. Por ejemplo, 1 indica la 1ª del mes. Aplicable solo al tipo de programación mensual absoluto.

--day-of-week

Especifique el día de la semana que se produce el mantenimiento. Por ejemplo, "lunes". Aplicable a los tipos de programación mensual semanal y relativa.

--duration

La longitud de la ventana de mantenimiento oscila entre 4 y 24 horas.

--interval-days

Número de días entre cada conjunto de repeticiones para el tipo de programación diaria.

--interval-months

Número de meses entre cada conjunto de repeticiones. Aplicable a los tipos de programación mensual absoluta y relativa.

--interval-weeks

Número de semanas entre cada conjunto de repeticiones. Aplicable solo a los tipos de programación semanales.

--schedule-type

Elija "Daily", "Weekly", "AbsoluteMonthly" o "RelativeMonthly" para la programación de mantenimiento. Solo se aplica a la configuración de mantenimiento "aksManagedAutoUpgradeSchedule" y "aksManagedNodeOSUpgradeSchedule".

valores aceptados: AbsoluteMonthly, Daily, RelativeMonthly, Weekly
--start-date

Fecha en que se activa la configuración de mantenimiento. Si no se especifica, la ventana de mantenimiento estará activa inmediatamente".

--start-hour

Hora de inicio de 1 hora en la que se permite el mantenimiento. Por ejemplo, 1 significa que se permite entre las 1:00 y las 2:00 am. Se aplica solo a la configuración de mantenimiento predeterminada.

--start-time

Hora de inicio de la ventana de mantenimiento. Los valores aceptados son de '00:00' a '23:59'. '--utc-offset' se aplica a este campo. Por ejemplo, '02:00' con '--utc-offset +02:00' significa hora UTC '00:00'.

--utc-offset

Desplazamiento UTC en formato +/-HH:mm. Por ejemplo, '+05:30' para IST y '-07:00' para PST. Si no se especifica, el valor predeterminado es "+00:00".

--week-index

Especifique en qué instancia de los días permitidos especificados en "--día de la semana" se produce el mantenimiento. Aplicable solo al tipo de programación mensual relativa.

valores aceptados: First, Fourth, Last, Second, Third
--weekday

Un día a la semana en el que se permite el mantenimiento. Por ejemplo, lunes. Se aplica solo a la configuración de mantenimiento predeterminada.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks maintenanceconfiguration add (aks-preview extensión)

Agregue una configuración de mantenimiento en el clúster de Kubernetes administrado.

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]

Ejemplos

Agregue la configuración de mantenimiento predeterminada con --weekday y --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

Agregue la configuración de mantenimiento predeterminada con --weekday. El mantenimiento se permite en cualquier momento de ese día.

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

Adición de la configuración de mantenimiento predeterminada con el archivo JSON de configuración de mantenimiento

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

Agregue la configuración de mantenimiento aksManagedNodeOSUpgradeSchedule con programación diaria.

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.

Agregue la configuración de mantenimiento aksManagedNodeOSUpgradeSchedule con programación semanal.

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.

Agregue la configuración de mantenimiento aksManagedAutoUpgradeSchedule con una programación mensual absoluta.

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.

Agregue la configuración de mantenimiento aksManagedAutoUpgradeSchedule con una programación mensual 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.

Agregue la configuración de mantenimiento aksManagedAutoUpgradeSchedule con el archivo 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"
                }
            ]
        }
    }

Parámetros requeridos

--cluster-name

El nombre del clúster.

--name -n

Nombre de la configuración.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--config-file

El archivo JSON de configuración de mantenimiento.

--day-of-month

Especifique el día del mes en que se produce el mantenimiento. Por ejemplo, 1 indica la 1ª del mes. Aplicable solo al tipo de programación mensual absoluto.

--day-of-week

Especifique el día de la semana que se produce el mantenimiento. Por ejemplo, "lunes". Aplicable a los tipos de programación mensual semanal y relativa.

--duration

La longitud de la ventana de mantenimiento oscila entre 4 y 24 horas.

--interval-days

Número de días entre cada conjunto de repeticiones para el tipo de programación diaria.

--interval-months

Número de meses entre cada conjunto de repeticiones. Aplicable a los tipos de programación mensual absoluta y relativa.

--interval-weeks

Número de semanas entre cada conjunto de repeticiones. Aplicable solo a los tipos de programación semanales.

--schedule-type

Elija "Daily", "Weekly", "AbsoluteMonthly" o "RelativeMonthly" para la programación de mantenimiento. Solo se aplica a la configuración de mantenimiento "aksManagedAutoUpgradeSchedule" y "aksManagedNodeOSUpgradeSchedule".

valores aceptados: AbsoluteMonthly, Daily, RelativeMonthly, Weekly
--start-date

Fecha en que se activa la configuración de mantenimiento. Si no se especifica, la ventana de mantenimiento estará activa inmediatamente".

--start-hour

Hora de inicio de 1 hora en la que se permite el mantenimiento. Por ejemplo, 1 significa que se permite entre las 1:00 y las 2:00 am. Se aplica solo a la configuración de mantenimiento predeterminada.

--start-time

Hora de inicio de la ventana de mantenimiento. Los valores aceptados son de '00:00' a '23:59'. '--utc-offset' se aplica a este campo. Por ejemplo, '02:00' con '--utc-offset +02:00' significa hora UTC '00:00'.

--utc-offset

Desplazamiento UTC en formato +/-HH:mm. Por ejemplo, '+05:30' para IST y '-07:00' para PST. Si no se especifica, el valor predeterminado es "+00:00".

--week-index

Especifique en qué instancia de los días permitidos especificados en "--día de la semana" se produce el mantenimiento. Aplicable solo al tipo de programación mensual relativa.

valores aceptados: First, Fourth, Last, Second, Third
--weekday

Un día a la semana en el que se permite el mantenimiento. Por ejemplo, lunes. Se aplica solo a la configuración de mantenimiento predeterminada.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks maintenanceconfiguration delete

Elimine una configuración de mantenimiento en el clúster de Kubernetes administrado.

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

Parámetros requeridos

--cluster-name

El nombre del clúster.

--name -n

Nombre de la configuración.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks maintenanceconfiguration delete (aks-preview extensión)

Elimine una configuración de mantenimiento en el clúster de Kubernetes administrado.

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

Parámetros requeridos

--cluster-name

El nombre del clúster.

--name -n

Nombre de la configuración.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks maintenanceconfiguration list

Enumere las configuraciones de mantenimiento en el clúster de Kubernetes administrado.

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

Parámetros requeridos

--cluster-name

El nombre del clúster.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks maintenanceconfiguration list (aks-preview extensión)

Enumere las configuraciones de mantenimiento en el clúster de Kubernetes administrado.

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

Parámetros requeridos

--cluster-name

El nombre del clúster.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks maintenanceconfiguration show

Muestre los detalles de una configuración de mantenimiento en el clúster de Kubernetes administrado.

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

Parámetros requeridos

--cluster-name

El nombre del clúster.

--name -n

Nombre de la configuración.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks maintenanceconfiguration show (aks-preview extensión)

Muestre los detalles de una configuración de mantenimiento en el clúster de Kubernetes administrado.

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

Parámetros requeridos

--cluster-name

El nombre del clúster.

--name -n

Nombre de la configuración.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks maintenanceconfiguration update

Actualice una configuración de mantenimiento de un clúster de Kubernetes administrado.

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]

Ejemplos

Actualice la configuración de mantenimiento predeterminada con --weekday y --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

Actualice la configuración de mantenimiento predeterminada con --weekday. El mantenimiento se permite en cualquier momento de ese día.

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

Actualización de la configuración de mantenimiento predeterminada con el archivo JSON de configuración de mantenimiento

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

Actualice la configuración de mantenimiento aksManagedNodeOSUpgradeSchedule con programación diaria.

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.

Actualice la configuración de mantenimiento aksManagedNodeOSUpgradeSchedule con programación semanal.

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.

Actualice la configuración de mantenimiento aksManagedAutoUpgradeSchedule con una programación mensual absoluta.

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.

Actualice la configuración de mantenimiento aksManagedAutoUpgradeSchedule con una programación mensual 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.

Actualice la configuración de mantenimiento aksManagedAutoUpgradeSchedule con el archivo 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"
                }
            ]
        }
    }

Parámetros requeridos

--cluster-name

El nombre del clúster.

--name -n

Nombre de la configuración.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--config-file

El archivo JSON de configuración de mantenimiento.

--day-of-month

Especifique el día del mes en que se produce el mantenimiento. Por ejemplo, 1 indica la 1ª del mes. Aplicable solo al tipo de programación mensual absoluto.

--day-of-week

Especifique el día de la semana que se produce el mantenimiento. Por ejemplo, "lunes". Aplicable a los tipos de programación mensual semanal y relativa.

--duration

La longitud de la ventana de mantenimiento oscila entre 4 y 24 horas.

--interval-days

Número de días entre cada conjunto de repeticiones para el tipo de programación diaria.

--interval-months

Número de meses entre cada conjunto de repeticiones. Aplicable a los tipos de programación mensual absoluta y relativa.

--interval-weeks

Número de semanas entre cada conjunto de repeticiones. Aplicable solo a los tipos de programación semanales.

--schedule-type

Elija "Daily", "Weekly", "AbsoluteMonthly" o "RelativeMonthly" para la programación de mantenimiento. Solo se aplica a la configuración de mantenimiento "aksManagedAutoUpgradeSchedule" y "aksManagedNodeOSUpgradeSchedule".

valores aceptados: AbsoluteMonthly, Daily, RelativeMonthly, Weekly
--start-date

Fecha en que se activa la configuración de mantenimiento. Si no se especifica, la ventana de mantenimiento estará activa inmediatamente".

--start-hour

Hora de inicio de 1 hora en la que se permite el mantenimiento. Por ejemplo, 1 significa que se permite entre las 1:00 y las 2:00 am. Se aplica solo a la configuración de mantenimiento predeterminada.

--start-time

Hora de inicio de la ventana de mantenimiento. Los valores aceptados son de '00:00' a '23:59'. '--utc-offset' se aplica a este campo. Por ejemplo, '02:00' con '--utc-offset +02:00' significa hora UTC '00:00'.

--utc-offset

Desplazamiento UTC en formato +/-HH:mm. Por ejemplo, '+05:30' para IST y '-07:00' para PST. Si no se especifica, el valor predeterminado es "+00:00".

--week-index

Especifique en qué instancia de los días permitidos especificados en "--día de la semana" se produce el mantenimiento. Aplicable solo al tipo de programación mensual relativa.

valores aceptados: First, Fourth, Last, Second, Third
--weekday

Un día a la semana en el que se permite el mantenimiento. Por ejemplo, lunes. Se aplica solo a la configuración de mantenimiento predeterminada.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aks maintenanceconfiguration update (aks-preview extensión)

Actualice una configuración de mantenimiento de un clúster de Kubernetes administrado.

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]

Ejemplos

Actualice la configuración de mantenimiento predeterminada con --weekday y --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

Actualice la configuración de mantenimiento predeterminada con --weekday. El mantenimiento se permite en cualquier momento de ese día.

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

Actualización de la configuración de mantenimiento predeterminada con el archivo JSON de configuración de mantenimiento

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

Actualice la configuración de mantenimiento aksManagedNodeOSUpgradeSchedule con programación diaria.

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.

Actualice la configuración de mantenimiento aksManagedNodeOSUpgradeSchedule con programación semanal.

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.

Actualice la configuración de mantenimiento aksManagedAutoUpgradeSchedule con una programación mensual absoluta.

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.

Actualice la configuración de mantenimiento aksManagedAutoUpgradeSchedule con una programación mensual 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.

Actualice la configuración de mantenimiento aksManagedAutoUpgradeSchedule con el archivo 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"
                }
            ]
        }
    }

Parámetros requeridos

--cluster-name

El nombre del clúster.

--name -n

Nombre de la configuración.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--config-file

El archivo JSON de configuración de mantenimiento.

--day-of-month

Especifique el día del mes en que se produce el mantenimiento. Por ejemplo, 1 indica la 1ª del mes. Aplicable solo al tipo de programación mensual absoluto.

--day-of-week

Especifique el día de la semana que se produce el mantenimiento. Por ejemplo, "lunes". Aplicable a los tipos de programación mensual semanal y relativa.

--duration

La longitud de la ventana de mantenimiento oscila entre 4 y 24 horas.

--interval-days

Número de días entre cada conjunto de repeticiones para el tipo de programación diaria.

--interval-months

Número de meses entre cada conjunto de repeticiones. Aplicable a los tipos de programación mensual absoluta y relativa.

--interval-weeks

Número de semanas entre cada conjunto de repeticiones. Aplicable solo a los tipos de programación semanales.

--schedule-type

Elija "Daily", "Weekly", "AbsoluteMonthly" o "RelativeMonthly" para la programación de mantenimiento. Solo se aplica a la configuración de mantenimiento "aksManagedAutoUpgradeSchedule" y "aksManagedNodeOSUpgradeSchedule".

valores aceptados: AbsoluteMonthly, Daily, RelativeMonthly, Weekly
--start-date

Fecha en que se activa la configuración de mantenimiento. Si no se especifica, la ventana de mantenimiento estará activa inmediatamente".

--start-hour

Hora de inicio de 1 hora en la que se permite el mantenimiento. Por ejemplo, 1 significa que se permite entre las 1:00 y las 2:00 am. Se aplica solo a la configuración de mantenimiento predeterminada.

--start-time

Hora de inicio de la ventana de mantenimiento. Los valores aceptados son de '00:00' a '23:59'. '--utc-offset' se aplica a este campo. Por ejemplo, '02:00' con '--utc-offset +02:00' significa hora UTC '00:00'.

--utc-offset

Desplazamiento UTC en formato +/-HH:mm. Por ejemplo, '+05:30' para IST y '-07:00' para PST. Si no se especifica, el valor predeterminado es "+00:00".

--week-index

Especifique en qué instancia de los días permitidos especificados en "--día de la semana" se produce el mantenimiento. Aplicable solo al tipo de programación mensual relativa.

valores aceptados: First, Fourth, Last, Second, Third
--weekday

Un día a la semana en el que se permite el mantenimiento. Por ejemplo, lunes. Se aplica solo a la configuración de mantenimiento predeterminada.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.