Software Update Configuration Machine Runs - List

Referenz

Service:: Automation

API Version:: 2023-11-01

Zurückgeben der Softwareupdatekonfigurations-Computerausführungen

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

With optional parameters:

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 Automation-Kontos.
resourceGroupName	path	True	string	Name einer Azure-Ressourcengruppe. Regex pattern: `^[-\w\._]+$`
subscriptionId	path	True	string	Ruft die 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 Sie überspringen, bevor Ergebnisse zurückgegeben 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 eine Liste der Softwareupdatekonfigurationscomputerausführungen zurück.
Other Status Codes	ErrorResponse	Automatisierungsfehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

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

Sample Request

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

Sample Response

Status code:: 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

Sample Request

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

Sample Response

Status code:: 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	Softwareupdatekonfigurationscomputer führen Auftragsnavigationseigenschaften aus.
softwareUpdateConfigurationMachineRun	Softwareupdatekonfigurations-Computerausführungsmodell.
softwareUpdateConfigurationMachineRunListResult	Ergebnis der Auflistung aller Softwareupdatekonfigurationscomputerausführungen
updateConfigurationNavigation	Softwareupdatekonfiguration Navigationsmodell ausführen.

ErrorResponse

Fehlerantwort eines Vorgangsfehlers

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

jobNavigation

Softwareupdatekonfigurationscomputer führen Auftragsnavigationseigenschaften aus.

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

softwareUpdateConfigurationMachineRun

Softwareupdatekonfigurations-Computerausführungsmodell.

Name	Typ	Beschreibung
id	string	Ressourcen-ID der Computerausführung der Softwareupdatekonfiguration
name	string	Name der Computerausführung der Softwareupdatekonfiguration
properties.configuredDuration	string	Konfigurierte Dauer für die Ausführung der Softwareupdatekonfiguration.
properties.correlationId	string	Korrelations-ID der Computerausführung der Softwareupdatekonfiguration
properties.createdBy	string	createdBy-Eigenschaft, die nur in der Antwort angezeigt wird.
properties.creationTime	string	Erstellungszeit der Ressource, die nur in der Antwort angezeigt wird.
properties.endTime	string	Endzeit der Ausführung des Softwareupdatekonfigurationscomputers.
properties.error	ErrorResponse	Details zum Bereitstellungsfehler
properties.job	jobNavigation	Auftrag, der der Computerausführung der Softwareupdatekonfiguration zugeordnet ist
properties.lastModifiedBy	string	lastModifiedBy-Eigenschaft, die nur in der Antwort angezeigt wird.
properties.lastModifiedTime	string	Letzte Änderung der Ressource, die nur in der Antwort angezeigt wird.
properties.osType	string	Betriebssystemziel der Softwareupdatekonfiguration, die diese Ausführung ausgelöst hat
properties.softwareUpdateConfiguration	updateConfigurationNavigation	Diese Ausführung wurde durch die Softwareupdatekonfiguration ausgelöst.
properties.sourceComputerId	string	Quellcomputer-ID der Ausführung des Softwareupdatekonfigurationscomputers
properties.startTime	string	Startzeit der Ausführung des Softwareupdatekonfigurationscomputers.
properties.status	string	Status der Ausführung des Softwareupdatekonfigurationscomputers.
properties.targetComputer	string	Name des aktualisierten Computers
properties.targetComputerType	string	Typ des aktualisierten Computers.

softwareUpdateConfigurationMachineRunListResult

Ergebnis der Auflistung aller Softwareupdatekonfigurationscomputerausführungen

Name	Typ	Beschreibung
nextLink	string	Link zur nächsten Seite der Ergebnisse.
value	softwareUpdateConfigurationMachineRun[]	Äußeres Objekt, das beim Auflisten aller Softwareupdatekonfigurationscomputerausführungen zurückgegeben wird

updateConfigurationNavigation

Softwareupdatekonfiguration Navigationsmodell ausführen.

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

Freigeben über

Software Update Configuration Machine Runs - List

URI-Parameter

Anforderungsheader

Antworten

Sicherheit

azure_auth

Scopes

Beispiele

List software update configuration machine runs

Sample Request

Sample Response

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

Sample Request

Sample Response

Definitionen

ErrorResponse

jobNavigation

softwareUpdateConfigurationMachineRun

softwareUpdateConfigurationMachineRunListResult

updateConfigurationNavigation

Zusätzliche Ressourcen