Updates - List Parent

Service:

Maintenance

Version d'API:

2023-09-01-preview

Obtenez des mises à jour des ressources.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
providerName	path	True	string	Nom du fournisseur de ressources
resourceGroupName	path	True	string	Nom du groupe de ressources
resourceName	path	True	string	Identificateur de ressource
resourceParentName	path	True	string	Identificateur parent de ressource
resourceParentType	path	True	string	Type parent de ressource
resourceType	path	True	string	Type de ressource
subscriptionId	path	True	string	Informations d’identification d’abonnement qui identifient de manière unique un abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI de chaque appel de service.
api-version	query	True	string	Version de l’API à utiliser avec la demande cliente.

Réponses

Nom	Type	Description
200 OK	ListUpdatesResult	D’ACCORD
Other Status Codes	MaintenanceError	Requête incorrecte

Exemples

Updates_ListParent

Exemple de requête

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

Exemple de réponse

Code d’état:

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"
      }
    }
  ]
}

Définitions

Nom	Description
ErrorDetails	Détails de la réponse d’erreur reçus du service maintenance Azure.
ImpactType	Type d’impact
ListUpdatesResult	Réponse à la liste des mises à jour
MaintenanceError	Réponse d’erreur reçue du service Maintenance Azure.
MaintenanceScope	Obtient ou définit maintenanceScope de la configuration
Update	Mise à jour de maintenance sur une ressource
UpdateStatus	État

ErrorDetails

Object

Détails de la réponse d’erreur reçus du service maintenance Azure.

Nom	Type	Description
code	string	Code d’erreur défini par le service. Ce code sert de sous-état pour le code d’erreur HTTP spécifié dans la réponse.
message	string	Représentation lisible par l’homme de l’erreur.

ImpactType

Énumération

Type d’impact

Valeur	Description
None	Les mises à jour en attente n’ont aucun impact sur la ressource.
Freeze	Les mises à jour en attente peuvent figer l’opération d’E/S réseau ou disque sur la ressource.
Restart	Les mises à jour en attente peuvent entraîner le redémarrage de la ressource.
Redeploy	Les mises à jour en attente peuvent redéployer la ressource.

ListUpdatesResult

Object

Réponse à la liste des mises à jour

Nom	Type	Description
value	Update[]	Mises à jour en attente

MaintenanceError

Object

Réponse d’erreur reçue du service Maintenance Azure.

Nom	Type	Description
error	ErrorDetails	Détails de l’erreur

MaintenanceScope

Énumération

Obtient ou définit maintenanceScope de la configuration

Valeur	Description
Host	Cette étendue de maintenance contrôle l’installation des mises à jour de plateforme Azure, c’est-à-dire les services sur les nœuds physiques hébergeant des machines virtuelles clientes.
Resource	Cette étendue de maintenance contrôle la maintenance des mises à jour par défaut de la ressource Azure
OSImage	Cette étendue de maintenance contrôle l’installation de l’image du système d’exploitation sur la machine virtuelle/VMSS
Extension	Cette étendue de maintenance contrôle l’installation de l’extension sur la machine virtuelle/VMSS
InGuestPatch	Cette étendue de maintenance contrôle l’installation des packages Windows et Linux sur la machine virtuelle/VMSS
SQLDB	Cette étendue de maintenance contrôle l’installation des mises à jour de la plateforme SQL Server.
SQLManagedInstance	Cette étendue de maintenance contrôle l’installation de la mise à jour de la plateforme SQL Managed Instance.

Update

Object

Mise à jour de maintenance sur une ressource

Nom	Type	Description
impactDurationInSec	integer (int32)	Durée de l’impact en secondes
impactType	ImpactType	Type d’impact
maintenanceScope	MaintenanceScope	Zone d’impact
notBefore	string (date-time)	Heure à laquelle Azure commence à forcer les mises à jour s’il n’est pas mis à jour automatiquement par le client avant cette heure
properties.resourceId	string	ResourceId
status	UpdateStatus	État

UpdateStatus

Énumération

État

Valeur	Description
Pending	Il existe des mises à jour en attente à installer.
InProgress	L’installation des mises à jour est en cours.
Completed	Toutes les mises à jour sont correctement appliquées.
RetryNow	L’installation des mises à jour a échoué, mais elle est prête à réessayer.
RetryLater	L’installation des mises à jour a échoué et doit être retentée ultérieurement.
NoUpdatesPending	Aucune mise à jour n’est en attente.
Cancel	Annulez la planification et arrêtez la création de PMR pour la partie ressources. Applicable au type de ressource Configuration de maintenance uniquement.
Cancelled	Envoyez la réponse annulée à l’utilisateur si la demande est venue annuler la planification. Applicable au type de ressource Configuration de maintenance uniquement.