Software Update Configuration Machine Runs - Get By Id

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

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

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