Software Update Configuration Machine Runs - List

Referenz

Dienst:: Automation

API-Version:: 2023-11-01

Rückgabeliste der Ausgeführten Softwareupdate-Konfigurationscomputer

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/softwareUpdateConfigurationMachineRuns?api-version=2023-11-01

Mit optionalen Parametern:

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}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
automationAccountName	path	True	string	Der Name des Automatisierungskontos.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	Name einer Azure-Ressourcengruppe.
subscriptionId	path	True	string	Ruft Abonnementanmeldeinformationen ab, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.
api-version	query	True	string	Client-API-Version.
$filter	query		string	Der filter, der auf den Vorgang angewendet werden soll. Sie können die folgenden Filter verwenden: 'properties/osType', 'properties/status', 'properties/startTime' und 'properties/softwareUpdateConfiguration/name'
$skip	query		string	Anzahl der Einträge, die Vor dem Zurückgeben von Ergebnissen übersprungen werden
$top	query		string	Maximale Anzahl von Einträgen, die in der Ergebnisauflistung zurückgegeben werden

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
clientRequestId		string	Identifiziert diese spezifische Clientanforderung.

Antworten

Name	Typ	Beschreibung
200 OK	softwareUpdateConfigurationMachineRunListResult	Gibt die Liste der Ausgeführten Softwareupdate-Konfigurationscomputer zurück.
Other Status Codes	ErrorResponse	Automatisierungsfehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

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

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:: 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

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:: 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"
}

Definitionen

Name	Beschreibung
ErrorResponse	Fehlerantwort eines Vorgangsfehlers
jobNavigation	Konfigurationscomputer für Softwareupdates führt Auftragsnavigationseigenschaften aus.
softwareUpdateConfigurationMachineRun	Computerausführungsmodell für Softwareupdate-Konfigurationscomputer.
softwareUpdateConfigurationMachineRunListResult	Ergebnis der Auflistung aller Softwareupdate-Konfigurationscomputerausführungen
updateConfigurationNavigation	Softwareupdate-Konfiguration: Ausführen des Navigationsmodells.

ErrorResponse

Objekt

Fehlerantwort eines Vorgangsfehlers

Name	Typ	Beschreibung
code	string	Fehlercode
message	string	Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

jobNavigation

Objekt

Konfigurationscomputer für Softwareupdates führt Auftragsnavigationseigenschaften aus.

Name	Typ	Beschreibung
id	string	ID des Auftrags, der der Softwareupdatekonfiguration zugeordnet ist

softwareUpdateConfigurationMachineRun

Objekt

Computerausführungsmodell für Softwareupdate-Konfigurationscomputer.

Name	Typ	Beschreibung
id	string	Ressourcen-ID des Ausgeführten Softwareupdate-Konfigurationscomputers
name	string	Name des Ausgeführten Softwareupdate-Konfigurationscomputers
properties.configuredDuration	string	konfigurierte Dauer für die Ausführung der Softwareupdatekonfiguration.
properties.correlationId	string (uuid)	Korrelations-ID des Ausgeführten Softwareupdate-Konfigurationscomputers
properties.createdBy	string	createdBy-Eigenschaft, die nur in der Antwort angezeigt wird.
properties.creationTime	string (date-time)	Erstellungszeit der Ressource, die nur in der Antwort angezeigt wird.
properties.endTime	string (date-time)	Endzeit des Softwareupdate-Konfigurationscomputers.
properties.error	ErrorResponse	Details des Bereitstellungsfehlers
properties.job	jobNavigation	Auftrag, der dem Computer für softwareupdate-Konfigurationscomputer zugeordnet ist
properties.lastModifiedBy	string	lastModifiedBy-Eigenschaft, die nur in der Antwort angezeigt wird.
properties.lastModifiedTime	string (date-time)	Letzte Änderung der Ressource, die nur in der Antwort angezeigt wird.
properties.osType	string	Das Betriebssystemziel der Softwareupdatekonfiguration hat diese Ausführung ausgelöst.
properties.softwareUpdateConfiguration	updateConfigurationNavigation	Die Softwareupdatekonfiguration hat diese Ausführung ausgelöst.
properties.sourceComputerId	string (uuid)	Quellcomputer-ID des Ausgeführten Softwareupdate-Konfigurationscomputers
properties.startTime	string (date-time)	Startzeit des Softwareupdate-Konfigurationscomputers.
properties.status	string	Status des Softwareupdate-Konfigurationscomputers ausgeführt.
properties.targetComputer	string	Name des aktualisierten Computers
properties.targetComputerType	string	Typ des aktualisierten Computers.

softwareUpdateConfigurationMachineRunListResult

Objekt

Ergebnis der Auflistung aller Softwareupdate-Konfigurationscomputerausführungen

Name	Typ	Beschreibung
nextLink	string	Link zur nächsten Seite mit Ergebnissen.
value	softwareUpdateConfigurationMachineRun[]	outer object returned when listing all software update configuration machine runs

updateConfigurationNavigation

Objekt

Softwareupdate-Konfiguration: Ausführen des Navigationsmodells.

Name	Typ	Beschreibung
name	string	Der Name der Softwareupdatekonfiguration hat die Ausführung der Softwareupdatekonfiguration ausgelöst.

Freigeben über

Software Update Configuration Machine Runs - List

URI-Parameter

Anforderungsheader

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

List software update configuration machine runs

Beispielanforderung

Beispiel für eine Antwort

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

Beispielanforderung

Beispiel für eine Antwort

Definitionen

ErrorResponse

jobNavigation

softwareUpdateConfigurationMachineRun

softwareUpdateConfigurationMachineRunListResult

updateConfigurationNavigation

Zusätzliche Ressourcen