Microsoft. ContainerService maintenanceWindows 2026-04-02-preview

Definizione della risorsa Bicep

Il tipo di risorsa maintenanceWindows può essere distribuito con operazioni che mirano a:

  • Resource groups - Vedi resource group

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di risorsa

Per creare un Microsoft. Risorsa ContainerService/maintenanceWindows, aggiungi il seguente Bicep al tuo template.

resource symbolicname 'Microsoft.ContainerService/maintenanceWindows@2026-04-02-preview' = {
  location: 'string'
  name: 'string'
  properties: {
    durationHours: int
    notAllowedDates: [
      {
        end: 'string'
        start: 'string'
      }
    ]
    schedule: {
      absoluteMonthly: {
        dayOfMonth: int
        intervalMonths: int
      }
      daily: {
        intervalDays: int
      }
      relativeMonthly: {
        dayOfWeek: 'string'
        intervalMonths: int
        weekIndex: 'string'
      }
      weekly: {
        dayOfWeek: 'string'
        intervalWeeks: int
      }
    }
    startDate: 'string'
    startTime: 'string'
    utcOffset: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valori delle proprietà

Microsoft. ContainerService/maintenanceWindows

Name Description Value
posizione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa string

Vincoli:
Lunghezza minima = 1
Lunghezza massima = 63
Pattern = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-a-zA-Z0-9]{0,61}[a-zA-Z0-9]$ (obbligatorio)
properties Proprietà di una finestra di manutenzione. ManutenzioneFinestreProprietàRisorsaT
tags Tag delle risorse Dizionario di nomi e valori di tag. Vedi tag nei template

AbsoluteMonthlySchedule

Name Description Value
dayOfMonth Data del mese. int

Vincoli:
Valore minimo = 1
Valore massimo = 31 (obbligatorio)
intervalMonths Specifica il numero di mesi tra ogni set di occorrenze. int

Vincoli:
Valore minimo = 1
Valore massimo = 6 (obbligatorio)

DailySchedule

Name Description Value
intervalDays Specifica il numero di giorni tra ogni set di occorrenze. int

Vincoli:
Valore minimo = 1
Valore massimo = 7 (obbligatorio)

DateSpan

Name Description Value
end Data di fine dell'intervallo di date. stringa (obbligatorio)
start Data di inizio dell'intervallo di date. stringa (obbligatorio)

ManutenzioneFinestreProprietàRisorsaT

Name Description Value
durationHours Durata della finestra di manutenzione in ore. int

Vincoli:
Valore minimo = 4
Valore massimo = 24 (obbligatorio)
notAllowedDates Intervalli di date durante i quali la manutenzione non è consentita. 'utcOffset' si applica a
Queste date. Ad esempio, con 'utcOffset: +02:00' e un intervallo di date di
'2026-12-23' a '2027-01-03', la manutenzione sarà bloccata da
'2026-12-22 22:00' a '2027-01-03 22:00' in UTC.
DateSpan[]
schedule Pianificazione ricorrenza per la finestra di manutenzione. Uno e solo uno del calendario
i tipi devono essere specificati: 'giornaliere', 'settimanale', 'assolutaMensile' o 'relativaMensile'.
Programma (richiesto)
startDate Data di attivazione della finestra di manutenzione. Se la data attuale è precedente a questa
la finestra di manutenzione è inattiva e non sarà utilizzata. Se non specificato,
La finestra di manutenzione sarà attiva immediatamente.
string
startTime Ora di inizio della finestra di manutenzione. I valori accettati vanno da '00:00' a
'23:59'. 'utcOffset' si applica a questo campo. Ad esempio: '02:00' con
'utcOffset: +02:00' significa ora UTC '00:00'.
string

Vincoli:
Pattern = ^([01]\d|2[0-3]):[0-5]\d$ (obbligatorio)
utcOffset Offset UTC in formato +/-HH:mm. Ad esempio, '+05:30' per IST e '-07:00'
per PST. Se non specificato, il valore predefinito è '+00:00'.
Nota: questo è uno spostamento statico e non si regola per l'ora legale.
I clienti nelle regioni con osservazione dell'ora d'ordata dovrebbero scegliere l'offset che corrisponde al loro
preferiva l'orologio a muro tutto l'anno; La finestra di manutenzione si sposterà di uno
ora relativa all'ora locale quando inizia o finisce l'ora d'estate.
string

Vincoli:
Modello = ^[+-](0\d|1[0-4]):(00|15|30|45)$

RelativeMonthlySchedule

Name Description Value
dayOfWeek Specifica il giorno della settimana in cui viene eseguita la manutenzione. 'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'Mercoledì' (obbligatorio)
intervalMonths Specifica il numero di mesi tra ogni set di occorrenze. int

Vincoli:
Valore minimo = 1
Valore massimo = 6 (obbligatorio)
weekIndex L'indice della settimana. Specifica la settimana del mese a cui si applica dayOfWeek. 'First'
'Fourth'
'Last'
'Second'
'Terzo' (obbligatorio)

Pianifica

Name Description Value
absoluteMonthly Per le pianificazioni come: "ricorsiamo ogni mese il 15" o "ricorsiamo ogni 3 mesi il 20". AbsoluteMonthlySchedule
daily Per le pianificazioni, ad esempio: "ricorsi ogni giorno" o "ricorsi ogni 3 giorni". DailySchedule
relativeMonthly Per le pianificazioni, ad esempio: "ricorsi ogni mese il primo lunedì" o "ricorsiamo ogni 3 mesi lo scorso venerdì". RelativeMonthlySchedule
settimanale Per le pianificazioni, ad esempio: "ricorsi ogni lunedì" o "ricorsi ogni 3 settimane il mercoledì". WeeklySchedule

TrackedResourceTags

Name Description Value

WeeklySchedule

Name Description Value
dayOfWeek Specifica il giorno della settimana in cui viene eseguita la manutenzione. 'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'Mercoledì' (obbligatorio)
intervalWeeks Specifica il numero di settimane tra ogni set di occorrenze. int

Vincoli:
Valore minimo = 1
Valore massimo = 4 (obbligatorio)

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa maintenanceWindows può essere distribuito con operazioni che mirano a:

Esempi di utilizzo

Formato di risorsa

Per creare un Microsoft. Risorsa ContainerService/maintenanceWindows, aggiungi il seguente JSON al tuo template.

{
  "type": "Microsoft.ContainerService/maintenanceWindows",
  "apiVersion": "2026-04-02-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "durationHours": "int",
    "notAllowedDates": [
      {
        "end": "string",
        "start": "string"
      }
    ],
    "schedule": {
      "absoluteMonthly": {
        "dayOfMonth": "int",
        "intervalMonths": "int"
      },
      "daily": {
        "intervalDays": "int"
      },
      "relativeMonthly": {
        "dayOfWeek": "string",
        "intervalMonths": "int",
        "weekIndex": "string"
      },
      "weekly": {
        "dayOfWeek": "string",
        "intervalWeeks": "int"
      }
    },
    "startDate": "string",
    "startTime": "string",
    "utcOffset": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valori delle proprietà

Microsoft. ContainerService/maintenanceWindows

Name Description Value
apiVersion Versione dell'API '2026-04-02-preview'
posizione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa string

Vincoli:
Lunghezza minima = 1
Lunghezza massima = 63
Pattern = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-a-zA-Z0-9]{0,61}[a-zA-Z0-9]$ (obbligatorio)
properties Proprietà di una finestra di manutenzione. ManutenzioneFinestreProprietàRisorsaT
tags Tag delle risorse Dizionario di nomi e valori di tag. Vedi tag nei template
type Tipo di risorsa 'Microsoft. ContainerService/maintenanceWindows

AbsoluteMonthlySchedule

Name Description Value
dayOfMonth Data del mese. int

Vincoli:
Valore minimo = 1
Valore massimo = 31 (obbligatorio)
intervalMonths Specifica il numero di mesi tra ogni set di occorrenze. int

Vincoli:
Valore minimo = 1
Valore massimo = 6 (obbligatorio)

DailySchedule

Name Description Value
intervalDays Specifica il numero di giorni tra ogni set di occorrenze. int

Vincoli:
Valore minimo = 1
Valore massimo = 7 (obbligatorio)

DateSpan

Name Description Value
end Data di fine dell'intervallo di date. stringa (obbligatorio)
start Data di inizio dell'intervallo di date. stringa (obbligatorio)

ManutenzioneFinestreProprietàRisorsaT

Name Description Value
durationHours Durata della finestra di manutenzione in ore. int

Vincoli:
Valore minimo = 4
Valore massimo = 24 (obbligatorio)
notAllowedDates Intervalli di date durante i quali la manutenzione non è consentita. 'utcOffset' si applica a
Queste date. Ad esempio, con 'utcOffset: +02:00' e un intervallo di date di
'2026-12-23' a '2027-01-03', la manutenzione sarà bloccata da
'2026-12-22 22:00' a '2027-01-03 22:00' in UTC.
DateSpan[]
schedule Pianificazione ricorrenza per la finestra di manutenzione. Uno e solo uno del calendario
i tipi devono essere specificati: 'giornaliere', 'settimanale', 'assolutaMensile' o 'relativaMensile'.
Programma (richiesto)
startDate Data di attivazione della finestra di manutenzione. Se la data attuale è precedente a questa
la finestra di manutenzione è inattiva e non sarà utilizzata. Se non specificato,
La finestra di manutenzione sarà attiva immediatamente.
string
startTime Ora di inizio della finestra di manutenzione. I valori accettati vanno da '00:00' a
'23:59'. 'utcOffset' si applica a questo campo. Ad esempio: '02:00' con
'utcOffset: +02:00' significa ora UTC '00:00'.
string

Vincoli:
Pattern = ^([01]\d|2[0-3]):[0-5]\d$ (obbligatorio)
utcOffset Offset UTC in formato +/-HH:mm. Ad esempio, '+05:30' per IST e '-07:00'
per PST. Se non specificato, il valore predefinito è '+00:00'.
Nota: questo è uno spostamento statico e non si regola per l'ora legale.
I clienti nelle regioni con osservazione dell'ora d'ordata dovrebbero scegliere l'offset che corrisponde al loro
preferiva l'orologio a muro tutto l'anno; La finestra di manutenzione si sposterà di uno
ora relativa all'ora locale quando inizia o finisce l'ora d'estate.
string

Vincoli:
Modello = ^[+-](0\d|1[0-4]):(00|15|30|45)$

RelativeMonthlySchedule

Name Description Value
dayOfWeek Specifica il giorno della settimana in cui viene eseguita la manutenzione. 'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'Mercoledì' (obbligatorio)
intervalMonths Specifica il numero di mesi tra ogni set di occorrenze. int

Vincoli:
Valore minimo = 1
Valore massimo = 6 (obbligatorio)
weekIndex L'indice della settimana. Specifica la settimana del mese a cui si applica dayOfWeek. 'First'
'Fourth'
'Last'
'Second'
'Terzo' (obbligatorio)

Pianifica

Name Description Value
absoluteMonthly Per le pianificazioni come: "ricorsiamo ogni mese il 15" o "ricorsiamo ogni 3 mesi il 20". AbsoluteMonthlySchedule
daily Per le pianificazioni, ad esempio: "ricorsi ogni giorno" o "ricorsi ogni 3 giorni". DailySchedule
relativeMonthly Per le pianificazioni, ad esempio: "ricorsi ogni mese il primo lunedì" o "ricorsiamo ogni 3 mesi lo scorso venerdì". RelativeMonthlySchedule
settimanale Per le pianificazioni, ad esempio: "ricorsi ogni lunedì" o "ricorsi ogni 3 settimane il mercoledì". WeeklySchedule

TrackedResourceTags

Name Description Value

WeeklySchedule

Name Description Value
dayOfWeek Specifica il giorno della settimana in cui viene eseguita la manutenzione. 'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'Mercoledì' (obbligatorio)
intervalWeeks Specifica il numero di settimane tra ogni set di occorrenze. int

Vincoli:
Valore minimo = 1
Valore massimo = 4 (obbligatorio)

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa maintenanceWindows può essere distribuito con operazioni che mirano a:

  • Gruppi di risorse Per un elenco delle proprietà modificate in ogni versione dell'API, vedi il registro modifiche.

Formato di risorsa

Per creare un Microsoft. Risorsa ContainerService/maintenanceWindows, aggiungi il seguente Terraform al tuo template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerService/maintenanceWindows@2026-04-02-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      durationHours = int
      notAllowedDates = [
        {
          end = "string"
          start = "string"
        }
      ]
      schedule = {
        absoluteMonthly = {
          dayOfMonth = int
          intervalMonths = int
        }
        daily = {
          intervalDays = int
        }
        relativeMonthly = {
          dayOfWeek = "string"
          intervalMonths = int
          weekIndex = "string"
        }
        weekly = {
          dayOfWeek = "string"
          intervalWeeks = int
        }
      }
      startDate = "string"
      startTime = "string"
      utcOffset = "string"
    }
  }
}

Valori delle proprietà

Microsoft. ContainerService/maintenanceWindows

Name Description Value
posizione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa string

Vincoli:
Lunghezza minima = 1
Lunghezza massima = 63
Pattern = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-a-zA-Z0-9]{0,61}[a-zA-Z0-9]$ (obbligatorio)
properties Proprietà di una finestra di manutenzione. ManutenzioneFinestreProprietàRisorsaT
tags Tag delle risorse Dizionario di nomi e valori di tag.
type Tipo di risorsa "Microsoft. ContainerService/maintenanceWindows@2026-04-02-anteprima"

AbsoluteMonthlySchedule

Name Description Value
dayOfMonth Data del mese. int

Vincoli:
Valore minimo = 1
Valore massimo = 31 (obbligatorio)
intervalMonths Specifica il numero di mesi tra ogni set di occorrenze. int

Vincoli:
Valore minimo = 1
Valore massimo = 6 (obbligatorio)

DailySchedule

Name Description Value
intervalDays Specifica il numero di giorni tra ogni set di occorrenze. int

Vincoli:
Valore minimo = 1
Valore massimo = 7 (obbligatorio)

DateSpan

Name Description Value
end Data di fine dell'intervallo di date. stringa (obbligatorio)
start Data di inizio dell'intervallo di date. stringa (obbligatorio)

ManutenzioneFinestreProprietàRisorsaT

Name Description Value
durationHours Durata della finestra di manutenzione in ore. int

Vincoli:
Valore minimo = 4
Valore massimo = 24 (obbligatorio)
notAllowedDates Intervalli di date durante i quali la manutenzione non è consentita. 'utcOffset' si applica a
Queste date. Ad esempio, con 'utcOffset: +02:00' e un intervallo di date di
'2026-12-23' a '2027-01-03', la manutenzione sarà bloccata da
'2026-12-22 22:00' a '2027-01-03 22:00' in UTC.
DateSpan[]
schedule Pianificazione ricorrenza per la finestra di manutenzione. Uno e solo uno del calendario
i tipi devono essere specificati: 'giornaliere', 'settimanale', 'assolutaMensile' o 'relativaMensile'.
Programma (richiesto)
startDate Data di attivazione della finestra di manutenzione. Se la data attuale è precedente a questa
la finestra di manutenzione è inattiva e non sarà utilizzata. Se non specificato,
La finestra di manutenzione sarà attiva immediatamente.
string
startTime Ora di inizio della finestra di manutenzione. I valori accettati vanno da '00:00' a
'23:59'. 'utcOffset' si applica a questo campo. Ad esempio: '02:00' con
'utcOffset: +02:00' significa ora UTC '00:00'.
string

Vincoli:
Pattern = ^([01]\d|2[0-3]):[0-5]\d$ (obbligatorio)
utcOffset Offset UTC in formato +/-HH:mm. Ad esempio, '+05:30' per IST e '-07:00'
per PST. Se non specificato, il valore predefinito è '+00:00'.
Nota: questo è uno spostamento statico e non si regola per l'ora legale.
I clienti nelle regioni con osservazione dell'ora d'ordata dovrebbero scegliere l'offset che corrisponde al loro
preferiva l'orologio a muro tutto l'anno; La finestra di manutenzione si sposterà di uno
ora relativa all'ora locale quando inizia o finisce l'ora d'estate.
string

Vincoli:
Modello = ^[+-](0\d|1[0-4]):(00|15|30|45)$

RelativeMonthlySchedule

Name Description Value
dayOfWeek Specifica il giorno della settimana in cui viene eseguita la manutenzione. 'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'Mercoledì' (obbligatorio)
intervalMonths Specifica il numero di mesi tra ogni set di occorrenze. int

Vincoli:
Valore minimo = 1
Valore massimo = 6 (obbligatorio)
weekIndex L'indice della settimana. Specifica la settimana del mese a cui si applica dayOfWeek. 'First'
'Fourth'
'Last'
'Second'
'Terzo' (obbligatorio)

Pianifica

Name Description Value
absoluteMonthly Per le pianificazioni come: "ricorsiamo ogni mese il 15" o "ricorsiamo ogni 3 mesi il 20". AbsoluteMonthlySchedule
daily Per le pianificazioni, ad esempio: "ricorsi ogni giorno" o "ricorsi ogni 3 giorni". DailySchedule
relativeMonthly Per le pianificazioni, ad esempio: "ricorsi ogni mese il primo lunedì" o "ricorsiamo ogni 3 mesi lo scorso venerdì". RelativeMonthlySchedule
settimanale Per le pianificazioni, ad esempio: "ricorsi ogni lunedì" o "ricorsi ogni 3 settimane il mercoledì". WeeklySchedule

TrackedResourceTags

Name Description Value

WeeklySchedule

Name Description Value
dayOfWeek Specifica il giorno della settimana in cui viene eseguita la manutenzione. 'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'Mercoledì' (obbligatorio)
intervalWeeks Specifica il numero di settimane tra ogni set di occorrenze. int

Vincoli:
Valore minimo = 1
Valore massimo = 4 (obbligatorio)