Update Runs - Put
Inserimento delle esecuzioni dell'aggiornamento per un aggiornamento specificato
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/clusters/{clusterName}/updates/{updateName}/updateRuns/{updateRunName}?api-version=2024-04-01
Parametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
cluster
|
path | True |
string |
Nome del cluster. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole. |
|
subscription
|
path | True |
string minLength: 1 |
ID della sottoscrizione di destinazione. |
|
update
|
path | True |
string |
Nome dell'aggiornamento |
|
update
|
path | True |
string |
Nome dell'esecuzione dell'aggiornamento |
|
api-version
|
query | True |
string minLength: 1 |
Versione dell'API da usare per questa operazione. |
Corpo della richiesta
| Nome | Tipo | Descrizione |
|---|---|---|
| location |
string |
Posizione geografica in cui risiede la risorsa |
| properties.duration |
string |
Durata dell'esecuzione dell'aggiornamento. |
| properties.lastUpdatedTime |
string (date-time) |
Timestamp del passaggio completato più di recente nell'esecuzione dell'aggiornamento. |
| properties.progress.description |
string |
Descrizione più dettagliata del passaggio. |
| properties.progress.endTimeUtc |
string (date-time) |
Quando il passaggio ha raggiunto uno stato terminale. |
| properties.progress.errorMessage |
string |
Messaggio di errore, specificato se il passaggio si trova in uno stato di errore. |
| properties.progress.expectedExecutionTime |
string |
Tempo di esecuzione previsto di un determinato passaggio. Questa operazione è facoltativamente creata nel piano di azione di aggiornamento e può essere vuota. |
| properties.progress.lastUpdatedTimeUtc |
string (date-time) |
Tempo di completamento di questo passaggio o dell'ultimo passaggio secondario completato. |
| properties.progress.name |
string |
Nome del passaggio. |
| properties.progress.startTimeUtc |
string (date-time) |
Quando il passaggio è stato avviato o vuoto se non è stato avviato l'esecuzione. |
| properties.progress.status |
string |
Stato del passaggio, che è stato visualizzato dal piano di azione ECE per i tentativi di installazione. I valori sono: 'Success', 'Error', 'InProgress' e 'Unknown status'. |
| properties.progress.steps |
Step[] |
Modello ricorsivo per i passaggi figlio di questo passaggio. |
| properties.state |
Stato dell'esecuzione dell'aggiornamento. |
|
| properties.timeStarted |
string (date-time) |
Timestamp dell'esecuzione dell'aggiornamento è stato avviato. |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK |
OK |
|
| Other Status Codes |
Risposta di errore che descrive il motivo per cui l'operazione non è riuscita. |
Sicurezza
azure_auth
Flusso OAuth2 di Azure Active Directory
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
| Nome | Descrizione |
|---|---|
| user_impersonation | rappresentare l'account utente |
Esempio
Get Update runs under cluster resource
Esempio di richiesta
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": []
}
]
}
}
}
Risposta di esempio
{
"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": []
}
]
}
}
}
Definizioni
| Nome | Descrizione |
|---|---|
|
created |
Tipo di identità che ha creato la risorsa. |
|
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
|
Error |
Dettagli dell'errore. |
|
Error |
Risposta di errore |
|
Provisioning |
Stato di provisioning della risorsa proxy UpdateRuns. |
| Step |
Rappresentazione dello stato dei passaggi di esecuzione dell'aggiornamento. |
|
system |
Metadati relativi alla creazione e all'ultima modifica della risorsa. |
|
Update |
Dettagli di un'esecuzione di aggiornamento |
|
update |
Stato dell'esecuzione dell'aggiornamento. |
createdByType
Tipo di identità che ha creato la risorsa.
| Valore | Descrizione |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Informazioni aggiuntive sull'errore di gestione delle risorse.
| Nome | Tipo | Descrizione |
|---|---|---|
| info |
object |
Informazioni aggiuntive. |
| type |
string |
Tipo di informazioni aggiuntive. |
ErrorDetail
Dettagli dell'errore.
| Nome | Tipo | Descrizione |
|---|---|---|
| additionalInfo |
Informazioni aggiuntive sull'errore. |
|
| code |
string |
Codice di errore. |
| details |
Dettagli dell'errore. |
|
| message |
string |
Messaggio di errore. |
| target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
| Nome | Tipo | Descrizione |
|---|---|---|
| error |
Oggetto error. |
ProvisioningState
Stato di provisioning della risorsa proxy UpdateRuns.
| Valore | Descrizione |
|---|---|
| Succeeded | |
| Failed | |
| Canceled | |
| Accepted | |
| Provisioning |
Step
Rappresentazione dello stato dei passaggi di esecuzione dell'aggiornamento.
| Nome | Tipo | Descrizione |
|---|---|---|
| description |
string |
Descrizione più dettagliata del passaggio. |
| endTimeUtc |
string (date-time) |
Quando il passaggio ha raggiunto uno stato terminale. |
| errorMessage |
string |
Messaggio di errore, specificato se il passaggio si trova in uno stato di errore. |
| expectedExecutionTime |
string |
Tempo di esecuzione previsto di un determinato passaggio. Questa operazione è facoltativamente creata nel piano di azione di aggiornamento e può essere vuota. |
| lastUpdatedTimeUtc |
string (date-time) |
Tempo di completamento di questo passaggio o dell'ultimo passaggio secondario completato. |
| name |
string |
Nome del passaggio. |
| startTimeUtc |
string (date-time) |
Quando il passaggio è stato avviato o vuoto se non è stato avviato l'esecuzione. |
| status |
string |
Stato del passaggio, che è stato visualizzato dal piano di azione ECE per i tentativi di installazione. I valori sono: 'Success', 'Error', 'InProgress' e 'Unknown status'. |
| steps |
Step[] |
Modello ricorsivo per i passaggi figlio di questo passaggio. |
systemData
Metadati relativi alla creazione e all'ultima modifica della risorsa.
| Nome | Tipo | Descrizione |
|---|---|---|
| createdAt |
string (date-time) |
Timestamp della creazione della risorsa (UTC). |
| createdBy |
string |
Identità che ha creato la risorsa. |
| createdByType |
Tipo di identità che ha creato la risorsa. |
|
| lastModifiedAt |
string (date-time) |
Timestamp dell'ultima modifica della risorsa (UTC) |
| lastModifiedBy |
string |
Identità che ha modificato l'ultima volta la risorsa. |
| lastModifiedByType |
Tipo di identità che ha modificato l'ultima volta la risorsa. |
UpdateRun
Dettagli di un'esecuzione di aggiornamento
| Nome | Tipo | Descrizione |
|---|---|---|
| id |
string |
ID risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| location |
string |
Posizione geografica in cui risiede la risorsa |
| name |
string |
Nome della risorsa |
| properties.duration |
string |
Durata dell'esecuzione dell'aggiornamento. |
| properties.lastUpdatedTime |
string (date-time) |
Timestamp del passaggio completato più di recente nell'esecuzione dell'aggiornamento. |
| properties.progress.description |
string |
Descrizione più dettagliata del passaggio. |
| properties.progress.endTimeUtc |
string (date-time) |
Quando il passaggio ha raggiunto uno stato terminale. |
| properties.progress.errorMessage |
string |
Messaggio di errore, specificato se il passaggio si trova in uno stato di errore. |
| properties.progress.expectedExecutionTime |
string |
Tempo di esecuzione previsto di un determinato passaggio. Questa operazione è facoltativamente creata nel piano di azione di aggiornamento e può essere vuota. |
| properties.progress.lastUpdatedTimeUtc |
string (date-time) |
Tempo di completamento di questo passaggio o dell'ultimo passaggio secondario completato. |
| properties.progress.name |
string |
Nome del passaggio. |
| properties.progress.startTimeUtc |
string (date-time) |
Quando il passaggio è stato avviato o vuoto se non è stato avviato l'esecuzione. |
| properties.progress.status |
string |
Stato del passaggio, che è stato visualizzato dal piano di azione ECE per i tentativi di installazione. I valori sono: 'Success', 'Error', 'InProgress' e 'Unknown status'. |
| properties.progress.steps |
Step[] |
Modello ricorsivo per i passaggi figlio di questo passaggio. |
| properties.provisioningState |
Stato di provisioning della risorsa proxy UpdateRuns. |
|
| properties.state |
Stato dell'esecuzione dell'aggiornamento. |
|
| properties.timeStarted |
string (date-time) |
Timestamp dell'esecuzione dell'aggiornamento è stato avviato. |
| systemData |
Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy. |
|
| type |
string |
Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
updateRunPropertiesState
Stato dell'esecuzione dell'aggiornamento.
| Valore | Descrizione |
|---|---|
| Unknown | |
| Succeeded | |
| InProgress | |
| Failed |