Update Runs - Put
Updateuitvoeringen voor een opgegeven update plaatsen
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/clusters/{clusterName}/updates/{updateName}/updateRuns/{updateRunName}?api-version=2024-04-01
URI-parameters
| Name | In | Vereist | Type | Description |
|---|---|---|---|---|
|
cluster
|
path | True |
string |
De naam van het cluster. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
De naam van de resourcegroep. De naam is niet hoofdlettergevoelig. |
|
subscription
|
path | True |
string minLength: 1 |
De id van het doelabonnement. |
|
update
|
path | True |
string |
De naam van de update |
|
update
|
path | True |
string |
De naam van de updateuitvoering |
|
api-version
|
query | True |
string minLength: 1 |
De API-versie die voor deze bewerking moet worden gebruikt. |
Aanvraagbody
| Name | Type | Description |
|---|---|---|
| location |
string |
De geografische locatie waar de resource zich bevindt |
| properties.duration |
string |
Duur van de updateuitvoering. |
| properties.lastUpdatedTime |
string (date-time) |
Tijdstempel van de laatst voltooide stap in de updateuitvoering. |
| properties.progress.description |
string |
Gedetailleerdere beschrijving van de stap. |
| properties.progress.endTimeUtc |
string (date-time) |
Wanneer de stap een terminalstatus heeft bereikt. |
| properties.progress.errorMessage |
string |
Foutbericht, opgegeven als de stap de status Mislukt heeft. |
| properties.progress.expectedExecutionTime |
string |
Verwachte uitvoeringstijd van een bepaalde stap. Dit is optioneel geschreven in het actieplan voor updates en kan leeg zijn. |
| properties.progress.lastUpdatedTimeUtc |
string (date-time) |
Voltooiingstijd van deze stap of de laatste voltooide substap. |
| properties.progress.name |
string |
Naam van de stap. |
| properties.progress.startTimeUtc |
string (date-time) |
Wanneer de stap is gestart of leeg is als deze nog niet is gestart. |
| properties.progress.status |
string |
Status van de stap, opgebeld vanuit het ECE-actieplan voor installatiepogingen. Waarden zijn: 'Success', 'Error', 'InProgress' en 'Unknown status'. |
| properties.progress.steps |
Step[] |
Recursief model voor onderliggende stappen van deze stap. |
| properties.state |
Status van de updateuitvoering. |
|
| properties.timeStarted |
string (date-time) |
De tijdstempel van de updateuitvoering is gestart. |
Antwoorden
| Name | Type | Description |
|---|---|---|
| 200 OK |
OK |
|
| Other Status Codes |
Foutreactie waarin wordt beschreven waarom de bewerking is mislukt. |
Beveiliging
azure_auth
Azure Active Directory OAuth2-stroom
Type:
oauth2
Stroom:
implicit
Autorisatie-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiken
| Name | Description |
|---|---|
| user_impersonation | Uw gebruikersaccount imiteren |
Voorbeelden
Get Update runs under cluster resource
Voorbeeldaanvraag
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": []
}
]
}
}
}
Voorbeeldrespons
{
"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": []
}
]
}
}
}
Definities
| Name | Description |
|---|---|
|
created |
Het type identiteit waarmee de resource is gemaakt. |
|
Error |
Aanvullende informatie over de resourcebeheerfout. |
|
Error |
De foutdetails. |
|
Error |
Foutreactie |
|
Provisioning |
Inrichtingsstatus van de UpdateRuns-proxyresource. |
| Step |
Voortgangsweergave van de updateuitvoeringsstappen. |
|
system |
Metagegevens met betrekking tot het maken en de laatste wijziging van de resource. |
|
Update |
Details van een updateuitvoering |
|
update |
Status van de updateuitvoering. |
createdByType
Het type identiteit waarmee de resource is gemaakt.
| Waarde | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Aanvullende informatie over de resourcebeheerfout.
| Name | Type | Description |
|---|---|---|
| info |
object |
De aanvullende informatie. |
| type |
string |
Het extra informatietype. |
ErrorDetail
De foutdetails.
| Name | Type | Description |
|---|---|---|
| additionalInfo |
De fout bevat aanvullende informatie. |
|
| code |
string |
De foutcode. |
| details |
De foutdetails. |
|
| message |
string |
Het foutbericht. |
| target |
string |
Het foutdoel. |
ErrorResponse
Foutreactie
| Name | Type | Description |
|---|---|---|
| error |
Het foutobject. |
ProvisioningState
Inrichtingsstatus van de UpdateRuns-proxyresource.
| Waarde | Description |
|---|---|
| Succeeded | |
| Failed | |
| Canceled | |
| Accepted | |
| Provisioning |
Step
Voortgangsweergave van de updateuitvoeringsstappen.
| Name | Type | Description |
|---|---|---|
| description |
string |
Gedetailleerdere beschrijving van de stap. |
| endTimeUtc |
string (date-time) |
Wanneer de stap een terminalstatus heeft bereikt. |
| errorMessage |
string |
Foutbericht, opgegeven als de stap de status Mislukt heeft. |
| expectedExecutionTime |
string |
Verwachte uitvoeringstijd van een bepaalde stap. Dit is optioneel geschreven in het actieplan voor updates en kan leeg zijn. |
| lastUpdatedTimeUtc |
string (date-time) |
Voltooiingstijd van deze stap of de laatste voltooide substap. |
| name |
string |
Naam van de stap. |
| startTimeUtc |
string (date-time) |
Wanneer de stap is gestart of leeg is als deze nog niet is gestart. |
| status |
string |
Status van de stap, opgebeld vanuit het ECE-actieplan voor installatiepogingen. Waarden zijn: 'Success', 'Error', 'InProgress' en 'Unknown status'. |
| steps |
Step[] |
Recursief model voor onderliggende stappen van deze stap. |
systemData
Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
| Name | Type | Description |
|---|---|---|
| createdAt |
string (date-time) |
De tijdstempel van het maken van resources (UTC). |
| createdBy |
string |
De identiteit waarmee de resource is gemaakt. |
| createdByType |
Het type identiteit waarmee de resource is gemaakt. |
|
| lastModifiedAt |
string (date-time) |
De tijdstempel van de laatste wijziging van de resource (UTC) |
| lastModifiedBy |
string |
De identiteit die de resource voor het laatst heeft gewijzigd. |
| lastModifiedByType |
Het type identiteit dat de resource voor het laatst heeft gewijzigd. |
UpdateRun
Details van een updateuitvoering
| Name | Type | Description |
|---|---|---|
| id |
string |
Volledig gekwalificeerde resource-id voor de resource. Vb.: - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| location |
string |
De geografische locatie waar de resource zich bevindt |
| name |
string |
De naam van de resource |
| properties.duration |
string |
Duur van de updateuitvoering. |
| properties.lastUpdatedTime |
string (date-time) |
Tijdstempel van de laatst voltooide stap in de updateuitvoering. |
| properties.progress.description |
string |
Gedetailleerdere beschrijving van de stap. |
| properties.progress.endTimeUtc |
string (date-time) |
Wanneer de stap een terminalstatus heeft bereikt. |
| properties.progress.errorMessage |
string |
Foutbericht, opgegeven als de stap de status Mislukt heeft. |
| properties.progress.expectedExecutionTime |
string |
Verwachte uitvoeringstijd van een bepaalde stap. Dit is optioneel geschreven in het actieplan voor updates en kan leeg zijn. |
| properties.progress.lastUpdatedTimeUtc |
string (date-time) |
Voltooiingstijd van deze stap of de laatste voltooide substap. |
| properties.progress.name |
string |
Naam van de stap. |
| properties.progress.startTimeUtc |
string (date-time) |
Wanneer de stap is gestart of leeg is als deze nog niet is gestart. |
| properties.progress.status |
string |
Status van de stap, opgebeld vanuit het ECE-actieplan voor installatiepogingen. Waarden zijn: 'Success', 'Error', 'InProgress' en 'Unknown status'. |
| properties.progress.steps |
Step[] |
Recursief model voor onderliggende stappen van deze stap. |
| properties.provisioningState |
Inrichtingsstatus van de UpdateRuns-proxyresource. |
|
| properties.state |
Status van de updateuitvoering. |
|
| properties.timeStarted |
string (date-time) |
De tijdstempel van de updateuitvoering is gestart. |
| systemData |
Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens. |
|
| type |
string |
Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts' |
updateRunPropertiesState
Status van de updateuitvoering.
| Waarde | Description |
|---|---|
| Unknown | |
| Succeeded | |
| InProgress | |
| Failed |