Software Update Configuration Machine Runs - Get By Id

Referenz

Dienst:: Automation

API-Version:: 2023-11-01

Rufen Sie einen einzelnen Softwareupdatekonfigurationscomputer ab, der nach ID ausgeführt wird.

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

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-Muster: `^[-\w\._]+$`
softwareUpdateConfigurationMachineRunId	path	True	string uuid	Die ID des Ausgeführten Softwareupdatekonfigurationscomputers.
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.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
clientRequestId		string	Identifiziert diese spezifische Clientanforderung.

Antworten

Name	Typ	Beschreibung
200 OK	softwareUpdateConfigurationMachineRun	Ein einzelner Softwareupdatekonfigurationscomputer wird ausgeführt.
Other Status Codes	ErrorResponse	Automatisierungsfehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

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

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

Get software update configuration machine run

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:: 200

{
  "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"
  }
}

Definitionen

Name	Beschreibung
ErrorResponse	Fehlerantwort eines Vorgangsfehlers
jobNavigation	Softwareupdatekonfigurationscomputer führen Auftragsnavigationseigenschaften aus.
softwareUpdateConfigurationMachineRun	Softwareupdatekonfigurations-Computerausführungsmodell.
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.

updateConfigurationNavigation

Softwareupdatekonfiguration Navigationsmodell ausführen.

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

Freigeben über