Microsoft. Manutenzione ContainerService Windows

Definizione di risorsa Bicep

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

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

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

Formato risorsa

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

resource symbolicname 'Microsoft.ContainerService/maintenanceWindows@2026-08-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

Nome Descrizione Valore
location 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)
proprietà Proprietà di una finestra di manutenzione. ManutenzioneFinestreProprietàRisorsaT
tags Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

AbsoluteMonthlySchedule

Nome Descrizione Valore
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

Nome Descrizione Valore
intervalDays Specifica il numero di giorni tra ogni set di occorrenze. Int

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

DateSpan

Nome Descrizione Valore
fine Data di fine dell'intervallo di date. stringa (obbligatorio)
start Data di inizio dell'intervallo di date. stringa (obbligatorio)

ManutenzioneFinestreProprietàRisorsaT

Nome Descrizione Valore
durataOre 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.
corda
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

Nome Descrizione Valore
dayOfWeek Specifica il giorno della settimana in cui viene eseguita la manutenzione. 'Venerdì'
'Lunedì'
'Sabato'
'Domenica'
'Giovedì'
'Martedì'
'Mercoledì' (obbligatorio)
intervalMonths Specifica il numero di mesi tra ogni set di occorrenze. Int

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

Schedule

Nome Descrizione Valore
absoluteMonthly Per le pianificazioni come: "ricorsiamo ogni mese il 15" o "ricorsiamo ogni 3 mesi il 20". AbsoluteMonthlySchedule
ogni giorno 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

Nome Descrizione Valore

WeeklySchedule

Nome Descrizione Valore
dayOfWeek Specifica il giorno della settimana in cui viene eseguita la manutenzione. 'Venerdì'
'Lunedì'
'Sabato'
'Domenica'
'Giovedì'
'Martedì'
'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 risorsa

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

{
  "type": "Microsoft.ContainerService/maintenanceWindows",
  "apiVersion": "2026-08-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

Nome Descrizione Valore
apiVersion Versione dell'API 'Anteprima 2026-08-02'
location 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)
proprietà Proprietà di una finestra di manutenzione. ManutenzioneFinestreProprietàRisorsaT
tags Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
tipo Tipo di risorsa 'Microsoft. ContainerService/maintenanceWindows

AbsoluteMonthlySchedule

Nome Descrizione Valore
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

Nome Descrizione Valore
intervalDays Specifica il numero di giorni tra ogni set di occorrenze. Int

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

DateSpan

Nome Descrizione Valore
fine Data di fine dell'intervallo di date. stringa (obbligatorio)
start Data di inizio dell'intervallo di date. stringa (obbligatorio)

ManutenzioneFinestreProprietàRisorsaT

Nome Descrizione Valore
durataOre 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.
corda
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

Nome Descrizione Valore
dayOfWeek Specifica il giorno della settimana in cui viene eseguita la manutenzione. 'Venerdì'
'Lunedì'
'Sabato'
'Domenica'
'Giovedì'
'Martedì'
'Mercoledì' (obbligatorio)
intervalMonths Specifica il numero di mesi tra ogni set di occorrenze. Int

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

Schedule

Nome Descrizione Valore
absoluteMonthly Per le pianificazioni come: "ricorsiamo ogni mese il 15" o "ricorsiamo ogni 3 mesi il 20". AbsoluteMonthlySchedule
ogni giorno 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

Nome Descrizione Valore

WeeklySchedule

Nome Descrizione Valore
dayOfWeek Specifica il giorno della settimana in cui viene eseguita la manutenzione. 'Venerdì'
'Lunedì'
'Sabato'
'Domenica'
'Giovedì'
'Martedì'
'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 risorsa

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerService/maintenanceWindows@2026-08-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

Nome Descrizione Valore
location 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)
proprietà Proprietà di una finestra di manutenzione. ManutenzioneFinestreProprietàRisorsaT
tags Tag delle risorse Dizionario di nomi e valori di tag.
tipo Tipo di risorsa "Microsoft. ContainerService/maintenanceWindows@2026-08-02-anteprima"

AbsoluteMonthlySchedule

Nome Descrizione Valore
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

Nome Descrizione Valore
intervalDays Specifica il numero di giorni tra ogni set di occorrenze. Int

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

DateSpan

Nome Descrizione Valore
fine Data di fine dell'intervallo di date. stringa (obbligatorio)
start Data di inizio dell'intervallo di date. stringa (obbligatorio)

ManutenzioneFinestreProprietàRisorsaT

Nome Descrizione Valore
durataOre 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.
corda
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

Nome Descrizione Valore
dayOfWeek Specifica il giorno della settimana in cui viene eseguita la manutenzione. 'Venerdì'
'Lunedì'
'Sabato'
'Domenica'
'Giovedì'
'Martedì'
'Mercoledì' (obbligatorio)
intervalMonths Specifica il numero di mesi tra ogni set di occorrenze. Int

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

Schedule

Nome Descrizione Valore
absoluteMonthly Per le pianificazioni come: "ricorsiamo ogni mese il 15" o "ricorsiamo ogni 3 mesi il 20". AbsoluteMonthlySchedule
ogni giorno 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

Nome Descrizione Valore

WeeklySchedule

Nome Descrizione Valore
dayOfWeek Specifica il giorno della settimana in cui viene eseguita la manutenzione. 'Venerdì'
'Lunedì'
'Sabato'
'Domenica'
'Giovedì'
'Martedì'
'Mercoledì' (obbligatorio)
intervalWeeks Specifica il numero di settimane tra ogni set di occorrenze. Int

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