Apply Updates - Create Or Update Or Cancel

Service:: Maintenance

API-versie:: 2023-09-01-preview

Updates toepassen op resource
Onderhoudsupdates toepassen op resources

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

URI-parameters

Name	In	Vereist	Type	Description
applyUpdateName	path	True	string	ApplyUpdate-naam
providerName	path	True	string	Naam van resourceprovider
resourceGroupName	path	True	string	Naam van resourcegroep
resourceName	path	True	string	Resource-id
resourceType	path	True	string	Type hulpbron
subscriptionId	path	True	string	Abonnementsreferenties waarmee een Microsoft Azure-abonnement uniek wordt geïdentificeerd. De abonnements-id maakt deel uit van de URI voor elke serviceoproep.
api-version	query	True	string	Versie van de API die moet worden gebruikt met de clientaanvraag.

Aanvraagbody

Name	Type	Description
properties.lastUpdateTime	string (date-time)	Tijd van laatste update
properties.resourceId	string	De resourceId
properties.status	UpdateStatus	De status

Antwoorden

Name	Type	Description
200 OK	ApplyUpdate	Aanvraag voor update van ApplyUpdate geaccepteerd
201 Created	ApplyUpdate	Aanvraag voor Maken van ApplyUpdate geaccepteerd
Other Status Codes	MaintenanceError	Onjuiste aanvraag

Voorbeelden

ApplyUpdates_CreateOrUpdateOnly_NoCancellation

ApplyUpdates_CreateOrUpdateOrCancel

ApplyUpdates_CreateOrUpdateOnly_NoCancellation

Voorbeeldaanvraag

HTTP

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

{}

Voorbeeldrespons

Statuscode:: 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"
  }
}

Statuscode:: 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

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:: 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"
  }
}

Statuscode:: 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"
  }
}

Definities

Name	Description
ApplyUpdate	Updateaanvraag toepassen
createdByType	Het type identiteit waarmee de resource is gemaakt.
ErrorDetails	Details van een foutantwoord die zijn ontvangen van de Azure Maintenance-service.
MaintenanceError	Er is een foutbericht ontvangen van de Azure Maintenance-service.
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
UpdateStatus	De status

ApplyUpdate

Object

Updateaanvraag toepassen

Name	Type	Description
id	string	Volledig gekwalificeerde id van de resource
name	string	Naam van de resource
properties.lastUpdateTime	string (date-time)	Tijd van laatste update
properties.resourceId	string	De resourceId
properties.status	UpdateStatus	De status
systemData	systemData	Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.
type	string	Type resource

createdByType

Inventarisatie

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
User
Application
ManagedIdentity
Key

ErrorDetails

Object

Details van een foutantwoord die zijn ontvangen van de Azure Maintenance-service.

Name	Type	Description
code	string	Door de service gedefinieerde foutcode. Deze code fungeert als een substatus voor de HTTP-foutcode die is opgegeven in het antwoord.
message	string	Leesbare weergave van de fout.

MaintenanceError

Object

Er is een foutbericht ontvangen van de Azure Maintenance-service.

Name	Type	Description
error	ErrorDetails	Details van de fout

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.

UpdateStatus

Inventarisatie

De status

Waarde	Description
Pending	Er zijn updates die in behandeling zijn om te worden geïnstalleerd.
InProgress	De installatie van updates wordt uitgevoerd.
Completed	Alle updates worden toegepast.
RetryNow	De installatie van updates is mislukt, maar kan het opnieuw proberen.
RetryLater	De installatie van updates is mislukt en moet later opnieuw worden geprobeerd.
NoUpdatesPending	Er zijn geen updates in behandeling.
Cancel	Annuleer het schema en stop met het maken van PMR voor resources. Alleen van toepassing op het resourcetype Onderhoudsconfiguratie.
Cancelled	Verzend het geannuleerde antwoord naar de gebruiker als de aanvraag is ontvangen om het schema te annuleren. Alleen van toepassing op het resourcetype Onderhoudsconfiguratie.