az aks maintenancewindow

Note

Esta referência faz parte da extensão aks-preview para a CLI do Azure (versão 2.85.0 ou superior). A extensão vai instalar-se automaticamente na primeira vez que executares um comando de manutenção do az-aks . Saiba mais sobre extensões.

Comandos para gerir recursos ARM peer do MaintenanceWindow.

MaintenanceWindow é um recurso ARM com âmbito de grupo de recursos que define um calendário de manutenção reutilizável. Os utilizadores podem ligar este recurso a uma maintenanceConfiguration pré-existente através maintenanceWindowIdde , de modo que múltiplas configurações de manutenção do Cluster gerido partilham uma única MaintenanceWindow e o cronograma fica num só local.

Requer a Microsoft. Funcionalidade ContainerService/AKSSharedMaintenanceWindowPreview a ser registado na subscrição. A aprovação automática está ativada: az feature register --namespace Microsoft.ContainerService --name AKSSharedMaintenanceWindowPreview.

Comandos

Nome Descrição Tipo Estado
az aks maintenancewindow create

Crie uma janela de manutenção.

 Extension disponibilidade geral
az aks maintenancewindow delete

Apagar uma janela de manutenção.

 Extension disponibilidade geral
az aks maintenancewindow list

Liste o MaintenanceWindows num grupo de recursos, ou em toda a subscrição se --resource-group for omitido.

 Extension disponibilidade geral
az aks maintenancewindow show

Mostrar uma janela de manutenção.

 Extension disponibilidade geral
az aks maintenancewindow update

Atualize uma janela de manutenção.

 Extension disponibilidade geral
az aks maintenancewindow wait

Espere que uma Janela de Manutenção atinja o estado desejado.

 Extension disponibilidade geral

az aks maintenancewindow create

Crie uma janela de manutenção.

Requer a Microsoft. Funcionalidade ContainerService/AKSSharedMaintenanceWindowPreview a ser registado na subscrição. Registe-se uma vez (aprovado automaticamente): 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}]

Exemplos

Crie uma janela semanal de sábado (a forma canónica de "fins de semana de produção").

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

Crie uma janela diária a cada 2 dias a partir de uma data de início 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

Crie uma janela mensal absoluta no dia 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

Crie uma janela mensal relativa na última sexta-feira.

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

Cria uma janela semanal com datas de blackout através de um ficheiro de configuração.

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 Obrigatórios

--name -n

O nome da janela de manutenção.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--config-file

Caminho para um ficheiro JSON que descreve o corpo da MaintenanceWindow. Usa quando precisares de definir campos sem flags dedicados (por exemplo, notAllowedDates / intervalos de datas blackout).

--day-of-month

No dia do mês, ocorre a manutenção. por exemplo, 15. Horário absoluto apenas mensal.

--day-of-week

No dia da semana, ocorre a manutenção. por exemplo, segunda-feira. Apenas horários semanais ou mensais relativos.

--duration

A duração da janela de manutenção em horas. Intervalo 4-24.

--interval-days

Número de dias entre ocorrências. Apenas horário diário.

--interval-months

Número de meses entre ocorrências. Apenas horários AbsolutoMensais ou Relativos.

--interval-weeks

Número de semanas entre ocorrências. Apenas horário semanal.

--location -l

Localização para a Janela de Manutenção. Por defeito, a localização do grupo de recursos é omitida.

--no-wait

Não espere que a operação de longa duração termine.

Propriedade Valor
Valor predefinido: False
--schedule-type

Tipo de recorrência. Um dos diários, semanais, mensais absolutos ou mensais relativos.

Propriedade Valor
Valores aceites: AbsoluteMonthly, Daily, RelativeMonthly, Weekly
--start-date

A data em que a janela de manutenção é ativada. por exemplo, 2026-06-01. Se não for especificado, a janela ativa imediatamente.

--start-time

A hora de início da janela de manutenção. Os valores aceites vão de '00:00' a '23:59'. --utc-offset aplica-se a este campo.

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.

--utc-offset

O deslocamento UTC no formato +/-HH:mm. Por exemplo, '+05:30' para IST ou '-07:00' para PST. O padrão é '+00:00'.

--week-index

Exemplo do dia da semana em que ocorre a manutenção (Primeiro, Segundo, Terceiro, Quarto, Último). Horário apenas mensal relativo.

Propriedade Valor
Valores aceites: First, Fourth, Last, Second, Third
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az aks maintenancewindow delete

Apagar uma janela de manutenção.

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

Parâmetros Obrigatórios

--name -n

O nome da janela de manutenção.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--no-wait

Não espere que a operação de longa duração termine.

Propriedade Valor
Valor predefinido: False
--yes -y

Não solicite confirmação.

Propriedade Valor
Valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az aks maintenancewindow list

Liste o MaintenanceWindows num grupo de recursos, ou em toda a subscrição se --resource-group for omitido.

az aks maintenancewindow list [--resource-group]

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az aks maintenancewindow show

Mostrar uma janela de manutenção.

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

Parâmetros Obrigatórios

--name -n

O nome da janela de manutenção.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az aks maintenancewindow update

Atualize uma janela de manutenção.

Read-modify-write semântica que corresponde az aks update e az aks nodepool update: o MW existente é obtido, os campos fornecidos são fundidos nele, e o corpo resultante é COLOCADO de volta. Campos que não fornece são preservados as-is (etiquetas existentes, escalares de calendário existentes, datas de blackout existentes, etc.).

Quando fornece um arg de calendário (--tipo de horário / --intervalo-* / --dia da semana / --dia do mês / --índice semanal), a forma do calendário é reconstruída de ponta a ponta a partir dos seus args (não pode misturar parcialmente campos Diários + Semanais — escolha um tipo de horário e forneça os seus args necessários).

--tags segue aks update a convenção: passar --tags substitui todo o dicionário de tags; omita --tags para manter as tags existentes.

--localização não pode ser alterada (Semântica TrackedResource — ARM rejeita alterações de localização no PUT). Se for fornecido com um valor diferente do local existente, é ignorado com um aviso.

--ficheiro-config: quando fornecido, o bloco do properties ficheiro JSON substitui o bloco existente properties . Esta é a única forma hoje em dia de mutar intervalos de datas nãoPermitidas / blackout. As bandeiras individuais do calendário são ignoradas neste percurso; As etiquetas seguem a mesma --tags regra que sem --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}]

Exemplos

Atualize apenas as etiquetas (o calendário existente é preservado).

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

Atualize apenas o dia da semana do calendário (a duração / hora de início / etiquetas existentes preservadas).

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

Apenas a duração da alteração (a forma do cronograma existente preservada).

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

Substituir datas de blackout através de um ficheiro de configuração (preserva etiquetas, localização).

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 Obrigatórios

--name -n

O nome da janela de manutenção.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--config-file

Caminho para um ficheiro JSON que descreve o corpo da MaintenanceWindow. Quando fornecido, o JSON define totalmente o recurso ao criar, ou substitui o bloco existente properties na atualização. Este é o único caminho que pode definir campos sem flags dedicados (notAllowedDates, etc.).

--day-of-month

No dia do mês, a manutenção ocorre para o calendário AbsoluteMonthly.

--day-of-week

No dia da semana, a manutenção ocorre para um horário semanal ou mensal relativo.

--duration

A duração da janela de manutenção em horas. Intervalo 4-24.

--interval-days

O número de dias entre cada conjunto de ocorrências para o horário diário.

--interval-months

O número de meses entre cada conjunto de ocorrências para o calendário AbsoluteMonthly ou RelativeMonthly.

--interval-weeks

O número de semanas entre cada conjunto de ocorrências para o calendário semanal.

--location -l

Location. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--no-wait

Não espere que a operação de longa duração termine.

Propriedade Valor
Valor predefinido: False
--schedule-type

Tipo de recorrência: Diário, Semanal, Absoluto Mensal ou RelativoMensal.

Propriedade Valor
Valores aceites: AbsoluteMonthly, Daily, RelativeMonthly, Weekly
--start-date

A data em que a janela de manutenção é ativada. por exemplo, 2026-06-01.

--start-time

A hora de início da janela de manutenção. por exemplo, 09:30.

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.

--utc-offset

O deslocamento UTC no formato +/-HH:mm. por exemplo, -08:00 ou +05:30.

--week-index

Caso do dia da semana especificado em --dia da semana, ocorre a manutenção para o horário RelativeMonthly.

Propriedade Valor
Valores aceites: First, Fourth, Last, Second, Third
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az aks maintenancewindow wait

Espere que uma Janela de Manutenção atinja o estado desejado.

Se uma operação numa Janela de Manutenção foi interrompida ou iniciada com --no-wait, use este comando para esperar que esta seja concluída.

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

Exemplos

Espere que seja criada uma janela de manutenção.

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

Parâmetros Obrigatórios

--name -n

O nome da janela de manutenção.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor predefinido: False
--custom

Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
--deleted

Aguarde até ser excluído.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor predefinido: False
--exists

Aguarde até que o recurso exista.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor predefinido: False
--interval

Intervalo de sondagem em segundos.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor predefinido: 30
--timeout

Espera máxima em segundos.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor predefinido: 3600
--updated

Aguarde até ser atualizado com provisioningState em 'Succeeded'.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False