Public Maintenance Configurations - Get

Servizio:: Maintenance

Versione API:: 2023-09-01-preview

Ottenere il record di configurazione della manutenzione pubblica

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/{resourceName}?api-version=2023-09-01-preview

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceName	path	True	string	Nome configurazione manutenzione
subscriptionId	path	True	string	Credenziali di sottoscrizione che identificano in modo univoco una sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata al servizio.
api-version	query	True	string	Versione dell'API da usare con la richiesta client.

Risposte

Nome	Tipo	Descrizione
200 OK	MaintenanceConfiguration	OK
Other Status Codes	MaintenanceError	BadRequest

Esempio

PublicMaintenanceConfigurations_GetForResource

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/configuration1?api-version=2023-09-01-preview

Risposta di esempio

Codice di stato:: 200

{
  "id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/configuration1",
  "name": "configuration1",
  "location": "westus2",
  "properties": {
    "namespace": "Microsoft.Maintenance",
    "maintenanceScope": "SQLDB",
    "visibility": "Public",
    "maintenanceWindow": {
      "startDateTime": "2020-04-30 08:00",
      "expirationDateTime": "9999-12-31 00:00",
      "duration": "05:00",
      "timeZone": "Pacific Standard Time",
      "recurEvery": "2Weeks"
    }
  }
}

Definizioni

Nome	Descrizione
createdByType	Tipo di identità che ha creato la risorsa.
ErrorDetails	Dettagli della risposta di errore ricevuti dal servizio manutenzione di Azure.
InputLinuxParameters	Proprietà di input per l'applicazione di patch a un computer Linux.
InputPatchConfiguration	Configurazione di input per un'esecuzione di patch
InputWindowsParameters	Proprietà di input per l'applicazione di patch a un computer Windows.
MaintenanceConfiguration	Tipo di record di configurazione della manutenzione
MaintenanceError	Risposta di errore ricevuta dal servizio manutenzione di Azure.
MaintenanceScope	Ottiene o imposta la manutenzioneScope della configurazione
RebootOptions	Possibile preferenza di riavvio definita dall'utente in base alla quale sarebbe stato deciso di riavviare il computer o meno dopo il completamento dell'operazione di patch.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
Visibility	Ottiene o imposta la visibilità della configurazione. Il valore predefinito è 'Custom'

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

ErrorDetails

Object

Dettagli della risposta di errore ricevuti dal servizio manutenzione di Azure.

Nome	Tipo	Descrizione
code	string	Codice di errore definito dal servizio. Questo codice funge da sotto-stato per il codice di errore HTTP specificato nella risposta.
message	string	Rappresentazione leggibile dell'errore.

InputLinuxParameters

Object

Proprietà di input per l'applicazione di patch a un computer Linux.

Nome	Tipo	Descrizione
classificationsToInclude	string[]	Categoria di classificazione delle patch da applicare alle patch. I valori consentiti sono 'Critical', 'Security' e 'Other'.
packageNameMasksToExclude	string[]	Nomi dei pacchetti da escludere per l'applicazione di patch.
packageNameMasksToInclude	string[]	Nomi dei pacchetti da includere per l'applicazione di patch.

InputPatchConfiguration

Object

Configurazione di input per un'esecuzione di patch

Nome	Tipo	Valore predefinito	Descrizione
linuxParameters	InputLinuxParameters		Parametri di input specifici per l'applicazione di patch al computer Linux. Per i computer Windows, non passare questa proprietà.
rebootSetting	RebootOptions	IfRequired	Possibile preferenza di riavvio definita dall'utente in base alla quale sarebbe stato deciso di riavviare il computer o meno dopo il completamento dell'operazione di patch.
windowsParameters	InputWindowsParameters		Parametri di input specifici per l'applicazione di patch a un computer Windows. Per i computer Linux, non passare questa proprietà.

InputWindowsParameters

Object

Proprietà di input per l'applicazione di patch a un computer Windows.

Nome	Tipo	Descrizione
classificationsToInclude	string[]	Categoria di classificazione delle patch da applicare alle patch. I valori consentiti sono 'Critical', 'Security', 'UpdateRollup', 'FeaturePack', 'ServicePack', 'Definition', 'Tools' e 'Updates'.
excludeKbsRequiringReboot	boolean	Escludere le patch che richiedono il riavvio
kbNumbersToExclude	string[]	KBID di Windows da escludere per l'applicazione di patch.
kbNumbersToInclude	string[]	KBID di Windows da includere per l'applicazione di patch.

MaintenanceConfiguration

Object

Tipo di record di configurazione della manutenzione

Nome	Tipo	Descrizione
id	string	Identificatore completo della risorsa
location	string	Ottiene o imposta la posizione della risorsa
name	string	Nome della risorsa
properties.extensionProperties	object	Ottiene o imposta extensionProperties dell'oggetto maintenanceConfiguration
properties.installPatches	InputPatchConfiguration	Parametri di input da passare all'operazione di esecuzione della patch.
properties.maintenanceScope	MaintenanceScope	Ottiene o imposta la manutenzioneScope della configurazione
properties.maintenanceWindow.duration	string	Durata della finestra di manutenzione in formato HH:mm. Se non specificato, il valore predefinito verrà usato in base all'ambito di manutenzione specificato. Esempio: 05:00.
properties.maintenanceWindow.expirationDateTime	string	Data di scadenza effettiva della finestra di manutenzione in formato AAAA-MM-DD hh:mm. La finestra verrà creata nel fuso orario specificato e regolata in base al fuso orario. La data di scadenza deve essere impostata su una data futura. Se non specificato, verrà impostato sul valore datetime massimo 9999-12-31 23:59:59.
properties.maintenanceWindow.recurEvery	string	Frequenza di ripetizione di una finestra di manutenzione. Il tasso può essere espresso come pianificazioni giornaliere, settimanali o mensili. La pianificazione giornaliera viene formattata come ricorsiva: [Frequency as integer]['Day/s)']. Se non viene specificata alcuna frequenza, la frequenza predefinita è 1. Gli esempi di pianificazione giornaliera sono ricorsivi: Day, recurEvery: 3Days. La pianificazione settimanale viene formattata come ricorsiva: [Frequenza come numero intero][Settimana/i][Elenco delimitato da virgole facoltativo dei giorni feriali lunedì-domenica]. Gli esempi di pianificazione settimanale sono ricorsiva: 3Weeks, recurEvery: Week Saturday,Sunday. Le pianificazioni mensili vengono formattate come [Frequency as integer]['Month/s)'] [Elenco delimitato da virgole di giorni mensili] o [Frequency as integer]['Month(s)'] [Week of Month (First, Second, Third, Fourth, Last)] [Weekday Monday-Sunday] [Optional Offset(No. of days)]. Il valore di offset deve essere compreso tra -6 e 6 inclusi. Gli esempi di pianificazione mensile sono recurEvery: Month, recurEvery: 2Months, recurevery: Month day23,day24, recurEvery: Month Last Sunday, recury: Month Fourth Monday, recury: Month Last Sunday Offset-3, recury: Month Third Sunday Offset6.
properties.maintenanceWindow.startDateTime	string	Data di inizio effettiva della finestra di manutenzione in formato AAAA-MM-DD hh:mm. La data di inizio può essere impostata sulla data corrente o sulla data futura. La finestra verrà creata nel fuso orario specificato e regolata in base al fuso orario.
properties.maintenanceWindow.timeZone	string	Nome del fuso orario. È possibile ottenere l'elenco dei fusi orari eseguendo [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell. Esempio: Ora solare pacifico, UTC, Ora solare W. Europa, Ora solare corea, Cen. Ora solare australia.
properties.namespace	string	Ottiene o imposta lo spazio dei nomi della risorsa
properties.visibility	Visibility	Ottiene o imposta la visibilità della configurazione. Il valore predefinito è 'Custom'
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
tags	object	Ottiene o imposta i tag della risorsa
type	string	Tipo di risorsa

MaintenanceError

Object

Risposta di errore ricevuta dal servizio manutenzione di Azure.

Nome	Tipo	Descrizione
error	ErrorDetails	Dettagli dell'errore

MaintenanceScope

Enumerazione

Ottiene o imposta la manutenzioneScope della configurazione

Valore	Descrizione
Host	Questo ambito di manutenzione controlla l'installazione degli aggiornamenti della piattaforma Azure, ad esempio i servizi nei nodi fisici che ospitano macchine virtuali dei clienti.
Resource	Questo ambito di manutenzione controlla la manutenzione degli aggiornamenti predefinita della risorsa di Azure
OSImage	Questo ambito di manutenzione controlla l'installazione dell'immagine del sistema operativo in macchine virtuali/set di scalabilità di macchine virtuali
Extension	Questo ambito di manutenzione controlla l'installazione dell'estensione in macchine virtuali/set di scalabilità di macchine virtuali
InGuestPatch	Questo ambito di manutenzione controlla l'installazione di pacchetti Windows e Linux in macchine virtuali/set di scalabilità di macchine virtuali
SQLDB	Questo ambito di manutenzione controlla l'installazione degli aggiornamenti della piattaforma SQL Server.
SQLManagedInstance	Questo ambito di manutenzione controlla l'installazione dell'aggiornamento della piattaforma dell'istanza gestita di SQL.

RebootOptions

Enumerazione

Possibile preferenza di riavvio definita dall'utente in base alla quale sarebbe stato deciso di riavviare il computer o meno dopo il completamento dell'operazione di patch.

Valore	Descrizione
IfRequired
Never
Always

systemData

Object

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

Visibility

Enumerazione

Ottiene o imposta la visibilità della configurazione. Il valore predefinito è 'Custom'

Valore	Descrizione
Custom	Visibili solo agli utenti con autorizzazioni.
Public	Visibile a tutti gli utenti.

Condividi tramite

Public Maintenance Configurations - Get

Parametri dell'URI

Risposte

Esempio

PublicMaintenanceConfigurations_GetForResource

Esempio di richiesta

Risposta di esempio

Definizioni

createdByType

ErrorDetails

InputLinuxParameters

InputPatchConfiguration

InputWindowsParameters

MaintenanceConfiguration

MaintenanceError

MaintenanceScope

RebootOptions

systemData

Visibility