Update Runs - Put
Placera uppdateringskörningar för en angiven uppdatering
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/clusters/{clusterName}/updates/{updateName}/updateRuns/{updateRunName}?api-version=2024-04-01
URI-parametrar
| Name | I | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
cluster
|
path | True |
string |
Namnet på klustret. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Namnet på resursgruppen. Namnet är skiftlägesokänsligt. |
|
subscription
|
path | True |
string minLength: 1 |
ID för målprenumerationen. |
|
update
|
path | True |
string |
Namnet på uppdateringen |
|
update
|
path | True |
string |
Namnet på uppdateringskörningen |
|
api-version
|
query | True |
string minLength: 1 |
DEN API-version som ska användas för den här åtgärden. |
Begärandetext
| Name | Typ | Description |
|---|---|---|
| location |
string |
Den geo-plats där resursen finns |
| properties.duration |
string |
Varaktighet för uppdateringskörningen. |
| properties.lastUpdatedTime |
string (date-time) |
Tidsstämpel för det senast slutförda steget i uppdateringskörningen. |
| properties.progress.description |
string |
Mer detaljerad beskrivning av steget. |
| properties.progress.endTimeUtc |
string (date-time) |
När steget nådde ett terminaltillstånd. |
| properties.progress.errorMessage |
string |
Felmeddelande, som anges om steget är i ett feltillstånd. |
| properties.progress.expectedExecutionTime |
string |
Förväntad körningstid för ett visst steg. Detta kan också skrivas i åtgärdsplanen för uppdatering och kan vara tomt. |
| properties.progress.lastUpdatedTimeUtc |
string (date-time) |
Slutförandetid för det här steget eller det senaste slutförda understeget. |
| properties.progress.name |
string |
Namnet på steget. |
| properties.progress.startTimeUtc |
string (date-time) |
När steget startade eller tomt om det inte har börjat köras. |
| properties.progress.status |
string |
Status för steget, bubblade upp från ECE-åtgärdsplanen för installationsförsök. Värdena är: "Success", "Error", "InProgress" och "Unknown status". |
| properties.progress.steps |
Step[] |
Rekursiv modell för underordnade steg i det här steget. |
| properties.state |
Status för uppdateringskörningen. |
|
| properties.timeStarted |
string (date-time) |
Tidsstämpeln för uppdateringskörningen startades. |
Svar
| Name | Typ | Description |
|---|---|---|
| 200 OK |
OKEJ |
|
| Other Status Codes |
Felsvar som beskriver varför åtgärden misslyckades. |
Säkerhet
azure_auth
Azure Active Directory OAuth2-flöde
Typ:
oauth2
Flow:
implicit
Auktoriseringswebbadress:
https://login.microsoftonline.com/common/oauth2/authorize
Omfattningar
| Name | Description |
|---|---|
| user_impersonation | personifiera ditt användarkonto |
Exempel
Get Update runs under cluster resource
Exempelbegäran
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": []
}
]
}
}
}
Exempelsvar
{
"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": []
}
]
}
}
}
Definitioner
| Name | Description |
|---|---|
|
created |
Den typ av identitet som skapade resursen. |
|
Error |
Ytterligare information om resurshanteringsfelet. |
|
Error |
Felinformationen. |
|
Error |
Felsvar |
|
Provisioning |
Etableringstillstånd för proxyresursen UpdateRuns. |
| Step |
Förloppsrepresentation av uppdateringskörningsstegen. |
|
system |
Metadata som rör skapande och senaste ändring av resursen. |
|
Update |
Information om en uppdateringskörning |
|
update |
Status för uppdateringskörningen. |
createdByType
Den typ av identitet som skapade resursen.
| Värde | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Ytterligare information om resurshanteringsfelet.
| Name | Typ | Description |
|---|---|---|
| info |
object |
Ytterligare information. |
| type |
string |
Ytterligare informationstyp. |
ErrorDetail
Felinformationen.
| Name | Typ | Description |
|---|---|---|
| additionalInfo |
Ytterligare information om felet. |
|
| code |
string |
Felkoden. |
| details |
Felinformationen. |
|
| message |
string |
Felmeddelandet. |
| target |
string |
Felmålet. |
ErrorResponse
Felsvar
| Name | Typ | Description |
|---|---|---|
| error |
Felobjektet. |
ProvisioningState
Etableringstillstånd för proxyresursen UpdateRuns.
| Värde | Description |
|---|---|
| Succeeded | |
| Failed | |
| Canceled | |
| Accepted | |
| Provisioning |
Step
Förloppsrepresentation av uppdateringskörningsstegen.
| Name | Typ | Description |
|---|---|---|
| description |
string |
Mer detaljerad beskrivning av steget. |
| endTimeUtc |
string (date-time) |
När steget nådde ett terminaltillstånd. |
| errorMessage |
string |
Felmeddelande, som anges om steget är i ett feltillstånd. |
| expectedExecutionTime |
string |
Förväntad körningstid för ett visst steg. Detta kan också skrivas i åtgärdsplanen för uppdatering och kan vara tomt. |
| lastUpdatedTimeUtc |
string (date-time) |
Slutförandetid för det här steget eller det senaste slutförda understeget. |
| name |
string |
Namnet på steget. |
| startTimeUtc |
string (date-time) |
När steget startade eller tomt om det inte har börjat köras. |
| status |
string |
Status för steget, bubblade upp från ECE-åtgärdsplanen för installationsförsök. Värdena är: "Success", "Error", "InProgress" och "Unknown status". |
| steps |
Step[] |
Rekursiv modell för underordnade steg i det här steget. |
systemData
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 |
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 |
Den typ av identitet som senast ändrade resursen. |
UpdateRun
Information om en uppdateringskörning
| Name | Typ | Description |
|---|---|---|
| id |
string |
Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| location |
string |
Den geo-plats där resursen finns |
| name |
string |
Namnet på resursen |
| properties.duration |
string |
Varaktighet för uppdateringskörningen. |
| properties.lastUpdatedTime |
string (date-time) |
Tidsstämpel för det senast slutförda steget i uppdateringskörningen. |
| properties.progress.description |
string |
Mer detaljerad beskrivning av steget. |
| properties.progress.endTimeUtc |
string (date-time) |
När steget nådde ett terminaltillstånd. |
| properties.progress.errorMessage |
string |
Felmeddelande, som anges om steget är i ett feltillstånd. |
| properties.progress.expectedExecutionTime |
string |
Förväntad körningstid för ett visst steg. Detta kan också skrivas i åtgärdsplanen för uppdatering och kan vara tomt. |
| properties.progress.lastUpdatedTimeUtc |
string (date-time) |
Slutförandetid för det här steget eller det senaste slutförda understeget. |
| properties.progress.name |
string |
Namnet på steget. |
| properties.progress.startTimeUtc |
string (date-time) |
När steget startade eller tomt om det inte har börjat köras. |
| properties.progress.status |
string |
Status för steget, bubblade upp från ECE-åtgärdsplanen för installationsförsök. Värdena är: "Success", "Error", "InProgress" och "Unknown status". |
| properties.progress.steps |
Step[] |
Rekursiv modell för underordnade steg i det här steget. |
| properties.provisioningState |
Etableringstillstånd för proxyresursen UpdateRuns. |
|
| properties.state |
Status för uppdateringskörningen. |
|
| properties.timeStarted |
string (date-time) |
Tidsstämpeln för uppdateringskörningen startades. |
| systemData |
Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information. |
|
| type |
string |
Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts" |
updateRunPropertiesState
Status för uppdateringskörningen.
| Värde | Description |
|---|---|
| Unknown | |
| Succeeded | |
| InProgress | |
| Failed |