Updates - List Parent

Servizio:: Maintenance

Versione API:: 2023-09-01-preview

Ottenere gli aggiornamenti alle risorse.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{providerName}/{resourceParentType}/{resourceParentName}/{resourceType}/{resourceName}/providers/Microsoft.Maintenance/updates?api-version=2023-09-01-preview

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
providerName	path	True	string	Nome provider di risorse
resourceGroupName	path	True	string	Nome gruppo di risorse
resourceName	path	True	string	Identificatore della risorsa
resourceParentName	path	True	string	Identificatore padre della risorsa
resourceParentType	path	True	string	Tipo padre risorsa
resourceType	path	True	string	Tipo di risorsa
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	ListUpdatesResult	Va bene
Other Status Codes	MaintenanceError	Richiesta non valida

Esempio

Updates_ListParent

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/Microsoft.Compute/virtualMachineScaleSets/smdtest1/virtualMachines/1/providers/Microsoft.Maintenance/updates?api-version=2023-09-01-preview

Risposta di esempio

Codice di stato:: 200

{
  "value": [
    {
      "maintenanceScope": "Resource",
      "status": "Pending",
      "impactType": "Reboot",
      "impactDurationInSec": 1440,
      "notBefore": "2018-10-09T06:17:44.235Z",
      "properties": {
        "resourceId": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/Microsoft.Compute/virtualMachineScaleSets/smdtest1/virtualMachines/1"
      }
    }
  ]
}

Definizioni

Nome	Descrizione
ErrorDetails	Dettagli della risposta di errore ricevuti dal servizio manutenzione di Azure.
ImpactType	Tipo di impatto
ListUpdatesResult	Risposta per l'elenco aggiornamenti
MaintenanceError	Risposta di errore ricevuta dal servizio manutenzione di Azure.
MaintenanceScope	Ottiene o imposta la manutenzioneScope della configurazione
Update	Aggiornamento della manutenzione in una risorsa
UpdateStatus	Stato

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.

ImpactType

Enumerazione

Tipo di impatto

Valore	Descrizione
None	Gli aggiornamenti in sospeso non hanno alcun impatto sulla risorsa.
Freeze	Gli aggiornamenti in sospeso possono bloccare l'operazione i/o di rete su disco nella risorsa.
Restart	Gli aggiornamenti in sospeso possono causare il riavvio della risorsa.
Redeploy	Gli aggiornamenti in sospeso possono ridistribuire la risorsa.

ListUpdatesResult

Object

Risposta per l'elenco aggiornamenti

Nome	Tipo	Descrizione
value	Update[]	Aggiornamenti in sospeso

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.

Update

Object

Aggiornamento della manutenzione in una risorsa

Nome	Tipo	Descrizione
impactDurationInSec	integer (int32)	Durata dell'impatto in secondi
impactType	ImpactType	Tipo di impatto
maintenanceScope	MaintenanceScope	Area di impatto
notBefore	string (date-time)	Ora in cui Azure inizierà a forzare gli aggiornamenti se non viene aggiornato automaticamente dal cliente prima di questa volta
properties.resourceId	string	ResourceId
status	UpdateStatus	Stato

UpdateStatus

Enumerazione

Stato

Valore	Descrizione
Pending	Sono disponibili aggiornamenti in sospeso da installare.
InProgress	L'installazione degli aggiornamenti è in corso.
Completed	Tutti gli aggiornamenti vengono applicati correttamente.
RetryNow	L'installazione degli aggiornamenti non è riuscita ma è possibile riprovare.
RetryLater	L'installazione degli aggiornamenti non è riuscita e dovrebbe essere ritentata in un secondo momento.
NoUpdatesPending	Nessun aggiornamento in sospeso.
Cancel	Annullare la pianificazione e arrestare la creazione di PMR per le risorse che ne fanno parte. Applicabile solo al tipo di risorsa Configurazione manutenzione.
Cancelled	Inviare la risposta annullata all'utente se la richiesta è arrivata per annullare la pianificazione. Applicabile solo al tipo di risorsa Configurazione manutenzione.