az aks maintenancewindow

Note

Essa referência faz parte da extensão aks-preview para o CLI do Azure (versão 2.85.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando az aks maintenancewindow . Saiba mais sobre extensões.

Comandos para gerenciar recursos arm par MaintenanceWindow.

MaintenanceWindow é um recurso arm com escopo de grupo de recursos que define um agendamento de manutenção reutilizável. Os usuários podem vincular esse recurso a uma maintenanceConfiguration pré-existente por meio maintenanceWindowIdde, portanto, várias configurações de manutenção managedCluster compartilham um único MaintenanceWindow e o agendamento reside em um só lugar.

Requer o Microsoft. Recurso ContainerService/AKSSharedMaintenanceWindowPreview a ser registrado na assinatura. A aprovação automática está habilitada: az feature register --namespace Microsoft.ContainerService --name AKSSharedMaintenanceWindowPreview.

Comandos

Nome Description Tipo Status
az aks maintenancewindow create

Crie um MaintenanceWindow.

 Extension GA
az aks maintenancewindow delete

Excluir um MaintenanceWindow.

 Extension GA
az aks maintenancewindow list

Liste MaintenanceWindows em um grupo de recursos ou em toda a assinatura se --resource-group for omitido.

 Extension GA
az aks maintenancewindow show

Mostrar um MaintenanceWindow.

 Extension GA
az aks maintenancewindow update

Atualize um MaintenanceWindow.

 Extension GA
az aks maintenancewindow wait

Aguarde até que um MaintenanceWindow atinja um estado desejado.

 Extension GA

az aks maintenancewindow create

Crie um MaintenanceWindow.

Requer o Microsoft. Recurso ContainerService/AKSSharedMaintenanceWindowPreview a ser registrado na assinatura. Registrar 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 "finais 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

Crie uma janela semanal com datas de apagão por meio de um arquivo 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 se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

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

A ID de referência de alteração relacionada para esta operação de recurso.

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

Caminho para um arquivo JSON que descreve o corpo MaintenanceWindow. Use quando precisar definir campos sem sinalizadores dedicados (por exemplo, notAllowedDates/intervalos de datas de apagão).

--day-of-month

Dia do mês em que a manutenção ocorre. por exemplo, 15. Agendar absoluteMonthly apenas.

--day-of-week

Dia da semana ocorre a manutenção. Por exemplo, segunda-feira. Agendas semanais ou relativas somente.

--duration

O comprimento da janela de manutenção em horas. Intervalo de 4 a 24.

--interval-days

Número de dias entre ocorrências. Somente agendamento diário.

--interval-months

Número de meses entre ocorrências. Agendas absoluteMonthly ou RelativeMonthly apenas.

--interval-weeks

Número de semanas entre ocorrências. Somente agendamento semanal.

--location -l

Local para o MaintenanceWindow. O padrão é o local do grupo de recursos quando omitido.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--schedule-type

Tipo de recorrência. Um de Daily, Weekly, AbsoluteMonthly ou RelativeMonthly.

Propriedade Valor
Valores aceitos: 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 será ativada imediatamente.

--start-time

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

--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas 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

Instância do dia da semana em que a manutenção ocorre (Primeiro, Segundo, Terceiro, Quarto, Último). Somente agendar RelativeMonthly.

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

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az aks maintenancewindow delete

Excluir um MaintenanceWindow.

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 se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

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

A ID de referência de alteração relacionada para esta operação de recurso.

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

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--yes -y

Não solicite confirmação.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az aks maintenancewindow list

Liste MaintenanceWindows em um grupo de recursos ou em toda a assinatura 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 se tornar obrigatórios para que o comando seja executado com sucesso.

--resource-group -g

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

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az aks maintenancewindow show

Mostrar um MaintenanceWindow.

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 Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az aks maintenancewindow update

Atualize um MaintenanceWindow.

Correspondência de semântica az aks update de modificação de leitura e gravação e az aks nodepool update: o MW existente é buscado, seus campos fornecidos são mesclados nele e o corpo resultante é PUT back. Os campos que você não fornece são preservados as-is (marcas existentes, escalares de agenda existentes, datas de apagão existentes etc.).

Quando você fornece um arg de agendamento (--schedule-type / --interval-* / --day-of-week / --day-of-month/--week-index), a forma de agendamento é recriada de ponta a ponta de seusrgs (você não pode misturar parcialmente campos diários + semanais — escolha um tipo de agenda e forneça seus args necessários).

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

--location cannot be changed (TrackedResource semmantics — ARM rejects location changes on PUT). Se for fornecido com um valor diferente do local existente, ele será ignorado com um aviso.

--config-file: quando fornecido, o bloco do properties arquivo JSON substitui o atacado existente properties . Esta é a única maneira hoje de alterar notAllowedDates/intervalos de datas de apagão. Sinalizadores de agenda individuais são ignorados neste caminho; as marcas 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

Atualizar somente marcas (o agendamento existente é preservado).

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

Atualize apenas o dia da semana do agendamento (duração/hora de início/marcas existentes preservadas).

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

Somente a duração da alteração (forma de agendamento existente preservada).

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

Substitua datas de apagão por meio de um arquivo de configuração (preserva marcas, 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 se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

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

A ID de referência de alteração relacionada para esta operação de recurso.

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

Caminho para um arquivo JSON que descreve o corpo MaintenanceWindow. Quando fornecido, o JSON define totalmente o recurso na criação ou substitui o bloco existente properties na atualização. Esse é o único caminho que pode definir campos sem sinalizadores dedicados (notAllowedDates, etc.).

--day-of-month

Dia do mês, a manutenção ocorre para agendamento AbsoluteMonthly.

--day-of-week

Dia da semana, a manutenção ocorre para agendamento Semanal ou RelativeMonthly.

--duration

O comprimento da janela de manutenção em horas. Intervalo de 4 a 24.

--interval-days

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

--interval-months

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

--interval-weeks

O número de semanas entre cada conjunto de ocorrências para agenda 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 aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--schedule-type

Tipo de recorrência: Diário, Semanal, AbsoluteMonthly ou RelativeMonthly.

Propriedade Valor
Valores aceitos: 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

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

--utc-offset

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

--week-index

Instância do dia da semana especificada no --dia da semana em que a manutenção ocorre para agendamento RelativeMonthly.

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

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az aks maintenancewindow wait

Aguarde até que um MaintenanceWindow atinja um estado desejado.

Se uma operação em um MaintenanceWindow foi interrompida ou iniciada --no-wait, use este comando para aguardar a conclusão.

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

Exemplos

Aguarde a criação de um MaintenanceWindow.

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 se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

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

A ID de referência de alteração relacionada 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 padrão: False
--custom

Aguarde até que a condição atenda 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 padrão: False
--exists

Aguarde até que o recurso exista.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: False
--interval

Intervalo de sondagem em segundos.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: 30
--timeout

Espera máxima em segundos.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: 3600
--updated

Aguarde até que seja atualizado com provisioningState em 'Succeeded'.

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

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False