Microsoft.Maintenance MaintenanceConfigurations 2023-09-01-preview
Definicja zasobu Bicep
Typ zasobu maintenanceConfigurations można wdrożyć przy użyciu operacji docelowych:
- grupy zasobów — zobacz polecenia wdrażania grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.Maintenance/maintenanceConfigurations, dodaj następujący kod Bicep do szablonu.
resource symbolicname 'Microsoft.Maintenance/maintenanceConfigurations@2023-09-01-preview' = {
location: 'string'
name: 'string'
properties: {
extensionProperties: {
{customized property}: 'string'
}
installPatches: {
linuxParameters: {
classificationsToInclude: [
'string'
]
packageNameMasksToExclude: [
'string'
]
packageNameMasksToInclude: [
'string'
]
}
rebootSetting: 'string'
windowsParameters: {
classificationsToInclude: [
'string'
]
excludeKbsRequiringReboot: bool
kbNumbersToExclude: [
'string'
]
kbNumbersToInclude: [
'string'
]
}
}
maintenanceScope: 'string'
maintenanceWindow: {
duration: 'string'
expirationDateTime: 'string'
recurEvery: 'string'
startDateTime: 'string'
timeZone: 'string'
}
namespace: 'string'
visibility: 'string'
}
tags: {
{customized property}: 'string'
}
}
Wartości właściwości
InputLinuxParameters
Nazwa | Opis | Wartość |
---|---|---|
classificationsToInclude | Kategoria klasyfikacji poprawek do stosowania poprawek | string[] |
packageNameMasksToExclude | Nazwy pakietów, które mają być wykluczone do stosowania poprawek. | string[] |
packageNameMasksToInclude | Nazwy pakietów do stosowania poprawek. | string[] |
InputPatchConfiguration
Nazwa | Opis | Wartość |
---|---|---|
linuxParameters | Parametry wejściowe specyficzne dla poprawiania maszyny z systemem Linux. W przypadku maszyn z systemem Windows nie przekazuj tej właściwości. | InputLinuxParameters |
rebootSetting | Możliwe preferencje ponownego rozruchu zdefiniowane przez użytkownika w oparciu o to, na podstawie którego podjęto decyzję o ponownym uruchomieniu maszyny lub nie po zakończeniu operacji poprawki. | "Zawsze" "IfRequired" "Nigdy" |
windowsParameters | Parametry wejściowe specyficzne dla stosowania poprawek maszyny z systemem Windows. W przypadku maszyn z systemem Linux nie przekazuj tej właściwości. | InputWindowsParameters |
InputWindowsParameters
Nazwa | Opis | Wartość |
---|---|---|
classificationsToInclude | Kategoria klasyfikacji poprawek do stosowania poprawek | string[] |
excludeKbsRequiringReboot | Wykluczanie poprawek, które wymagają ponownego uruchomienia | Bool |
kbNumbersToExclude | Identyfikator KBID systemu Windows, który ma zostać wykluczony do stosowania poprawek. | string[] |
kbNumbersToInclude | Identyfikator KBID systemu Windows do stosowania poprawek. | string[] |
MaintenanceConfigurationProperties
Nazwa | Opis | Wartość |
---|---|---|
extensionProperties | Pobiera lub ustawia rozszerzenieWłaściwości konserwacjiKonfiguracja | MaintenanceConfigurationPropertiesExtensionProperties |
installPatches | Parametry wejściowe, które mają zostać przekazane do operacji uruchamiania poprawek. | InputPatchConfiguration |
maintenanceScope | Pobiera lub ustawia konserwacjęZakres konfiguracji | "Rozszerzenie" "Host" "InGuestPatch" "OSImage" "Zasób" "SQLDB" "SQLManagedInstance" |
konserwacjaWindow | Definicja elementu MaintenanceWindow | konserwacja Window |
Namespace | Pobiera lub ustawia przestrzeń nazw zasobu | struna |
widoczność | Pobiera lub ustawia widoczność konfiguracji. Wartość domyślna to "Niestandardowy" | "Niestandardowy" "Publiczny" |
MaintenanceConfigurationPropertiesExtensionProperties
Nazwa | Opis | Wartość |
---|
MaintenanceConfigurationTags
Nazwa | Opis | Wartość |
---|
KonserwacjaWindow
Nazwa | Opis | Wartość |
---|---|---|
czas trwania | Czas trwania okna obsługi w formacie HH:mm. Jeśli nie zostanie podana, wartość domyślna będzie używana na podstawie podanego zakresu konserwacji. Przykład: 05:00. | struna |
expirationDateTime | Obowiązująca data wygaśnięcia okna obsługi w formacie RRRR-MM-DD hh:mm. Okno zostanie utworzone w podanej strefie czasowej i dostosowane do oszczędności światła dziennego zgodnie z tym strefą czasową. Data wygaśnięcia musi być ustawiona na datę przyszłej. Jeśli nie zostanie podana, zostanie ustawiona maksymalna data/godzina 9999-12-31 23:59:59. | struna |
recurEvery | Szybkość, z jaką okno obsługi ma się powtarzać. Stawka może być wyrażona jako harmonogramy dzienne, tygodniowe lub miesięczne. Harmonogram dzienny jest sformatowany jako recurEvery: [Frequency as integer]['Day(s)']. Jeśli nie podano żadnej częstotliwości, domyślna częstotliwość to 1. Przykłady harmonogramu codziennego są recurEvery: Day, recurEvery: 3Days. Harmonogram tygodniowy jest sformatowany jako recurEvery: [Frequency as integer]['Week(s)'] [Opcjonalna lista rozdzielana przecinkami dni powszednie poniedziałek-niedziela]. Przykłady harmonogramu tygodniowego to recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday. Harmonogramy miesięczne są formatowane jako [Częstotliwość jako liczba całkowita]['Month(s)'] [Rozdzielana przecinkami lista dni miesiąca] lub [Frequency as integer]['Month(s)'] [Week of Month(s)] [Week of Month(First, Second, Third, Fourth, Last)] [Weekday Monday-Sunday] [Optional Offset(No. of days)]. Wartość przesunięcia musi należeć między -6 a 6 włącznie. Przykłady harmonogramu miesięcznego to recurEvery: Month, recurEvery: 2Months, recurEvery: Month day23,day24, recurEvery: Month Last Sunday, recurEvery: Month Fourth Monday, recurEvery: Month Last Sunday Offset-3, recurEvery: Month Third Sunday Offset6. | struna |
startDateTime | Data rozpoczęcia okna obsługi w formacie RRRR-MM-DD hh:mm. Datę rozpoczęcia można ustawić na bieżącą datę lub datę przyszłą. Okno zostanie utworzone w podanej strefie czasowej i dostosowane do oszczędności światła dziennego zgodnie z tym strefą czasową. | struna |
strefa czasowa | Nazwa strefy czasowej. Listę stref czasowych można uzyskać, wykonując polecenie [System.TimeZoneInfo]::GetSystemTimeZones() w programie PowerShell. Przykład: Pacyfik (czas standardowy), UTC, Europa (czas standardowy), Korea (czas standardowy), Cen (Cen). Australia (czas standardowy). | struna |
Microsoft.Maintenance/maintenanceConfigurations
Nazwa | Opis | Wartość |
---|---|---|
lokalizacja | Pobiera lub ustawia lokalizację zasobu | struna |
nazwa | Nazwa zasobu | ciąg (wymagany) |
Właściwości | Pobiera lub ustawia właściwości zasobu | MaintenanceConfigurationProperties |
Tagi | Tagi zasobów | Słownik nazw tagów i wartości. Zobacz tagi w szablonach |
Definicja zasobu szablonu usługi ARM
Typ zasobu maintenanceConfigurations można wdrożyć przy użyciu operacji docelowych:
- grupy zasobów — zobacz polecenia wdrażania grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.Maintenance/maintenanceConfigurations, dodaj następujący kod JSON do szablonu.
{
"type": "Microsoft.Maintenance/maintenanceConfigurations",
"apiVersion": "2023-09-01-preview",
"name": "string",
"location": "string",
"properties": {
"extensionProperties": {
"{customized property}": "string"
},
"installPatches": {
"linuxParameters": {
"classificationsToInclude": [ "string" ],
"packageNameMasksToExclude": [ "string" ],
"packageNameMasksToInclude": [ "string" ]
},
"rebootSetting": "string",
"windowsParameters": {
"classificationsToInclude": [ "string" ],
"excludeKbsRequiringReboot": "bool",
"kbNumbersToExclude": [ "string" ],
"kbNumbersToInclude": [ "string" ]
}
},
"maintenanceScope": "string",
"maintenanceWindow": {
"duration": "string",
"expirationDateTime": "string",
"recurEvery": "string",
"startDateTime": "string",
"timeZone": "string"
},
"namespace": "string",
"visibility": "string"
},
"tags": {
"{customized property}": "string"
}
}
Wartości właściwości
InputLinuxParameters
Nazwa | Opis | Wartość |
---|---|---|
classificationsToInclude | Kategoria klasyfikacji poprawek do stosowania poprawek | string[] |
packageNameMasksToExclude | Nazwy pakietów, które mają być wykluczone do stosowania poprawek. | string[] |
packageNameMasksToInclude | Nazwy pakietów do stosowania poprawek. | string[] |
InputPatchConfiguration
Nazwa | Opis | Wartość |
---|---|---|
linuxParameters | Parametry wejściowe specyficzne dla poprawiania maszyny z systemem Linux. W przypadku maszyn z systemem Windows nie przekazuj tej właściwości. | InputLinuxParameters |
rebootSetting | Możliwe preferencje ponownego rozruchu zdefiniowane przez użytkownika w oparciu o to, na podstawie którego podjęto decyzję o ponownym uruchomieniu maszyny lub nie po zakończeniu operacji poprawki. | "Zawsze" "IfRequired" "Nigdy" |
windowsParameters | Parametry wejściowe specyficzne dla stosowania poprawek maszyny z systemem Windows. W przypadku maszyn z systemem Linux nie przekazuj tej właściwości. | InputWindowsParameters |
InputWindowsParameters
Nazwa | Opis | Wartość |
---|---|---|
classificationsToInclude | Kategoria klasyfikacji poprawek do stosowania poprawek | string[] |
excludeKbsRequiringReboot | Wykluczanie poprawek, które wymagają ponownego uruchomienia | Bool |
kbNumbersToExclude | Identyfikator KBID systemu Windows, który ma zostać wykluczony do stosowania poprawek. | string[] |
kbNumbersToInclude | Identyfikator KBID systemu Windows do stosowania poprawek. | string[] |
MaintenanceConfigurationProperties
Nazwa | Opis | Wartość |
---|---|---|
extensionProperties | Pobiera lub ustawia rozszerzenieWłaściwości konserwacjiKonfiguracja | MaintenanceConfigurationPropertiesExtensionProperties |
installPatches | Parametry wejściowe, które mają zostać przekazane do operacji uruchamiania poprawek. | InputPatchConfiguration |
maintenanceScope | Pobiera lub ustawia konserwacjęZakres konfiguracji | "Rozszerzenie" "Host" "InGuestPatch" "OSImage" "Zasób" "SQLDB" "SQLManagedInstance" |
konserwacjaWindow | Definicja elementu MaintenanceWindow | konserwacja Window |
Namespace | Pobiera lub ustawia przestrzeń nazw zasobu | struna |
widoczność | Pobiera lub ustawia widoczność konfiguracji. Wartość domyślna to "Niestandardowy" | "Niestandardowy" "Publiczny" |
MaintenanceConfigurationPropertiesExtensionProperties
Nazwa | Opis | Wartość |
---|
MaintenanceConfigurationTags
Nazwa | Opis | Wartość |
---|
KonserwacjaWindow
Nazwa | Opis | Wartość |
---|---|---|
czas trwania | Czas trwania okna obsługi w formacie HH:mm. Jeśli nie zostanie podana, wartość domyślna będzie używana na podstawie podanego zakresu konserwacji. Przykład: 05:00. | struna |
expirationDateTime | Obowiązująca data wygaśnięcia okna obsługi w formacie RRRR-MM-DD hh:mm. Okno zostanie utworzone w podanej strefie czasowej i dostosowane do oszczędności światła dziennego zgodnie z tym strefą czasową. Data wygaśnięcia musi być ustawiona na datę przyszłej. Jeśli nie zostanie podana, zostanie ustawiona maksymalna data/godzina 9999-12-31 23:59:59. | struna |
recurEvery | Szybkość, z jaką okno obsługi ma się powtarzać. Stawka może być wyrażona jako harmonogramy dzienne, tygodniowe lub miesięczne. Harmonogram dzienny jest sformatowany jako recurEvery: [Frequency as integer]['Day(s)']. Jeśli nie podano żadnej częstotliwości, domyślna częstotliwość to 1. Przykłady harmonogramu codziennego są recurEvery: Day, recurEvery: 3Days. Harmonogram tygodniowy jest sformatowany jako recurEvery: [Frequency as integer]['Week(s)'] [Opcjonalna lista rozdzielana przecinkami dni powszednie poniedziałek-niedziela]. Przykłady harmonogramu tygodniowego to recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday. Harmonogramy miesięczne są formatowane jako [Częstotliwość jako liczba całkowita]['Month(s)'] [Rozdzielana przecinkami lista dni miesiąca] lub [Frequency as integer]['Month(s)'] [Week of Month(s)] [Week of Month(First, Second, Third, Fourth, Last)] [Weekday Monday-Sunday] [Optional Offset(No. of days)]. Wartość przesunięcia musi należeć między -6 a 6 włącznie. Przykłady harmonogramu miesięcznego to recurEvery: Month, recurEvery: 2Months, recurEvery: Month day23,day24, recurEvery: Month Last Sunday, recurEvery: Month Fourth Monday, recurEvery: Month Last Sunday Offset-3, recurEvery: Month Third Sunday Offset6. | struna |
startDateTime | Data rozpoczęcia okna obsługi w formacie RRRR-MM-DD hh:mm. Datę rozpoczęcia można ustawić na bieżącą datę lub datę przyszłą. Okno zostanie utworzone w podanej strefie czasowej i dostosowane do oszczędności światła dziennego zgodnie z tym strefą czasową. | struna |
strefa czasowa | Nazwa strefy czasowej. Listę stref czasowych można uzyskać, wykonując polecenie [System.TimeZoneInfo]::GetSystemTimeZones() w programie PowerShell. Przykład: Pacyfik (czas standardowy), UTC, Europa (czas standardowy), Korea (czas standardowy), Cen (Cen). Australia (czas standardowy). | struna |
Microsoft.Maintenance/maintenanceConfigurations
Nazwa | Opis | Wartość |
---|---|---|
apiVersion | Wersja interfejsu API | "2023-09-01-preview" |
lokalizacja | Pobiera lub ustawia lokalizację zasobu | struna |
nazwa | Nazwa zasobu | ciąg (wymagany) |
Właściwości | Pobiera lub ustawia właściwości zasobu | MaintenanceConfigurationProperties |
Tagi | Tagi zasobów | Słownik nazw tagów i wartości. Zobacz tagi w szablonach |
typ | Typ zasobu | "Microsoft.Maintenance/maintenanceConfigurations" |
Definicja zasobu narzędzia Terraform (dostawcy AzAPI)
Typ zasobu maintenanceConfigurations można wdrożyć przy użyciu operacji docelowych:
- grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.Maintenance/maintenanceConfigurations, dodaj następujący program Terraform do szablonu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Maintenance/maintenanceConfigurations@2023-09-01-preview"
name = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
extensionProperties = {
{customized property} = "string"
}
installPatches = {
linuxParameters = {
classificationsToInclude = [
"string"
]
packageNameMasksToExclude = [
"string"
]
packageNameMasksToInclude = [
"string"
]
}
rebootSetting = "string"
windowsParameters = {
classificationsToInclude = [
"string"
]
excludeKbsRequiringReboot = bool
kbNumbersToExclude = [
"string"
]
kbNumbersToInclude = [
"string"
]
}
}
maintenanceScope = "string"
maintenanceWindow = {
duration = "string"
expirationDateTime = "string"
recurEvery = "string"
startDateTime = "string"
timeZone = "string"
}
namespace = "string"
visibility = "string"
}
})
}
Wartości właściwości
InputLinuxParameters
Nazwa | Opis | Wartość |
---|---|---|
classificationsToInclude | Kategoria klasyfikacji poprawek do stosowania poprawek | string[] |
packageNameMasksToExclude | Nazwy pakietów, które mają być wykluczone do stosowania poprawek. | string[] |
packageNameMasksToInclude | Nazwy pakietów do stosowania poprawek. | string[] |
InputPatchConfiguration
Nazwa | Opis | Wartość |
---|---|---|
linuxParameters | Parametry wejściowe specyficzne dla poprawiania maszyny z systemem Linux. W przypadku maszyn z systemem Windows nie przekazuj tej właściwości. | InputLinuxParameters |
rebootSetting | Możliwe preferencje ponownego rozruchu zdefiniowane przez użytkownika w oparciu o to, na podstawie którego podjęto decyzję o ponownym uruchomieniu maszyny lub nie po zakończeniu operacji poprawki. | "Zawsze" "IfRequired" "Nigdy" |
windowsParameters | Parametry wejściowe specyficzne dla stosowania poprawek maszyny z systemem Windows. W przypadku maszyn z systemem Linux nie przekazuj tej właściwości. | InputWindowsParameters |
InputWindowsParameters
Nazwa | Opis | Wartość |
---|---|---|
classificationsToInclude | Kategoria klasyfikacji poprawek do stosowania poprawek | string[] |
excludeKbsRequiringReboot | Wykluczanie poprawek, które wymagają ponownego uruchomienia | Bool |
kbNumbersToExclude | Identyfikator KBID systemu Windows, który ma zostać wykluczony do stosowania poprawek. | string[] |
kbNumbersToInclude | Identyfikator KBID systemu Windows do stosowania poprawek. | string[] |
MaintenanceConfigurationProperties
Nazwa | Opis | Wartość |
---|---|---|
extensionProperties | Pobiera lub ustawia rozszerzenieWłaściwości konserwacjiKonfiguracja | MaintenanceConfigurationPropertiesExtensionProperties |
installPatches | Parametry wejściowe, które mają zostać przekazane do operacji uruchamiania poprawek. | InputPatchConfiguration |
maintenanceScope | Pobiera lub ustawia konserwacjęZakres konfiguracji | "Rozszerzenie" "Host" "InGuestPatch" "OSImage" "Zasób" "SQLDB" "SQLManagedInstance" |
konserwacjaWindow | Definicja elementu MaintenanceWindow | konserwacja Window |
Namespace | Pobiera lub ustawia przestrzeń nazw zasobu | struna |
widoczność | Pobiera lub ustawia widoczność konfiguracji. Wartość domyślna to "Niestandardowy" | "Niestandardowy" "Publiczny" |
MaintenanceConfigurationPropertiesExtensionProperties
Nazwa | Opis | Wartość |
---|
MaintenanceConfigurationTags
Nazwa | Opis | Wartość |
---|
KonserwacjaWindow
Nazwa | Opis | Wartość |
---|---|---|
czas trwania | Czas trwania okna obsługi w formacie HH:mm. Jeśli nie zostanie podana, wartość domyślna będzie używana na podstawie podanego zakresu konserwacji. Przykład: 05:00. | struna |
expirationDateTime | Obowiązująca data wygaśnięcia okna obsługi w formacie RRRR-MM-DD hh:mm. Okno zostanie utworzone w podanej strefie czasowej i dostosowane do oszczędności światła dziennego zgodnie z tym strefą czasową. Data wygaśnięcia musi być ustawiona na datę przyszłej. Jeśli nie zostanie podana, zostanie ustawiona maksymalna data/godzina 9999-12-31 23:59:59. | struna |
recurEvery | Szybkość, z jaką okno obsługi ma się powtarzać. Stawka może być wyrażona jako harmonogramy dzienne, tygodniowe lub miesięczne. Harmonogram dzienny jest sformatowany jako recurEvery: [Frequency as integer]['Day(s)']. Jeśli nie podano żadnej częstotliwości, domyślna częstotliwość to 1. Przykłady harmonogramu codziennego są recurEvery: Day, recurEvery: 3Days. Harmonogram tygodniowy jest sformatowany jako recurEvery: [Frequency as integer]['Week(s)'] [Opcjonalna lista rozdzielana przecinkami dni powszednie poniedziałek-niedziela]. Przykłady harmonogramu tygodniowego to recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday. Harmonogramy miesięczne są formatowane jako [Częstotliwość jako liczba całkowita]['Month(s)'] [Rozdzielana przecinkami lista dni miesiąca] lub [Frequency as integer]['Month(s)'] [Week of Month(s)] [Week of Month(First, Second, Third, Fourth, Last)] [Weekday Monday-Sunday] [Optional Offset(No. of days)]. Wartość przesunięcia musi należeć między -6 a 6 włącznie. Przykłady harmonogramu miesięcznego to recurEvery: Month, recurEvery: 2Months, recurEvery: Month day23,day24, recurEvery: Month Last Sunday, recurEvery: Month Fourth Monday, recurEvery: Month Last Sunday Offset-3, recurEvery: Month Third Sunday Offset6. | struna |
startDateTime | Data rozpoczęcia okna obsługi w formacie RRRR-MM-DD hh:mm. Datę rozpoczęcia można ustawić na bieżącą datę lub datę przyszłą. Okno zostanie utworzone w podanej strefie czasowej i dostosowane do oszczędności światła dziennego zgodnie z tym strefą czasową. | struna |
strefa czasowa | Nazwa strefy czasowej. Listę stref czasowych można uzyskać, wykonując polecenie [System.TimeZoneInfo]::GetSystemTimeZones() w programie PowerShell. Przykład: Pacyfik (czas standardowy), UTC, Europa (czas standardowy), Korea (czas standardowy), Cen (Cen). Australia (czas standardowy). | struna |
Microsoft.Maintenance/maintenanceConfigurations
Nazwa | Opis | Wartość |
---|---|---|
lokalizacja | Pobiera lub ustawia lokalizację zasobu | struna |
nazwa | Nazwa zasobu | ciąg (wymagany) |
Właściwości | Pobiera lub ustawia właściwości zasobu | MaintenanceConfigurationProperties |
Tagi | Tagi zasobów | Słownik nazw tagów i wartości. |
typ | Typ zasobu | "Microsoft.Maintenance/maintenanceConfigurations@2023-09-01-preview" |