Condividi tramite

Software Update Configuration Machine Runs - List

  • Riferimento
Servizio:
Automation
Versione API:
2023-11-01

Elenco restituito delle esecuzioni del computer di configurazione degli aggiornamenti software

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/softwareUpdateConfigurationMachineRuns?api-version=2023-11-01
Con parametri facoltativi: 
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/softwareUpdateConfigurationMachineRuns?api-version=2023-11-01&$filter={$filter}&$skip={$skip}&$top={$top}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
automationAccountName
 path True

string

Nome dell'account di automazione.
resourceGroupName
 path True

string

Nome di un gruppo di risorse di Azure.

Criterio di espressione regolare: ^[-\w\._]+$
subscriptionId
 path True

string

Ottiene le credenziali di sottoscrizione che consentono di identificare in modo univoco la sottoscrizione Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio.
api-version
 query True

string

Versione api client.
$filter
 query

string

Filtro da applicare all'operazione. È possibile usare i filtri seguenti: 'properties/osType', 'properties/status', 'properties/startTime' e 'properties/softwareUpdateConfiguration/name'
$skip
 query

string

numero di voci ignorate prima di restituire i risultati
$top
 query

string

Numero massimo di voci restituite nella raccolta dei risultati

Intestazione della richiesta

Nome Necessario Tipo Descrizione
clientRequestId

string

Identifica questa richiesta client specifica.

Risposte

Nome Tipo Descrizione
200 OK

softwareUpdateConfigurationMachineRunListResult

Restituisce l'elenco delle esecuzioni del computer di configurazione degli aggiornamenti software.
Other Status Codes

ErrorResponse

Risposta di errore di automazione 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

List software update configuration machine runs
List software update configuration machine runs for a specific software update configuration run

List software update configuration machine runs

Esempio di richiesta

GET https://management.azure.com/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationMachineRuns?api-version=2023-11-01

Risposta di esempio

Codice di stato:
200 
{
  "value": [
    {
      "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationMachineRuns/ca440719-34a4-4234-a1a9-3f84faf7788f",
      "name": "ca440719-34a4-4234-a1a9-3f84faf7788f",
      "properties": {
        "targetComputer": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Compute/virtualMachines/myvm",
        "targetComputerType": "AzureVirtualMachines",
        "softwareUpdateConfiguration": {
          "name": "mypatch"
        },
        "status": "Succeeded",
        "osType": "Windows",
        "correlationId": "0b943e57-44d3-4f05-898c-6e92aa617e59",
        "sourceComputerId": "3d3f24bf-7037-424e-bfba-aae3b9752f8e",
        "startTime": "2017-10-23T02:33:30.7484961+00:00",
        "endTime": "2017-10-23T02:33:36.4166667+00:00",
        "configuredDuration": "PT2H",
        "job": {},
        "error": {},
        "creationTime": "2017-10-23T02:33:30.7484961+00:00",
        "lastModifiedBy": "",
        "lastModifiedTime": "2017-10-23T02:34:32.4366667+00:00"
      }
    },
    {
      "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationMachineRuns/ca440719-34a4-4234-a1a9-3f84faf7789f",
      "name": "ca440719-34a4-4234-a1a9-3f84faf7789f",
      "properties": {
        "targetComputer": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Compute/virtualMachines/myvm2",
        "targetComputerType": "AzureVirtualMachines",
        "softwareUpdateConfiguration": {
          "name": "mypatch"
        },
        "status": "Succeeded",
        "osType": "Windows",
        "correlationId": "0b943e57-44d3-4f05-898c-6e92aa617e59",
        "sourceComputerId": "3d3f24bf-7037-424e-bfba-aae3b9752f8e",
        "startTime": "2017-10-23T02:33:30.7484961+00:00",
        "endTime": "2017-10-23T02:33:36.4166667+00:00",
        "configuredDuration": "PT2H",
        "job": {},
        "error": {},
        "creationTime": "2017-10-23T02:33:30.7484961+00:00",
        "lastModifiedBy": "",
        "lastModifiedTime": "2017-10-23T02:34:32.4366667+00:00"
      }
    }
  ],
  "nextLink": "https://management.azure.com:443/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationRuns?api-version=2019-06-01&_=1508725900015&$skip=100"
}

List software update configuration machine runs for a specific software update configuration run

Esempio di richiesta

GET https://management.azure.com/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationMachineRuns?api-version=2023-11-01&$filter=$filter=properties/correlationId%20eq%200b943e57-44d3-4f05-898c-6e92aa617e59

Risposta di esempio

Codice di stato:
200 
{
  "value": [
    {
      "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationMachineRuns/ca440719-34a4-4234-a1a9-3f84faf7788f",
      "name": "ca440719-34a4-4234-a1a9-3f84faf7788f",
      "properties": {
        "targetComputer": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Compute/virtualMachines/myvm",
        "targetComputerType": "AzureVirtualMachines",
        "softwareUpdateConfiguration": {
          "name": "mypatch"
        },
        "status": "Succeeded",
        "osType": "Windows",
        "correlationId": "0b943e57-44d3-4f05-898c-6e92aa617e59",
        "sourceComputerId": "3d3f24bf-7037-424e-bfba-aae3b9752f8e",
        "startTime": "2017-10-23T02:33:30.7484961+00:00",
        "endTime": "2017-10-23T02:33:36.4166667+00:00",
        "configuredDuration": "PT2H",
        "job": {},
        "error": {},
        "creationTime": "2017-10-23T02:33:30.7484961+00:00",
        "lastModifiedBy": "",
        "lastModifiedTime": "2017-10-23T02:34:32.4366667+00:00"
      }
    },
    {
      "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationMachineRuns/ca440719-34a4-4234-a1a9-3f84faf7789f",
      "name": "ca440719-34a4-4234-a1a9-3f84faf7789f",
      "properties": {
        "targetComputer": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Compute/virtualMachines/myvm2",
        "targetComputerType": "AzureVirtualMachines",
        "softwareUpdateConfiguration": {
          "name": "mypatch"
        },
        "status": "Succeeded",
        "osType": "Windows",
        "correlationId": "0b943e57-44d3-4f05-898c-6e92aa617e59",
        "sourceComputerId": "3d3f24bf-7037-424e-bfba-aae3b9752f8e",
        "startTime": "2017-10-23T02:33:30.7484961+00:00",
        "endTime": "2017-10-23T02:33:36.4166667+00:00",
        "configuredDuration": "PT2H",
        "job": {},
        "error": {},
        "creationTime": "2017-10-23T02:33:30.7484961+00:00",
        "lastModifiedBy": "",
        "lastModifiedTime": "2017-10-23T02:34:32.4366667+00:00"
      }
    }
  ],
  "nextLink": "https://management.azure.com:443/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationRuns?api-version=2019-06-01&_=1508725900015&$skip=100"
}

Definizioni

Nome Descrizione
ErrorResponse

Risposta di errore di un errore dell'operazione
jobNavigation

Le proprietà di navigazione del processo vengono eseguite dal computer di configurazione dell'aggiornamento software.
softwareUpdateConfigurationMachineRun

Modello di esecuzione del computer di configurazione dell'aggiornamento software.
softwareUpdateConfigurationMachineRunListResult

risultato dell'elenco di tutte le esecuzioni del computer di configurazione degli aggiornamenti software
updateConfigurationNavigation

Configurazione dell'aggiornamento software Eseguire il modello di spostamento.

ErrorResponse

Risposta di errore di un errore dell'operazione

Nome Tipo Descrizione
code

string

Codice di errore
message

string

Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.

jobNavigation

Le proprietà di navigazione del processo vengono eseguite dal computer di configurazione dell'aggiornamento software.

Nome Tipo Descrizione
id

string

ID del processo associato all'esecuzione della configurazione dell'aggiornamento software

softwareUpdateConfigurationMachineRun

Modello di esecuzione del computer di configurazione dell'aggiornamento software.

Nome Tipo Descrizione
id

string

ID risorsa dell'esecuzione del computer di configurazione dell'aggiornamento software
name

string

Nome dell'esecuzione del computer di configurazione dell'aggiornamento software
properties.configuredDuration

string

durata configurata per l'esecuzione della configurazione dell'aggiornamento software.
properties.correlationId

string

ID di correlazione dell'esecuzione del computer di configurazione dell'aggiornamento software
properties.createdBy

string

proprietà createdBy, che viene visualizzata solo nella risposta.
properties.creationTime

string

Ora di creazione della risorsa, che viene visualizzata solo nella risposta.
properties.endTime

string

Ora di fine dell'esecuzione del computer di configurazione dell'aggiornamento software.
properties.error

ErrorResponse

Dettagli dell'errore di provisioning
properties.job

jobNavigation

Processo associato all'esecuzione del computer di configurazione dell'aggiornamento software
properties.lastModifiedBy

string

proprietà lastModifiedBy, che viene visualizzata solo nella risposta.
properties.lastModifiedTime

string

Ultima modifica della risorsa, che viene visualizzata solo nella risposta.
properties.osType

string

La destinazione del sistema operativo della configurazione dell'aggiornamento software ha attivato questa esecuzione
properties.softwareUpdateConfiguration

updateConfigurationNavigation

la configurazione dell'aggiornamento software ha attivato questa esecuzione
properties.sourceComputerId

string

ID computer di origine dell'esecuzione del computer di configurazione dell'aggiornamento software
properties.startTime

string

Ora di inizio dell'esecuzione del computer di configurazione dell'aggiornamento software.
properties.status

string

Stato dell'esecuzione del computer di configurazione dell'aggiornamento software.
properties.targetComputer

string

nome del computer aggiornato
properties.targetComputerType

string

tipo del computer aggiornato.

softwareUpdateConfigurationMachineRunListResult

risultato dell'elenco di tutte le esecuzioni del computer di configurazione degli aggiornamenti software

Nome Tipo Descrizione
nextLink

string

collegamento alla pagina successiva dei risultati.
value

softwareUpdateConfigurationMachineRun[]

oggetto esterno restituito durante l'elenco di tutte le esecuzioni del computer di configurazione degli aggiornamenti software

updateConfigurationNavigation

Configurazione dell'aggiornamento software Eseguire il modello di spostamento.

Nome Tipo Descrizione
name

string

Il nome della configurazione dell'aggiornamento software ha attivato l'esecuzione della configurazione dell'aggiornamento software