Compartilhar via

az aks maintenanceconfiguration

Note

Esse grupo de comandos tem comandos definidos na CLI do Azure e em pelo menos uma extensão. Instale cada extensão para se beneficiar de seus recursos estendidos. Saiba mais sobre extensões.

Comandos para gerenciar configurações de manutenção no cluster gerenciado do Kubernetes.

Comandos

Nome Description Tipo Status
az aks maintenanceconfiguration add

Adicione uma configuração de manutenção no cluster gerenciado do Kubernetes.

 Core GA
az aks maintenanceconfiguration add (aks-preview extensão)

Adicione uma configuração de manutenção no cluster gerenciado do Kubernetes.

 Extension GA
az aks maintenanceconfiguration delete

Exclua uma configuração de manutenção no cluster gerenciado do Kubernetes.

 Core GA
az aks maintenanceconfiguration delete (aks-preview extensão)

Exclua uma configuração de manutenção no cluster gerenciado do Kubernetes.

 Extension GA
az aks maintenanceconfiguration list

Listar as configurações de manutenção no cluster gerenciado do Kubernetes.

 Core GA
az aks maintenanceconfiguration list (aks-preview extensão)

Listar as configurações de manutenção no cluster gerenciado do Kubernetes.

 Extension GA
az aks maintenanceconfiguration show

Mostre os detalhes de uma configuração de manutenção no cluster gerenciado do Kubernetes.

 Core GA
az aks maintenanceconfiguration show (aks-preview extensão)

Mostre os detalhes de uma configuração de manutenção no cluster gerenciado do Kubernetes.

 Extension GA
az aks maintenanceconfiguration update

Atualize uma configuração de manutenção de um cluster gerenciado do Kubernetes.

 Core GA
az aks maintenanceconfiguration update (aks-preview extensão)

Atualize uma configuração de manutenção de um cluster gerenciado do Kubernetes.

 Extension GA

az aks maintenanceconfiguration add

Editar

Adicione uma configuração de manutenção no cluster gerenciado do Kubernetes.

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]

Exemplos

Adicione a configuração de manutenção padrão com --weekday e --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

Adicione a configuração de manutenção padrão com --weekday. A manutenção é permitido a qualquer hora do dia.

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

Adicionar configuração de manutenção padrão com o arquivo json de configuração de manutenção

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

Adicione a configuração de manutenção aksManagedNodeOSUpgradeSchedule com agendamento diário.

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.

Adicione a configuração de manutenção aksManagedNodeOSUpgradeSchedule com agendamento 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.

Adicione a configuração de manutenção aksManagedAutoUpgradeSchedule com agendamento mensal absoluto.

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.

Adicione a configuração de manutenção aksManagedAutoUpgradeSchedule com agenda mensal 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.

Adicione a configuração de manutenção aksManagedAutoUpgradeSchedule com o arquivo 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 Exigidos

--cluster-name

O nome do cluster.

--name -n

O nome da configuraçã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.

--config-file

O arquivo json de configuração de manutenção.

--day-of-month

Especifique em qual dia do mês a manutenção ocorre. Por exemplo, 1 indica o 1º mês. Aplicável apenas ao tipo de agendamento mensal absoluto.

--day-of-week

Especifique em qual dia da semana a manutenção ocorre. Por exemplo, "Segunda-feira". Aplicável a tipos de agendamento mensal semanais e relativos.

--duration

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

--interval-days

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

--interval-months

O número de meses entre cada conjunto de ocorrências. Aplicável a tipos de agendamento mensal absolutos e relativos.

--interval-weeks

O número de semanas entre cada conjunto de ocorrências. Aplicável somente a tipos de agendamento semanais.

--schedule-type

Escolha 'Daily', 'Weekly', 'AbsoluteMonthly' ou 'RelativeMonthly' para sua agenda de manutenção. Aplicável somente à configuração de manutenção 'aksManagedAutoUpgradeSchedule' e 'aksManagedNodeOSUpgradeSchedule'.

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

A data em que a configuração de manutenção é ativada. Se não for especificado, a janela de manutenção estará ativa imediatamente.".

--start-hour

A hora de início da janela de 1 hora em que a manutenção é permitido. Por exemplo, 1 significa que é permitido entre 1h e 2h. Aplicável somente à configuração de manutenção padrão.

--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' se aplica a esse campo. Por exemplo, '02:00' com '--utc-offset +02:00' significa hora UTC '00:00'.

--utc-offset

O deslocamento UTC no formato +/-HH:mm. Por exemplo, '+05:30' para IST e '-07:00' para PST. Se não for especificado, o padrão será '+00:00'.

--week-index

Especifique em qual instância dos dias permitidos especificados em '--dia da semana' a manutenção ocorre. Aplicável apenas ao tipo de agendamento mensal relativo.

Propriedade Valor
Valores aceitos: First, Fourth, Last, Second, Third
--weekday

Um dia na semana em que a manutenção é permitida. Por exemplo, segunda-feira. Aplicável somente à configuração de manutenção padrão.

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 maintenanceconfiguration add (aks-preview extensão)

Adicione uma configuração de manutenção no cluster gerenciado do Kubernetes.

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]

Exemplos

Adicione a configuração de manutenção padrão com --weekday e --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

Adicione a configuração de manutenção padrão com --weekday. A manutenção é permitido a qualquer hora do dia.

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

Adicionar configuração de manutenção padrão com o arquivo json de configuração de manutenção

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

Adicione a configuração de manutenção aksManagedNodeOSUpgradeSchedule com agendamento diário.

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.

Adicione a configuração de manutenção aksManagedNodeOSUpgradeSchedule com agendamento 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.

Adicione a configuração de manutenção aksManagedAutoUpgradeSchedule com agendamento mensal absoluto.

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.

Adicione a configuração de manutenção aksManagedAutoUpgradeSchedule com agenda mensal 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.

Adicione a configuração de manutenção aksManagedAutoUpgradeSchedule com o arquivo 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 Exigidos

--cluster-name

O nome do cluster.

--name -n

O nome da configuraçã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.

--config-file

O arquivo json de configuração de manutenção.

--day-of-month

Especifique em qual dia do mês a manutenção ocorre. Por exemplo, 1 indica o 1º mês. Aplicável apenas ao tipo de agendamento mensal absoluto.

--day-of-week

Especifique em qual dia da semana a manutenção ocorre. Por exemplo, "Segunda-feira". Aplicável a tipos de agendamento mensal semanais e relativos.

--duration

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

--interval-days

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

--interval-months

O número de meses entre cada conjunto de ocorrências. Aplicável a tipos de agendamento mensal absolutos e relativos.

--interval-weeks

O número de semanas entre cada conjunto de ocorrências. Aplicável somente a tipos de agendamento semanais.

--schedule-type

Escolha 'Daily', 'Weekly', 'AbsoluteMonthly' ou 'RelativeMonthly' para sua agenda de manutenção. Aplicável somente à configuração de manutenção 'aksManagedAutoUpgradeSchedule' e 'aksManagedNodeOSUpgradeSchedule'.

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

A data em que a configuração de manutenção é ativada. Se não for especificado, a janela de manutenção estará ativa imediatamente.".

--start-hour

A hora de início da janela de 1 hora em que a manutenção é permitido. Por exemplo, 1 significa que é permitido entre 1h e 2h. Aplicável somente à configuração de manutenção padrão.

--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' se aplica a esse campo. Por exemplo, '02:00' com '--utc-offset +02:00' significa hora UTC '00:00'.

--utc-offset

O deslocamento UTC no formato +/-HH:mm. Por exemplo, '+05:30' para IST e '-07:00' para PST. Se não for especificado, o padrão será '+00:00'.

--week-index

Especifique em qual instância dos dias permitidos especificados em '--dia da semana' a manutenção ocorre. Aplicável apenas ao tipo de agendamento mensal relativo.

Propriedade Valor
Valores aceitos: First, Fourth, Last, Second, Third
--weekday

Um dia na semana em que a manutenção é permitida. Por exemplo, segunda-feira. Aplicável somente à configuração de manutenção padrão.

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 maintenanceconfiguration delete

Editar

Exclua uma configuração de manutenção no cluster gerenciado do Kubernetes.

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

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name -n

O nome da configuraçã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 maintenanceconfiguration delete (aks-preview extensão)

Exclua uma configuração de manutenção no cluster gerenciado do Kubernetes.

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

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name -n

O nome da configuraçã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 maintenanceconfiguration list

Editar

Listar as configurações de manutenção no cluster gerenciado do Kubernetes.

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

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--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 maintenanceconfiguration list (aks-preview extensão)

Listar as configurações de manutenção no cluster gerenciado do Kubernetes.

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

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--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 maintenanceconfiguration show

Editar

Mostre os detalhes de uma configuração de manutenção no cluster gerenciado do Kubernetes.

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

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name -n

O nome da configuraçã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 maintenanceconfiguration show (aks-preview extensão)

Mostre os detalhes de uma configuração de manutenção no cluster gerenciado do Kubernetes.

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

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name -n

O nome da configuraçã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 maintenanceconfiguration update

Editar

Atualize uma configuração de manutenção de um cluster gerenciado do Kubernetes.

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]

Exemplos

Atualize a configuração de manutenção padrão com --dia da semana e --hora de início.

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

Atualize a configuração de manutenção padrão com --weekday. A manutenção é permitido a qualquer hora do dia.

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

Atualizar a configuração de manutenção padrão com o arquivo json de configuração de manutenção

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

Atualize a configuração de manutenção aksManagedNodeOSUpgradeSchedule com agendamento diário.

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.

Atualize a configuração de manutenção aksManagedNodeOSUpgradeSchedule com agendamento 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.

Atualize a configuração de manutenção aksManagedAutoUpgradeSchedule com agendamento mensal absoluto.

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.

Atualize a configuração de manutenção aksManagedAutoUpgradeSchedule com agenda mensal 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.

Atualize a configuração de manutenção aksManagedAutoUpgradeSchedule com o arquivo 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 Exigidos

--cluster-name

O nome do cluster.

--name -n

O nome da configuraçã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.

--config-file

O arquivo json de configuração de manutenção.

--day-of-month

Especifique em qual dia do mês a manutenção ocorre. Por exemplo, 1 indica o 1º mês. Aplicável apenas ao tipo de agendamento mensal absoluto.

--day-of-week

Especifique em qual dia da semana a manutenção ocorre. Por exemplo, "Segunda-feira". Aplicável a tipos de agendamento mensal semanais e relativos.

--duration

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

--interval-days

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

--interval-months

O número de meses entre cada conjunto de ocorrências. Aplicável a tipos de agendamento mensal absolutos e relativos.

--interval-weeks

O número de semanas entre cada conjunto de ocorrências. Aplicável somente a tipos de agendamento semanais.

--schedule-type

Escolha 'Daily', 'Weekly', 'AbsoluteMonthly' ou 'RelativeMonthly' para sua agenda de manutenção. Aplicável somente à configuração de manutenção 'aksManagedAutoUpgradeSchedule' e 'aksManagedNodeOSUpgradeSchedule'.

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

A data em que a configuração de manutenção é ativada. Se não for especificado, a janela de manutenção estará ativa imediatamente.".

--start-hour

A hora de início da janela de 1 hora em que a manutenção é permitido. Por exemplo, 1 significa que é permitido entre 1h e 2h. Aplicável somente à configuração de manutenção padrão.

--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' se aplica a esse campo. Por exemplo, '02:00' com '--utc-offset +02:00' significa hora UTC '00:00'.

--utc-offset

O deslocamento UTC no formato +/-HH:mm. Por exemplo, '+05:30' para IST e '-07:00' para PST. Se não for especificado, o padrão será '+00:00'.

--week-index

Especifique em qual instância dos dias permitidos especificados em '--dia da semana' a manutenção ocorre. Aplicável apenas ao tipo de agendamento mensal relativo.

Propriedade Valor
Valores aceitos: First, Fourth, Last, Second, Third
--weekday

Um dia na semana em que a manutenção é permitida. Por exemplo, segunda-feira. Aplicável somente à configuração de manutenção padrão.

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 maintenanceconfiguration update (aks-preview extensão)

Atualize uma configuração de manutenção de um cluster gerenciado do Kubernetes.

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]

Exemplos

Atualize a configuração de manutenção padrão com --dia da semana e --hora de início.

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

Atualize a configuração de manutenção padrão com --weekday. A manutenção é permitido a qualquer hora do dia.

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

Atualizar a configuração de manutenção padrão com o arquivo json de configuração de manutenção

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

Atualize a configuração de manutenção aksManagedNodeOSUpgradeSchedule com agendamento diário.

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.

Atualize a configuração de manutenção aksManagedNodeOSUpgradeSchedule com agendamento 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.

Atualize a configuração de manutenção aksManagedAutoUpgradeSchedule com agendamento mensal absoluto.

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.

Atualize a configuração de manutenção aksManagedAutoUpgradeSchedule com agenda mensal 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.

Atualize a configuração de manutenção aksManagedAutoUpgradeSchedule com o arquivo 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 Exigidos

--cluster-name

O nome do cluster.

--name -n

O nome da configuraçã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.

--config-file

O arquivo json de configuração de manutenção.

--day-of-month

Especifique em qual dia do mês a manutenção ocorre. Por exemplo, 1 indica o 1º mês. Aplicável apenas ao tipo de agendamento mensal absoluto.

--day-of-week

Especifique em qual dia da semana a manutenção ocorre. Por exemplo, "Segunda-feira". Aplicável a tipos de agendamento mensal semanais e relativos.

--duration

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

--interval-days

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

--interval-months

O número de meses entre cada conjunto de ocorrências. Aplicável a tipos de agendamento mensal absolutos e relativos.

--interval-weeks

O número de semanas entre cada conjunto de ocorrências. Aplicável somente a tipos de agendamento semanais.

--schedule-type

Escolha 'Daily', 'Weekly', 'AbsoluteMonthly' ou 'RelativeMonthly' para sua agenda de manutenção. Aplicável somente à configuração de manutenção 'aksManagedAutoUpgradeSchedule' e 'aksManagedNodeOSUpgradeSchedule'.

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

A data em que a configuração de manutenção é ativada. Se não for especificado, a janela de manutenção estará ativa imediatamente.".

--start-hour

A hora de início da janela de 1 hora em que a manutenção é permitido. Por exemplo, 1 significa que é permitido entre 1h e 2h. Aplicável somente à configuração de manutenção padrão.

--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' se aplica a esse campo. Por exemplo, '02:00' com '--utc-offset +02:00' significa hora UTC '00:00'.

--utc-offset

O deslocamento UTC no formato +/-HH:mm. Por exemplo, '+05:30' para IST e '-07:00' para PST. Se não for especificado, o padrão será '+00:00'.

--week-index

Especifique em qual instância dos dias permitidos especificados em '--dia da semana' a manutenção ocorre. Aplicável apenas ao tipo de agendamento mensal relativo.

Propriedade Valor
Valores aceitos: First, Fourth, Last, Second, Third
--weekday

Um dia na semana em que a manutenção é permitida. Por exemplo, segunda-feira. Aplicável somente à configuração de manutenção padrão.

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