Udostępnij przez

Apply Updates - Create Or Update Or Cancel

Usługa:
Maintenance
Wersja interfejsu API:
2023-09-01-preview

Stosowanie aktualizacji do zasobu
Stosowanie aktualizacji konserwacji do zasobu

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
applyUpdateName
 path True

string

Nazwa ApplyUpdate
providerName
 path True

string

Nazwa dostawcy zasobów
resourceGroupName
 path True

string

Nazwa grupy zasobów
resourceName
 path True

string

Identyfikator zasobu
resourceType
 path True

string

Typ zasobu
subscriptionId
 path True

string

Poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.
api-version
 query True

string

Wersja interfejsu API do użycia z żądaniem klienta.

Treść żądania

Nazwa Typ Opis
properties.lastUpdateTime

string (date-time)

Czas ostatniej aktualizacji
properties.resourceId

string

Identyfikator zasobu
properties.status

UpdateStatus

Stan

Odpowiedzi

Nazwa Typ Opis
200 OK

ApplyUpdate

Zaakceptowane żądanie aktualizacji ApplyUpdate
201 Created

ApplyUpdate

ApplyUpdate — zaakceptowane żądanie tworzenia
Other Status Codes

MaintenanceError

NieprawidłoweŻądanie

Przykłady

ApplyUpdates_CreateOrUpdateOnly_NoCancellation
ApplyUpdates_CreateOrUpdateOrCancel

ApplyUpdates_CreateOrUpdateOnly_NoCancellation

Przykładowe żądanie

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

{}

Przykładowa odpowiedź

Kod stanu:
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"
  }
}
Kod stanu:
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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:
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"
  }
}
Kod stanu:
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"
  }
}

Definicje

Nazwa Opis
ApplyUpdate

Zastosuj żądanie aktualizacji
createdByType

Typ tożsamości, która utworzyła zasób.
ErrorDetails

Szczegóły odpowiedzi na błąd odebrane z usługi Azure Maintenance.
MaintenanceError

Odebrano odpowiedź o błędzie z usługi Azure Maintenance.
systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
UpdateStatus

Stan

ApplyUpdate

Objekt

Zastosuj żądanie aktualizacji

Nazwa Typ Opis
id

string

W pełni kwalifikowany identyfikator zasobu
name

string

Nazwa zasobu
properties.lastUpdateTime

string (date-time)

Czas ostatniej aktualizacji
properties.resourceId

string

Identyfikator zasobu
properties.status

UpdateStatus

Stan
systemData

systemData

Metadane usługi Azure Resource Manager zawierające informacje createdBy i modifiedBy.
type

string

Typ zasobu

createdByType

Wyliczanie

Typ tożsamości, która utworzyła zasób.

Wartość Opis
User
Application
ManagedIdentity
Key

ErrorDetails

Objekt

Szczegóły odpowiedzi na błąd odebrane z usługi Azure Maintenance.

Nazwa Typ Opis
code

string

Kod błędu zdefiniowany przez usługę. Ten kod służy jako podstan kodu błędu HTTP określonego w odpowiedzi.
message

string

Czytelna dla człowieka reprezentacja błędu.

MaintenanceError

Objekt

Odebrano odpowiedź o błędzie z usługi Azure Maintenance.

Nazwa Typ Opis
error

ErrorDetails

Szczegóły błędu

systemData

Objekt

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa Typ Opis
createdAt

string (date-time)

Sygnatura czasowa tworzenia zasobu (UTC).
createdBy

string

Tożsamość, która utworzyła zasób.
createdByType

createdByType

Typ tożsamości, która utworzyła zasób.
lastModifiedAt

string (date-time)

Znacznik czasu ostatniej modyfikacji zasobu (UTC)
lastModifiedBy

string

Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType

createdByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.

UpdateStatus

Wyliczanie

Stan

Wartość Opis
Pending

Oczekujące aktualizacje mają zostać zainstalowane.
InProgress

Trwa instalacja aktualizacji.
Completed

Wszystkie aktualizacje są pomyślnie stosowane.
RetryNow

Instalacja aktualizacji nie powiodła się, ale jest gotowa do ponownej próby.
RetryLater

Instalacja aktualizacji nie powiodła się i powinna zostać ponowiona później.
NoUpdatesPending

Brak oczekujących aktualizacji.
Cancel

Anuluj harmonogram i zatrzymaj tworzenie usługi PMR dla części zasobów. Dotyczy tylko typu zasobu Konfiguracja konserwacji.
Cancelled

Wyślij anulowaną odpowiedź do użytkownika, jeśli żądanie nastąpiło, aby anulować harmonogram. Dotyczy tylko typu zasobu Konfiguracja konserwacji.