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 |
|---|---|---|---|---|
|
cluster
|
path | True |
string |
Nazwa klastra. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter. |
|
subscription
|
path | True |
string minLength: 1 |
Identyfikator subskrypcji docelowej. |
|
update
|
path | True |
string |
Nazwa aktualizacji |
|
update
|
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 |
Stan przebiegu aktualizacji. |
|
| properties.timeStarted |
string (date-time) |
Sygnatura czasowa uruchomienia aktualizacji została uruchomiona. |
Odpowiedzi
| Nazwa | Typ | Opis |
|---|---|---|
| 200 OK |
OK |
|
| Other Status Codes |
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 |
|---|---|
|
created |
Typ tożsamości, która utworzyła zasób. |
|
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
|
Error |
Szczegóły błędu. |
|
Error |
Odpowiedź na błąd |
|
Provisioning |
Stan aprowizacji zasobu serwera proxy UpdateRuns. |
| Step |
Reprezentacja postępu kroków przebiegu aktualizacji. |
|
system |
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu. |
|
Update |
Szczegóły przebiegu aktualizacji |
|
update |
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 |
Dodatkowe informacje o błędzie. |
|
| code |
string |
Kod błędu. |
| details |
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 |
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 |
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 |
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 |
Stan aprowizacji zasobu serwera proxy UpdateRuns. |
|
| properties.state |
Stan przebiegu aktualizacji. |
|
| properties.timeStarted |
string (date-time) |
Sygnatura czasowa uruchomienia aktualizacji została uruchomiona. |
| 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 |