az aks maintenanceconfiguration
Nota:
Esta referencia forma parte de la extensión aks-preview para la CLI de Azure (versión 2.56.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az aks maintenanceconfiguration . Obtenga más información sobre las extensiones.
Comandos para administrar configuraciones de mantenimiento en el clúster de Kubernetes administrado.
Comandos
Nombre | Description | Tipo | Estado |
---|---|---|---|
az aks maintenanceconfiguration add |
Agregue una configuración de mantenimiento en el clúster de Kubernetes administrado. |
Extensión | GA |
az aks maintenanceconfiguration delete |
Elimine una configuración de mantenimiento en el clúster de Kubernetes administrado. |
Extensión | GA |
az aks maintenanceconfiguration list |
Enumere las configuraciones de mantenimiento en el clúster de Kubernetes administrado. |
Extensión | GA |
az aks maintenanceconfiguration show |
Muestre los detalles de una configuración de mantenimiento en el clúster de Kubernetes administrado. |
Extensión | GA |
az aks maintenanceconfiguration update |
Actualice una configuración de mantenimiento de un clúster de Kubernetes administrado. |
Extensión | GA |
az aks maintenanceconfiguration add
Agregue una configuración de mantenimiento en el clúster de Kubernetes administrado.
az aks maintenanceconfiguration add --cluster-name
--name
--resource-group
[--config-file]
[--day-of-month]
[--day-of-week]
[--duration]
[--interval-days]
[--interval-months]
[--interval-weeks]
[--schedule-type {AbsoluteMonthly, Daily, RelativeMonthly, Weekly}]
[--start-date]
[--start-hour]
[--start-time]
[--utc-offset]
[--week-index {First, Fourth, Last, Second, Third}]
[--weekday]
Ejemplos
Agregue la configuración de mantenimiento predeterminada con --weekday y --start-hour.
az aks maintenanceconfiguration add -g MyResourceGroup --cluster-name test1 -n default --weekday Monday --start-hour 1
The maintenance is allowed on Monday 1:00am to 2:00am
Agregue la configuración de mantenimiento predeterminada con --weekday. El mantenimiento se permite en cualquier momento de ese día.
az aks maintenanceconfiguration add -g MyResourceGroup --cluster-name test1 -n default --weekday Monday
The maintenance is allowed on Monday.
Adición de la configuración de mantenimiento predeterminada con el archivo JSON de configuración de mantenimiento
az aks maintenanceconfiguration add -g MyResourceGroup --cluster-name test1 -n default --config-file ./test.json
The content of json file looks below. It means the maintenance is allowed on UTC time Tuesday 1:00am - 3:00 am and Wednesday 1:00am - 2:00am, 6:00am-7:00am
No maintenance is allowed from 2020-11-26T03:00:00Z to 2020-11-30T12:00:00Z and from 2020-12-26T03:00:00Z to 2020-12-26T12:00:00Z even if they are allowed in the above weekly setting
{
"timeInWeek": [
{
"day": "Tuesday",
"hourSlots": [
1,
2
]
},
{
"day": "Wednesday",
"hourSlots": [
1,
6
]
}
],
"notAllowedTime": [
{
"start": "2021-11-26T03:00:00Z",
"end": "2021-11-30T12:00:00Z"
},
{
"start": "2021-12-26T03:00:00Z",
"end": "2021-12-26T12:00:00Z"
}
]
}
Agregue la configuración de mantenimiento aksManagedNodeOSUpgradeSchedule con programación diaria.
az aks maintenanceconfiguration add -g MyResourceGroup --cluster-name test1 -n aksManagedNodeOSUpgradeSchedule --schedule-type Daily --interval-days 2 --duration 12 --utc-offset=-08:00 --start-date 2023-01-16 --start-time 00:00
The maintenance is allowed from 00:00 to 12:00 (adjusted with UTC offset: -08:00) every two days, and this configuration will be effective from 2023-01-16.
Agregue la configuración de mantenimiento aksManagedNodeOSUpgradeSchedule con programación semanal.
az aks maintenanceconfiguration add -g MyResourceGroup --cluster-name test1 -n aksManagedNodeOSUpgradeSchedule --schedule-type Weekly --day-of-week Friday --interval-weeks 3 --duration 8 --utc-offset +05:30 --start-date 2023-01-16 --start-time 09:30
The maintenance is allowed on Friday from 09:30 to 17:30 (adjusted with UTC offset: +05:30) every three weeks, and this configuration will be effective from 2023-01-16.
Agregue la configuración de mantenimiento aksManagedAutoUpgradeSchedule con una programación mensual absoluta.
az aks maintenanceconfiguration add -g MyResourceGroup --cluster-name test1 -n aksManagedAutoUpgradeSchedule --schedule-type AbsoluteMonthly --day-of-month 15 --interval-months 1 --duration 6 --utc-offset +05:30 --start-date 2023-01-16 --start-time 09:30
The maintenance is allowed on the 15th of the month from 09:30 to 15:30 (adjusted with UTC offset: +05:30) every month, and this configuration will be effective from 2023-01-16.
Agregue la configuración de mantenimiento aksManagedAutoUpgradeSchedule con una programación mensual relativa.
az aks maintenanceconfiguration add -g MyResourceGroup --cluster-name test1 -n aksManagedAutoUpgradeSchedule --schedule-type RelativeMonthly --day-of-week Tuesday --week-index Last --interval-months 3 --duration 6 --start-date 2023-01-16 --start-time 09:30
The maintenance is allowed on the last Tuesday from 09:30 to 15:30 in default UTC time every 3 months, and this configuration will be effective from 2023-01-16.
Agregue la configuración de mantenimiento aksManagedAutoUpgradeSchedule con el archivo json.
az aks maintenanceconfiguration add -g MyResourceGroup --cluster-name test1 -n aksManagedAutoUpgradeSchedule --config-file ./test.json
The content of json file looks below. It means the maintenance is allowed on the 1st of the month from 09:00 to 13:00 (adjusted with UTC offset: -08:00) every 3 months, and this configuration will be effective from 2023-01-16.
No maintenance is allowed from 2022-12-23 to 2023-01-05 and from 2023-11-23 to 2023-11-26 even if they are allowed in the above monthly setting
{
"maintenanceWindow": {
"schedule": {
"absoluteMonthly": {
"intervalMonths": 3,
"dayOfMonth": 1
}
},
"durationHours": 4,
"utcOffset": "-08:00",
"startTime": "09:00",
"notAllowedDates": [
{
"start": "2022-12-23",
"end": "2023-01-05"
},
{
"start": "2023-11-23",
"end": "2023-11-26"
}
]
}
}
Parámetros requeridos
El nombre del clúster.
Nombre de la configuración.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
El archivo JSON de configuración de mantenimiento.
Especifique el día del mes en que se produce el mantenimiento. Por ejemplo, 1 indica la 1ª del mes. Aplicable solo al tipo de programación mensual absoluto.
Especifique el día de la semana que se produce el mantenimiento. Por ejemplo, "lunes". Aplicable a los tipos de programación mensual semanal y relativa.
La longitud de la ventana de mantenimiento oscila entre 4 y 24 horas.
Número de días entre cada conjunto de repeticiones para el tipo de programación diaria.
Número de meses entre cada conjunto de repeticiones. Aplicable a los tipos de programación mensual absoluta y relativa.
Número de semanas entre cada conjunto de repeticiones. Aplicable solo a los tipos de programación semanales.
Elija "Daily", "Weekly", "AbsoluteMonthly" o "RelativeMonthly" para la programación de mantenimiento. Solo se aplica a la configuración de mantenimiento "aksManagedAutoUpgradeSchedule" y "aksManagedNodeOSUpgradeSchedule".
Fecha en que se activa la configuración de mantenimiento. Si no se especifica, la ventana de mantenimiento estará activa inmediatamente".
Hora de inicio de 1 hora en la que se permite el mantenimiento. Por ejemplo, 1 significa que se permite entre las 1:00 y las 2:00 am. Se aplica solo a la configuración de mantenimiento predeterminada.
Hora de inicio de la ventana de mantenimiento. Los valores aceptados son de '00:00' a '23:59'. '--utc-offset' se aplica a este campo. Por ejemplo, '02:00' con '--utc-offset +02:00' significa hora UTC '00:00'.
Desplazamiento UTC en formato +/-HH:mm. Por ejemplo, '+05:30' para IST y '-07:00' para PST. Si no se especifica, el valor predeterminado es "+00:00".
Especifique en qué instancia de los días permitidos especificados en "--día de la semana" se produce el mantenimiento. Aplicable solo al tipo de programación mensual relativa.
Un día a la semana en el que se permite el mantenimiento. Por ejemplo, lunes. Se aplica solo a la configuración de mantenimiento predeterminada.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az aks maintenanceconfiguration delete
Elimine una configuración de mantenimiento en el clúster de Kubernetes administrado.
az aks maintenanceconfiguration delete --cluster-name
--name
--resource-group
Parámetros requeridos
El nombre del clúster.
Nombre de la configuración.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az aks maintenanceconfiguration list
Enumere las configuraciones de mantenimiento en el clúster de Kubernetes administrado.
az aks maintenanceconfiguration list --cluster-name
--resource-group
Parámetros requeridos
El nombre del clúster.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az aks maintenanceconfiguration show
Muestre los detalles de una configuración de mantenimiento en el clúster de Kubernetes administrado.
az aks maintenanceconfiguration show --cluster-name
--name
--resource-group
Parámetros requeridos
El nombre del clúster.
Nombre de la configuración.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az aks maintenanceconfiguration update
Actualice una configuración de mantenimiento de un clúster de Kubernetes administrado.
az aks maintenanceconfiguration update --cluster-name
--name
--resource-group
[--config-file]
[--day-of-month]
[--day-of-week]
[--duration]
[--interval-days]
[--interval-months]
[--interval-weeks]
[--schedule-type {AbsoluteMonthly, Daily, RelativeMonthly, Weekly}]
[--start-date]
[--start-hour]
[--start-time]
[--utc-offset]
[--week-index {First, Fourth, Last, Second, Third}]
[--weekday]
Ejemplos
Actualice la configuración de mantenimiento predeterminada con --weekday y --start-hour.
az aks maintenanceconfiguration update -g MyResourceGroup --cluster-name test1 -n default --weekday Monday --start-hour 1
The maintenance is allowed on Monday 1:00am to 2:00am
Actualice la configuración de mantenimiento predeterminada con --weekday. El mantenimiento se permite en cualquier momento de ese día.
az aks maintenanceconfiguration update -g MyResourceGroup --cluster-name test1 -n default --weekday Monday
The maintenance is allowed on Monday.
Actualización de la configuración de mantenimiento predeterminada con el archivo JSON de configuración de mantenimiento
az aks maintenanceconfiguration update -g MyResourceGroup --cluster-name test1 -n default --config-file ./test.json
The content of json file looks below. It means the maintenance is allowed on UTC time Tuesday 1:00am - 3:00 am and Wednesday 1:00am - 2:00am, 6:00am-7:00am
No maintenance is allowed from 2020-11-26T03:00:00Z to 2020-11-30T12:00:00Z and from 2020-12-26T03:00:00Z to 2020-12-26T12:00:00Z even if they are allowed in the above weekly setting
{
"timeInWeek": [
{
"day": "Tuesday",
"hourSlots": [
1,
2
]
},
{
"day": "Wednesday",
"hourSlots": [
1,
6
]
}
],
"notAllowedTime": [
{
"start": "2021-11-26T03:00:00Z",
"end": "2021-11-30T12:00:00Z"
},
{
"start": "2021-12-26T03:00:00Z",
"end": "2021-12-26T12:00:00Z"
}
]
}
Actualice la configuración de mantenimiento aksManagedNodeOSUpgradeSchedule con programación diaria.
az aks maintenanceconfiguration update -g MyResourceGroup --cluster-name test1 -n aksManagedNodeOSUpgradeSchedule --schedule-type Daily --interval-days 2 --duration 12 --utc-offset=-08:00 --start-date 2023-01-16 --start-time 00:00
The maintenance is allowed from 00:00 to 12:00 (adjusted with UTC offset: -08:00) every two days. This configuration will be effective from 2023-01-16.
Actualice la configuración de mantenimiento aksManagedNodeOSUpgradeSchedule con programación semanal.
az aks maintenanceconfiguration update -g MyResourceGroup --cluster-name test1 -n aksManagedNodeOSUpgradeSchedule --schedule-type Weekly --day-of-week Friday --interval-weeks 3 --duration 8 --utc-offset +05:30 --start-date 2023-01-16 --start-time 09:30
The maintenance is allowed on Friday from 09:30 to 17:30 (adjusted with UTC offset: +05:30) every three weeks. This configuration will be effective from 2023-01-16.
Actualice la configuración de mantenimiento aksManagedAutoUpgradeSchedule con una programación mensual absoluta.
az aks maintenanceconfiguration update -g MyResourceGroup --cluster-name test1 -n aksManagedAutoUpgradeSchedule --schedule-type AbsoluteMonthly --day-of-month 15 --interval-months 1 --duration 6 --utc-offset +05:30 --start-date 2023-01-16 --start-time 09:30
The maintenance is allowed on the 15th of the month from 09:30 to 15:30 (adjusted with UTC offset: +05:30) every month. This configuration will be effective from 2023-01-16.
Actualice la configuración de mantenimiento aksManagedAutoUpgradeSchedule con una programación mensual relativa.
az aks maintenanceconfiguration update -g MyResourceGroup --cluster-name test1 -n aksManagedAutoUpgradeSchedule --schedule-type RelativeMonthly --day-of-week Tuesday --week-index Last --interval-months 3 --duration 6 --start-date 2023-01-16 --start-time 09:30
The maintenance is allowed on the last Tuesday from 09:30 to 15:30 in default UTC time every 3 months. This configuration will be effective from 2023-01-16.
Actualice la configuración de mantenimiento aksManagedAutoUpgradeSchedule con el archivo json.
az aks maintenanceconfiguration update -g MyResourceGroup --cluster-name test1 -n aksManagedAutoUpgradeSchedule --config-file ./test.json
The content of json file looks below. It means the maintenance is allowed on the 1st of the month from 09:00 to 13:00 (adjusted with UTC offset: -08:00) every 3 months, and this configuration will be effective from 2023-01-16.
No maintenance is allowed from 2022-12-23 to 2023-01-05 and from 2023-11-23 to 2023-11-26 even if they are allowed in the above monthly setting
{
"maintenanceWindow": {
"schedule": {
"absoluteMonthly": {
"intervalMonths": 3,
"dayOfMonth": 1
}
},
"durationHours": 4,
"utcOffset": "-08:00",
"startTime": "09:00",
"notAllowedDates": [
{
"start": "2022-12-23",
"end": "2023-01-05"
},
{
"start": "2023-11-23",
"end": "2023-11-26"
}
]
}
}
Parámetros requeridos
El nombre del clúster.
Nombre de la configuración.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
El archivo JSON de configuración de mantenimiento.
Especifique el día del mes en que se produce el mantenimiento. Por ejemplo, 1 indica la 1ª del mes. Aplicable solo al tipo de programación mensual absoluto.
Especifique el día de la semana que se produce el mantenimiento. Por ejemplo, "lunes". Aplicable a los tipos de programación mensual semanal y relativa.
La longitud de la ventana de mantenimiento oscila entre 4 y 24 horas.
Número de días entre cada conjunto de repeticiones para el tipo de programación diaria.
Número de meses entre cada conjunto de repeticiones. Aplicable a los tipos de programación mensual absoluta y relativa.
Número de semanas entre cada conjunto de repeticiones. Aplicable solo a los tipos de programación semanales.
Elija "Daily", "Weekly", "AbsoluteMonthly" o "RelativeMonthly" para la programación de mantenimiento. Solo se aplica a la configuración de mantenimiento "aksManagedAutoUpgradeSchedule" y "aksManagedNodeOSUpgradeSchedule".
Fecha en que se activa la configuración de mantenimiento. Si no se especifica, la ventana de mantenimiento estará activa inmediatamente".
Hora de inicio de 1 hora en la que se permite el mantenimiento. Por ejemplo, 1 significa que se permite entre las 1:00 y las 2:00 am. Se aplica solo a la configuración de mantenimiento predeterminada.
Hora de inicio de la ventana de mantenimiento. Los valores aceptados son de '00:00' a '23:59'. '--utc-offset' se aplica a este campo. Por ejemplo, '02:00' con '--utc-offset +02:00' significa hora UTC '00:00'.
Desplazamiento UTC en formato +/-HH:mm. Por ejemplo, '+05:30' para IST y '-07:00' para PST. Si no se especifica, el valor predeterminado es "+00:00".
Especifique en qué instancia de los días permitidos especificados en "--día de la semana" se produce el mantenimiento. Aplicable solo al tipo de programación mensual relativa.
Un día a la semana en el que se permite el mantenimiento. Por ejemplo, lunes. Se aplica solo a la configuración de mantenimiento predeterminada.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de