Apply Updates - Create Or Update Or Cancel

Tjänst:: Maintenance

API-version:: 2023-09-01-preview

Tillämpa uppdateringar på resurs
Tillämpa underhållsuppdateringar på resursen

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-parametrar

Name	I	Obligatorisk	Typ	Description
applyUpdateName	path	True	string	ApplyUpdate-namn
providerName	path	True	string	Namn på resursprovider
resourceGroupName	path	True	string	Namn på resursgrupp
resourceName	path	True	string	Resursidentifierare
resourceType	path	True	string	Resurstyp
subscriptionId	path	True	string	Prenumerationsautentiseringsuppgifter som unikt identifierar en Microsoft Azure-prenumeration. Prenumerations-ID:t utgör en del av URI:n för varje tjänstanrop.
api-version	query	True	string	Version av API:et som ska användas med klientbegäran.

Begärandetext

Name	Typ	Description
properties.lastUpdateTime	string (date-time)	Senaste uppdateringstid
properties.resourceId	string	ResourceId
properties.status	UpdateStatus	Status

Svar

Name	Typ	Description
200 OK	ApplyUpdate	ApplyUpdate-uppdateringsbegäran accepterad
201 Created	ApplyUpdate	ApplyUpdate begäran om att skapa har accepterats
Other Status Codes	MaintenanceError	Felaktig Begäran

Exempel

ApplyUpdates_CreateOrUpdateOnly_NoCancellation

ApplyUpdates_CreateOrUpdateOrCancel

ApplyUpdates_CreateOrUpdateOnly_NoCancellation

Exempelbegäran

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

{}

Exempelsvar

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

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

Exempelbegäran

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

Exempelsvar

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

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

Definitioner

Name	Description
ApplyUpdate	Tillämpa uppdateringsbegäran
createdByType	Den typ av identitet som skapade resursen.
ErrorDetails	Information om felsvar som tagits emot från Azure-underhållstjänsten.
MaintenanceError	Ett felsvar som togs emot från Azure Maintenance Service.
systemData	Metadata som rör skapande och senaste ändring av resursen.
UpdateStatus	Status

ApplyUpdate

Objekt

Tillämpa uppdateringsbegäran

Name	Typ	Description
id	string	Fullständigt kvalificerad identifierare för resursen
name	string	Resursens namn
properties.lastUpdateTime	string (date-time)	Senaste uppdateringstid
properties.resourceId	string	ResourceId
properties.status	UpdateStatus	Status
systemData	systemData	Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.
type	string	Typ av resurs

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
User
Application
ManagedIdentity
Key

ErrorDetails

Objekt

Information om felsvar som tagits emot från Azure-underhållstjänsten.

Name	Typ	Description
code	string	Tjänstdefinierad felkod. Den här koden fungerar som en understatus för HTTP-felkoden som anges i svaret.
message	string	Mänsklig läsbar representation av felet.

MaintenanceError

Objekt

Ett felsvar som togs emot från Azure Maintenance Service.

Name	Typ	Description
error	ErrorDetails	Information om felet

systemData

Objekt

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string (date-time)	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string (date-time)	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

UpdateStatus

Uppräkning

Status

Värde	Description
Pending	Det finns väntande uppdateringar som ska installeras.
InProgress	Installationen av uppdateringar pågår.
Completed	Alla uppdateringar har tillämpats.
RetryNow	Installationen av uppdateringar misslyckades men är redo att försöka igen.
RetryLater	Installationen av uppdateringar misslyckades och bör göras om senare.
NoUpdatesPending	Inga uppdateringar väntar.
Cancel	Avbryt schemat och sluta skapa PMR för resurser som ingår i det. Gäller endast för resurstypen Underhållskonfiguration.
Cancelled	Skicka det avbrutna svaret till användaren om begäran kom för att avbryta schemat. Gäller endast för resurstypen Underhållskonfiguration.