Software Update Configuration Machine Runs - Get By Id

Reference

Service:: Automation

API Version:: 2023-11-01

Get a single software update configuration machine run by Id.

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

URI Parameters

Name	In	Required	Type	Description
automationAccountName	path	True	string	The name of the automation account.
resourceGroupName	path	True	string	Name of an Azure Resource group. Regex pattern: `^[-\w\._]+$`
softwareUpdateConfigurationMachineRunId	path	True	string uuid	The Id of the software update configuration machine run.
subscriptionId	path	True	string	Gets subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call.
api-version	query	True	string	Client Api Version.

Request Header

Name	Required	Type	Description
clientRequestId		string	Identifies this specific client request.

Responses

Name	Type	Description
200 OK	softwareUpdateConfigurationMachineRun	A single software update configuration machine run.
Other Status Codes	ErrorResponse	Automation error response describing why the operation failed.

Security

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name	Description
user_impersonation	impersonate your user account

Examples

Get software update configuration machine run

Sample Request

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

Sample Response

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

Definitions

Name	Description
ErrorResponse	Error response of an operation failure
jobNavigation	Software update configuration machine run job navigation properties.
softwareUpdateConfigurationMachineRun	Software update configuration machine run model.
updateConfigurationNavigation	Software update configuration Run Navigation model.

ErrorResponse

Error response of an operation failure

Name	Type	Description
code	string	Error code
message	string	Error message indicating why the operation failed.

jobNavigation

Software update configuration machine run job navigation properties.

Name	Type	Description
id	string	Id of the job associated with the software update configuration run

softwareUpdateConfigurationMachineRun

Software update configuration machine run model.

Name	Type	Description
id	string	Resource Id of the software update configuration machine run
name	string	Name of the software update configuration machine run
properties.configuredDuration	string	configured duration for the software update configuration run.
properties.correlationId	string	correlation id of the software update configuration machine run
properties.createdBy	string	createdBy property, which only appears in the response.
properties.creationTime	string	Creation time of the resource, which only appears in the response.
properties.endTime	string	End time of the software update configuration machine run.
properties.error	ErrorResponse	Details of provisioning error
properties.job	jobNavigation	Job associated with the software update configuration machine run
properties.lastModifiedBy	string	lastModifiedBy property, which only appears in the response.
properties.lastModifiedTime	string	Last time resource was modified, which only appears in the response.
properties.osType	string	Operating system target of the software update configuration triggered this run
properties.softwareUpdateConfiguration	updateConfigurationNavigation	software update configuration triggered this run
properties.sourceComputerId	string	source computer id of the software update configuration machine run
properties.startTime	string	Start time of the software update configuration machine run.
properties.status	string	Status of the software update configuration machine run.
properties.targetComputer	string	name of the updated computer
properties.targetComputerType	string	type of the updated computer.

updateConfigurationNavigation

Software update configuration Run Navigation model.

Name	Type	Description
name	string	Name of the software update configuration triggered the software update configuration run