Condividi tramite


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
clusterName
path True

string

Nome del cluster.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.

subscriptionId
path True

string

minLength: 1

ID della sottoscrizione di destinazione.

updateName
path True

string

Nome dell'aggiornamento

updateRunName
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

updateRunPropertiesState

Stato dell'esecuzione dell'aggiornamento.

properties.timeStarted

string (date-time)

Timestamp dell'esecuzione dell'aggiornamento è stato avviato.

Risposte

Nome Tipo Descrizione
200 OK

UpdateRun

OK

Other Status Codes

ErrorResponse

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
createdByType

Tipo di identità che ha creato la risorsa.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

ProvisioningState

Stato di provisioning della risorsa proxy UpdateRuns.

Step

Rappresentazione dello stato dei passaggi di esecuzione dell'aggiornamento.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

UpdateRun

Dettagli di un'esecuzione di aggiornamento

updateRunPropertiesState

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

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

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

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

createdByType

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

ProvisioningState

Stato di provisioning della risorsa proxy UpdateRuns.

properties.state

updateRunPropertiesState

Stato dell'esecuzione dell'aggiornamento.

properties.timeStarted

string (date-time)

Timestamp dell'esecuzione dell'aggiornamento è stato avviato.

systemData

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