az aks maintenancewindow

Note

Esta referencia forma parte de la extensión aks-preview para el CLI de Azure (versión 2.85.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az aks maintenancewindow . Obtenga más información sobre las extensiones.

Comandos para administrar los recursos de ARM del mismo nivel de MaintenanceWindow.

MaintenanceWindow es un recurso arm con ámbito de grupo de recursos que define una programación de mantenimiento reutilizable. Los usuarios pueden vincular este recurso a un elemento maintenanceConfiguration preexistente a través maintenanceWindowIdde , por lo que varias configuraciones de mantenimiento managedCluster comparten un único MaintenanceWindow y la programación reside en un solo lugar.

Requiere el Microsoft. Característica ContainerService/AKSSharedMaintenanceWindowPreview que se va a registrar en la suscripción. La aprobación automática está habilitada: az feature register --namespace Microsoft.ContainerService --name AKSSharedMaintenanceWindowPreview.

Comandos

Nombre	Description	Tipo	Estado
az aks maintenancewindow create	Cree un objeto MaintenanceWindow.	Extension	GA
az aks maintenancewindow delete	Elimine un objeto MaintenanceWindow.	Extension	GA
az aks maintenancewindow list	Enumere MaintenanceWindows en un grupo de recursos o en la suscripción si se omite --resource-group.	Extension	GA
az aks maintenancewindow show	Mostrar un objeto MaintenanceWindow.	Extension	GA
az aks maintenancewindow update	Actualizar un maintenanceWindow.	Extension	GA
az aks maintenancewindow wait	Espere a que maintenanceWindow llegue a un estado deseado.	Extension	GA

az aks maintenancewindow create

Cree un objeto MaintenanceWindow.

Requiere el Microsoft. Característica ContainerService/AKSSharedMaintenanceWindowPreview que se va a registrar en la suscripción. Registrar una vez (aprobado automáticamente): az feature register --namespace Microsoft.ContainerService --name AKSSharedMaintenanceWindowPreview.

az aks maintenancewindow create --name
                                --resource-group
                                [--acquire-policy-token]
                                [--change-reference]
                                [--config-file]
                                [--day-of-month]
                                [--day-of-week]
                                [--duration]
                                [--interval-days]
                                [--interval-months]
                                [--interval-weeks]
                                [--location]
                                [--no-wait]
                                [--schedule-type {AbsoluteMonthly, Daily, RelativeMonthly, Weekly}]
                                [--start-date]
                                [--start-time]
                                [--tags]
                                [--utc-offset]
                                [--week-index {First, Fourth, Last, Second, Third}]

Ejemplos

Cree una ventana de sábado semanal (la forma canónica "fines de semana de producción").

az aks maintenancewindow create -g rg-maintenance -n production-weekends -l eastus \
  --schedule-type Weekly --day-of-week Saturday --interval-weeks 1 \
  --start-time "02:00" --duration 8 --utc-offset=-07:00 \
  --tags environment=production

Cree una ventana diaria cada 2 días a partir de una fecha de inicio específica.

az aks maintenancewindow create -g rg-maintenance -n nightly -l eastus \
  --schedule-type Daily --interval-days 2 \
  --start-date 2026-06-01 --start-time "00:00" --duration 6 --utc-offset=-08:00

Cree una ventana mensual absoluta en la 15ª.

az aks maintenancewindow create -g rg-maintenance -n monthly-15 -l eastus \
  --schedule-type AbsoluteMonthly --day-of-month 15 --interval-months 1 \
  --start-time "09:30" --duration 6 --utc-offset=+05:30

Cree una ventana mensual relativa el último viernes.

az aks maintenancewindow create -g rg-maintenance -n last-friday -l eastus \
  --schedule-type RelativeMonthly --day-of-week Friday --week-index Last --interval-months 1 \
  --start-time "01:00" --duration 4 --utc-offset=+00:00

Cree una ventana semanal con fechas de blackout a través de un archivo de configuración.

az aks maintenancewindow create -g rg-maintenance -n weekly-with-holidays -l eastus \
  --config-file ./mw-body.json
  The contents of mw-body.json:
  {
    "properties": {
      "schedule": { "weekly": { "intervalWeeks": 1, "dayOfWeek": "Saturday" } },
      "startTime": "02:00",
      "durationHours": 8,
      "utcOffset": "-07:00",
      "notAllowedDates": [
        { "start": "2026-12-23", "end": "2027-01-05" },
        { "start": "2026-07-04", "end": "2026-07-05" }
      ]
    }
  }

Parámetros requeridos

--name -n

Nombre de la ventana de mantenimiento.

--resource-group -g

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--config-file

Ruta de acceso a un archivo JSON que describe el cuerpo MaintenanceWindow. Use cuando necesite establecer campos sin marcas dedicadas (por ejemplo, notAllowedDates o intervalos de fechas de cierre negro).

--day-of-month

Día del mes que se produce el mantenimiento. Por ejemplo, 15. AbsoluteMonthly solo programa.

--day-of-week

Día de la semana que se produce el mantenimiento. Por ejemplo, lunes. Solo programa semanal o RelativeMonthly.

--duration

Longitud del período de mantenimiento en horas. Intervalo 4-24.

--interval-days

Número de días entre repeticiones. Solo programación diaria.

--interval-months

Número de meses entre repeticiones. AbsoluteMonthly o RelativeMonthly solo programa.

--interval-weeks

Número de semanas entre repeticiones. Solo programación semanal.

--location -l

Ubicación de MaintenanceWindow. El valor predeterminado es la ubicación del grupo de recursos cuando se omite.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

--schedule-type

Tipo de recurrencia. Uno de Daily, Weekly, AbsoluteMonthly o RelativeMonthly.

Propiedad	Valor
Valores aceptados:	AbsoluteMonthly, Daily, RelativeMonthly, Weekly

--start-date

Fecha en que se activa la ventana de mantenimiento. Por ejemplo, 2026-06-01. Si no se especifica, la ventana se activa inmediatamente.

--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.

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--utc-offset

Desplazamiento UTC en formato +/-HH:mm. Por ejemplo, '+05:30' para IST o '-07:00' para PST. El valor predeterminado es '+00:00'.

--week-index

Instancia del día de la semana que se produce el mantenimiento (Primero, Segundo, Tercero, Cuarto, Último). RelativeMonthly solo programa.

Propiedad	Valor
Valores aceptados:	First, Fourth, Last, Second, Third

Parámetros globales

--debug

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

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks maintenancewindow delete

Elimine un objeto MaintenanceWindow.

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

Parámetros requeridos

--name -n

Nombre de la ventana de mantenimiento.

--resource-group -g

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

--yes -y

No solicitar confirmación.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

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

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks maintenancewindow list

Enumere MaintenanceWindows en un grupo de recursos o en la suscripción si se omite --resource-group.

az aks maintenancewindow list [--resource-group]

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--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 del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks maintenancewindow show

Mostrar un objeto MaintenanceWindow.

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

Parámetros requeridos

--name -n

Nombre de la ventana de mantenimiento.

--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 del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks maintenancewindow update

Actualizar un maintenanceWindow.

Semántica de lectura-modificación-escritura que az aks update coincide con y az aks nodepool update: se captura el MW existente, los campos proporcionados se combinan en él y el cuerpo resultante es PUT back. Los campos que no proporcione se conservan as-is (etiquetas existentes, escalares de programación existentes, fechas de blackout existentes, etc.).

Cuando se proporciona un argumento de programación (--schedule-type / --interval-* / --day-of-week / --day-of-month / --week-index), la forma de programación se vuelve a compilar de un extremo a otro desde los argumentos (no se puede mezclar parcialmente los campos Daily + Weekly, elija un tipo de programación y proporcione sus argumentos obligatorios).

--tags sigue aks update la convención: pasar --tags reemplaza el diccionario de etiquetas completas; omite --tags para mantener las etiquetas existentes.

--location no se puede cambiar (semántica trackedResource: ARM rechaza los cambios de ubicación en PUT). Si se proporciona con un valor diferente a la ubicación existente, se omite con una advertencia.

--config-file: cuando se proporciona, el bloque del properties archivo JSON reemplaza al mayorista existente properties . Esta es la única manera actual de mutar los intervalos de fechas notAllowedDates/blackout. Las marcas de programación individuales se omiten en esta ruta de acceso; las etiquetas siguen la misma --tags regla que sin --config-file.

az aks maintenancewindow update --name
                                --resource-group
                                [--acquire-policy-token]
                                [--change-reference]
                                [--config-file]
                                [--day-of-month]
                                [--day-of-week]
                                [--duration]
                                [--interval-days]
                                [--interval-months]
                                [--interval-weeks]
                                [--location]
                                [--no-wait]
                                [--schedule-type {AbsoluteMonthly, Daily, RelativeMonthly, Weekly}]
                                [--start-date]
                                [--start-time]
                                [--tags]
                                [--utc-offset]
                                [--week-index {First, Fourth, Last, Second, Third}]

Ejemplos

Actualice solo las etiquetas (se conserva la programación existente).

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

Actualice solo el día de la semana de la programación (duración existente, hora de inicio o etiquetas conservadas).

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

Cambiar solo la duración (forma de programación existente conservada).

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

Reemplace las fechas de cierre de sesión por medio de un archivo de configuración (conserva etiquetas, ubicación).

az aks maintenancewindow update -g rg-maintenance -n production-weekends --config-file ./mw-body.json
  The contents of mw-body.json should include a complete properties block, e.g.:
  {
    "properties": {
      "schedule": { "weekly": { "intervalWeeks": 1, "dayOfWeek": "Saturday" } },
      "startTime": "02:00",
      "durationHours": 8,
      "utcOffset": "-07:00",
      "notAllowedDates": [ { "start": "2026-12-23", "end": "2027-01-05" } ]
    }
  }

Parámetros requeridos

--name -n

Nombre de la ventana de mantenimiento.

--resource-group -g

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--config-file

Ruta de acceso a un archivo JSON que describe el cuerpo MaintenanceWindow. Cuando se proporciona, el json define completamente el recurso en la creación o reemplaza el bloque existente properties al actualizar. Esta es la única ruta de acceso que puede establecer campos sin marcas dedicadas (notAllowedDates, etc.).

--day-of-month

Día del mes que se produce el mantenimiento para la programación AbsoluteMonthly.

--day-of-week

Día de la semana el mantenimiento se produce para la programación semanal o relativa.

--duration

Longitud del período de mantenimiento en horas. Intervalo 4-24.

--interval-days

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

--interval-months

Número de meses entre cada conjunto de repeticiones para la programación AbsoluteMonthly o RelativeMonthly.

--interval-weeks

Número de semanas entre cada conjunto de repeticiones para la programación semanal.

--location -l

Location. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

--schedule-type

Tipo de periodicidad: Daily, Weekly, AbsoluteMonthly o RelativeMonthly.

Propiedad	Valor
Valores aceptados:	AbsoluteMonthly, Daily, RelativeMonthly, Weekly

--start-date

Fecha en que se activa la ventana de mantenimiento. Por ejemplo, 2026-06-01.

--start-time

Hora de inicio de la ventana de mantenimiento. Por ejemplo, 09:30.

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--utc-offset

Desplazamiento UTC en formato +/-HH:mm. Por ejemplo, -08:00 o +05:30.

--week-index

Instancia del día de la semana especificada en --day-of-week, el mantenimiento se produce para la programación relativeMonthly.

Propiedad	Valor
Valores aceptados:	First, Fourth, Last, Second, Third

Parámetros globales

--debug

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

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks maintenancewindow wait

Espere a que maintenanceWindow llegue a un estado deseado.

Si se interrumpió una operación en maintenanceWindow o se inició con --no-wait, use este comando para esperar a que se complete.

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

Ejemplos

Espere a que se cree un objeto MaintenanceWindow.

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

Parámetros requeridos

--name -n

Nombre de la ventana de mantenimiento.

--resource-group -g

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

Propiedad	Valor
Grupo de parámetros:	Wait Condition Arguments
Valor predeterminado:	False

--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Propiedad	Valor
Grupo de parámetros:	Wait Condition Arguments

--deleted

Espere hasta que se elimine.

Propiedad	Valor
Grupo de parámetros:	Wait Condition Arguments
Valor predeterminado:	False

--exists

Espere hasta que exista el recurso.

Propiedad	Valor
Grupo de parámetros:	Wait Condition Arguments
Valor predeterminado:	False

--interval

Intervalo de sondeo en segundos.

Propiedad	Valor
Grupo de parámetros:	Wait Condition Arguments
Valor predeterminado:	30

--timeout

Espera máxima en segundos.

Propiedad	Valor
Grupo de parámetros:	Wait Condition Arguments
Valor predeterminado:	3600

--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

Propiedad	Valor
Grupo de parámetros:	Wait Condition Arguments
Valor predeterminado:	False

Parámetros globales

--debug

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

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

Comentarios

¿Le ha resultado útil esta página?