Apply Updates - Create Or Update Or Cancel

Service:
Maintenance
Version d'API:
2023-09-01-preview

Appliquer des mises à jour à la ressource
Appliquer des mises à jour de maintenance à la ressource

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

Paramètres URI

Nom Dans Obligatoire Type Description
applyUpdateName
 path True

string

Nom ApplyUpdate
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
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.

Corps de la demande

Nom Type Description
properties.lastUpdateTime

string (date-time)

Heure de la dernière mise à jour
properties.resourceId

string

ResourceId
properties.status

UpdateStatus

État

Réponses

Nom Type Description
200 OK

ApplyUpdate

Demande de mise à jour ApplyUpdate acceptée
201 Created

ApplyUpdate

Demande de création ApplyUpdate acceptée
Other Status Codes

MaintenanceError

Requête incorrecte

Exemples

ApplyUpdates_CreateOrUpdateOnly_NoCancellation
ApplyUpdates_CreateOrUpdateOrCancel

ApplyUpdates_CreateOrUpdateOnly_NoCancellation

Exemple de requête

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

{}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/Microsoft.Compute/virtualMachineScaleSets/smdtest1/providers/Microsoft.Maintenance/applyUpdates/e9b9685d-78e4-44c4-a81c-64a14f9b87b6",
  "name": "e9b9685d-78e4-44c4-a81c-64a14f9b87b6",
  "type": "Microsoft.Maintenance/applyUpdates",
  "properties": {
    "resourceId": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/Microsoft.Compute/virtualMachineScaleSets/smdtest1",
    "status": "Pending"
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/Microsoft.Compute/virtualMachineScaleSets/smdtest1/providers/Microsoft.Maintenance/applyUpdates/e9b9685d-78e4-44c4-a81c-64a14f9b87b6",
  "name": "e9b9685d-78e4-44c4-a81c-64a14f9b87b6",
  "type": "Microsoft.Maintenance/applyUpdates",
  "properties": {
    "resourceId": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/Microsoft.Compute/virtualMachineScaleSets/smdtest1",
    "status": "Pending"
  }
}

ApplyUpdates_CreateOrUpdateOrCancel

Exemple de requête

PUT https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/Microsoft.Maintenance/maintenanceConfigurations/maintenanceConfig1/providers/Microsoft.Maintenance/applyUpdates/20230901121200?api-version=2023-09-01-preview

{
  "properties": {
    "status": "Cancel"
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/microsoft.maintenance/maintenanceconfigurations/maintenanceconfig1/providers/microsoft.maintenance/applyupdates/20230901121200",
  "name": "maintenanceConfig1",
  "type": "Microsoft.Maintenance/applyUpdates",
  "properties": {
    "status": "Cancelled",
    "resourceId": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/microsoft.maintenance/maintenanceconfigurations/maintenanceconfig1"
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/microsoft.maintenance/maintenanceconfigurations/maintenanceconfig1/providers/microsoft.maintenance/applyupdates/20230901121200",
  "name": "maintenanceConfig1",
  "type": "Microsoft.Maintenance/applyUpdates",
  "properties": {
    "status": "Cancelled",
    "resourceId": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/microsoft.maintenance/maintenanceconfigurations/maintenanceconfig1"
  }
}

Définitions

Nom Description
ApplyUpdate

Appliquer la demande de mise à jour
createdByType

Type d’identité qui a créé la ressource.
ErrorDetails

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

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

Métadonnées relatives à la création et à la dernière modification de la ressource.
UpdateStatus

État

ApplyUpdate

Object

Appliquer la demande de mise à jour

Nom Type Description
id

string

Identificateur complet de la ressource
name

string

Nom de la ressource
properties.lastUpdateTime

string (date-time)

Heure de la dernière mise à jour
properties.resourceId

string

ResourceId
properties.status

UpdateStatus

État
systemData

systemData

Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
type

string

Type de la ressource

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur Description
User
Application
ManagedIdentity
Key

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.

MaintenanceError

Object

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

Nom Type Description
error

ErrorDetails

Détails de l’erreur

systemData

Object

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom Type Description
createdAt

string (date-time)

Horodatage de la création de ressources (UTC).
createdBy

string

Identité qui a créé la ressource.
createdByType

createdByType

Type d’identité qui a créé la ressource.
lastModifiedAt

string (date-time)

Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy

string

Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType

createdByType

Type d’identité qui a modifié la ressource pour la dernière fois.

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.