Udostępnij za pośrednictwem


Update Runs - Put

Umieszczanie przebiegów aktualizacji dla określonej aktualizacji

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/clusters/{clusterName}/updates/{updateName}/updateRuns/{updateRunName}?api-version=2024-04-01

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
clusterName
path True

string

Nazwa klastra.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

subscriptionId
path True

string

minLength: 1

Identyfikator subskrypcji docelowej.

updateName
path True

string

Nazwa aktualizacji

updateRunName
path True

string

Nazwa przebiegu aktualizacji

api-version
query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa Typ Opis
location

string

Lokalizacja geograficzna, w której znajduje się zasób

properties.duration

string

Czas trwania przebiegu aktualizacji.

properties.lastUpdatedTime

string (date-time)

Sygnatura czasowa ostatniego ukończonego kroku w przebiegu aktualizacji.

properties.progress.description

string

Bardziej szczegółowy opis kroku.

properties.progress.endTimeUtc

string (date-time)

Gdy krok osiągnął stan terminalu.

properties.progress.errorMessage

string

Komunikat o błędzie określony, jeśli krok jest w stanie niepowodzenia.

properties.progress.expectedExecutionTime

string

Oczekiwany czas wykonywania danego kroku. Jest to opcjonalne autoryzowane w planie działania aktualizacji i może być puste.

properties.progress.lastUpdatedTimeUtc

string (date-time)

Czas ukończenia tego kroku lub ostatni ukończony podetap.

properties.progress.name

string

Nazwa kroku.

properties.progress.startTimeUtc

string (date-time)

Gdy krok został uruchomiony lub pusty, jeśli nie został uruchomiony.

properties.progress.status

string

Stan kroku, w górę z planu działania ECE na potrzeby prób instalacji. Wartości to: "Success", "Error", "InProgress" i "Unknown status".

properties.progress.steps

Step[]

Model rekursywny dla podrzędnych kroków tego kroku.

properties.state

updateRunPropertiesState

Stan przebiegu aktualizacji.

properties.timeStarted

string (date-time)

Sygnatura czasowa uruchomienia aktualizacji została uruchomiona.

Odpowiedzi

Nazwa Typ Opis
200 OK

UpdateRun

OK

Other Status Codes

ErrorResponse

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

Get Update runs under cluster resource

Przykładowe żądanie

PUT https://management.azure.com/subscriptions/b8d594e5-51f3-4c11-9c54-a7771b81c712/resourceGroups/testrg/providers/Microsoft.AzureStackHCI/clusters/testcluster/updates/Microsoft4.2203.2.32/updateRuns/23b779ba-0d52-4a80-8571-45ca74664ec3?api-version=2024-04-01

{
  "properties": {
    "progress": {
      "name": "Unnamed step",
      "description": "Update Azure Stack.",
      "errorMessage": "",
      "status": "Success",
      "startTimeUtc": "2022-04-06T01:36:33.3876751+00:00",
      "endTimeUtc": "2022-04-06T13:58:42.969006+00:00",
      "lastUpdatedTimeUtc": "2022-04-06T13:58:42.969006+00:00",
      "steps": [
        {
          "name": "PreUpdate Cloud",
          "description": "Prepare for SSU update",
          "errorMessage": "",
          "status": "Success",
          "startTimeUtc": "2022-04-06T01:36:33.3876751+00:00",
          "endTimeUtc": "2022-04-06T01:37:16.8728314+00:00",
          "lastUpdatedTimeUtc": "2022-04-06T01:37:16.8728314+00:00",
          "steps": []
        }
      ]
    }
  }
}

Przykładowa odpowiedź

{
  "id": "/subscriptions/b8d594e5-51f3-4c11-9c54-a7771b81c712/resourceGroups/testrg/providers/Microsoft.AzureStackHCI/clusters/testcluster/updates/Microsoft4.2203.2.32/updateRuns/23b779ba-0d52-4a80-8571-45ca74664ec3",
  "name": "Microsoft4.2203.2.32/23b779ba-0d52-4a80-8571-45ca74664ec3",
  "type": "Microsoft.AzureStackHCI/updates/updateRuns",
  "location": "West US",
  "properties": {
    "progress": {
      "name": "Unnamed step",
      "description": "Update Azure Stack.",
      "errorMessage": "",
      "status": "Success",
      "startTimeUtc": "2022-04-06T01:36:33.3876751+00:00",
      "endTimeUtc": "2022-04-06T13:58:42.969006+00:00",
      "lastUpdatedTimeUtc": "2022-04-06T13:58:42.969006+00:00",
      "steps": [
        {
          "name": "PreUpdate Cloud",
          "description": "Prepare for SSU update",
          "errorMessage": "",
          "status": "Success",
          "startTimeUtc": "2022-04-06T01:36:33.3876751+00:00",
          "endTimeUtc": "2022-04-06T01:37:16.8728314+00:00",
          "lastUpdatedTimeUtc": "2022-04-06T01:37:16.8728314+00:00",
          "steps": []
        }
      ]
    }
  }
}

Definicje

Nazwa Opis
createdByType

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

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

ProvisioningState

Stan aprowizacji zasobu serwera proxy UpdateRuns.

Step

Reprezentacja postępu kroków przebiegu aktualizacji.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

UpdateRun

Szczegóły przebiegu aktualizacji

updateRunPropertiesState

Stan przebiegu aktualizacji.

createdByType

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

Wartość Opis
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

code

string

Kod błędu.

details

ErrorDetail[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt błędu.

ProvisioningState

Stan aprowizacji zasobu serwera proxy UpdateRuns.

Wartość Opis
Succeeded
Failed
Canceled
Accepted
Provisioning

Step

Reprezentacja postępu kroków przebiegu aktualizacji.

Nazwa Typ Opis
description

string

Bardziej szczegółowy opis kroku.

endTimeUtc

string (date-time)

Gdy krok osiągnął stan terminalu.

errorMessage

string

Komunikat o błędzie określony, jeśli krok jest w stanie niepowodzenia.

expectedExecutionTime

string

Oczekiwany czas wykonywania danego kroku. Jest to opcjonalne autoryzowane w planie działania aktualizacji i może być puste.

lastUpdatedTimeUtc

string (date-time)

Czas ukończenia tego kroku lub ostatni ukończony podetap.

name

string

Nazwa kroku.

startTimeUtc

string (date-time)

Gdy krok został uruchomiony lub pusty, jeśli nie został uruchomiony.

status

string

Stan kroku, w górę z planu działania ECE na potrzeby prób instalacji. Wartości to: "Success", "Error", "InProgress" i "Unknown status".

steps

Step[]

Model rekursywny dla podrzędnych kroków tego kroku.

systemData

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.

UpdateRun

Szczegóły przebiegu aktualizacji

Nazwa Typ Opis
id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Przykład - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Lokalizacja geograficzna, w której znajduje się zasób

name

string

Nazwa zasobu

properties.duration

string

Czas trwania przebiegu aktualizacji.

properties.lastUpdatedTime

string (date-time)

Sygnatura czasowa ostatniego ukończonego kroku w przebiegu aktualizacji.

properties.progress.description

string

Bardziej szczegółowy opis kroku.

properties.progress.endTimeUtc

string (date-time)

Gdy krok osiągnął stan terminalu.

properties.progress.errorMessage

string

Komunikat o błędzie określony, jeśli krok jest w stanie niepowodzenia.

properties.progress.expectedExecutionTime

string

Oczekiwany czas wykonywania danego kroku. Jest to opcjonalne autoryzowane w planie działania aktualizacji i może być puste.

properties.progress.lastUpdatedTimeUtc

string (date-time)

Czas ukończenia tego kroku lub ostatni ukończony podetap.

properties.progress.name

string

Nazwa kroku.

properties.progress.startTimeUtc

string (date-time)

Gdy krok został uruchomiony lub pusty, jeśli nie został uruchomiony.

properties.progress.status

string

Stan kroku, w górę z planu działania ECE na potrzeby prób instalacji. Wartości to: "Success", "Error", "InProgress" i "Unknown status".

properties.progress.steps

Step[]

Model rekursywny dla podrzędnych kroków tego kroku.

properties.provisioningState

ProvisioningState

Stan aprowizacji zasobu serwera proxy UpdateRuns.

properties.state

updateRunPropertiesState

Stan przebiegu aktualizacji.

properties.timeStarted

string (date-time)

Sygnatura czasowa uruchomienia aktualizacji została uruchomiona.

systemData

systemData

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

type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

updateRunPropertiesState

Stan przebiegu aktualizacji.

Wartość Opis
Unknown
Succeeded
InProgress
Failed