Software Update Configurations - Get By Name

Service:: Automation

API Version:: 2024-10-23

Get a single software update configuration by name.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/softwareUpdateConfigurations/{softwareUpdateConfigurationName}?api-version=2024-10-23

URI Parameters

Name	In	Required	Type	Description
automationAccountName	path	True	string	The name of the automation account.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	Name of an Azure Resource group.
softwareUpdateConfigurationName	path	True	string	The name of the software update configuration to be created.
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	softwareUpdateConfiguration	A single software update configuration.
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 by name

Sample request

HTTP

GET https://management.azure.com/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurations/mypatch?api-version=2024-10-23

Sample response

Status code:: 200

{
  "name": "testpatch",
  "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurations/testpatch",
  "properties": {
    "updateConfiguration": {
      "operatingSystem": "Windows",
      "windows": {
        "includedUpdateClassifications": "Critical",
        "excludedKbNumbers": [
          "168934",
          "168973"
        ]
      },
      "linux": {},
      "targets": {
        "azureQueries": [
          {
            "scope": [
              "/subscriptions/422b6c61-95b0-4213-b3be-7282315df71d/resourceGroups/a-stasku-rg0",
              "/subscriptions/422b6c61-95b0-4213-b3be-7282315df71d"
            ],
            "tagSettings": {
              "tags": {
                "tag1": [
                  "tag1Value1",
                  "tag1Value2"
                ],
                "tag2": [
                  "tag2Value1",
                  "tag2Value2"
                ]
              },
              "filterOperator": "All"
            },
            "locations": null
          }
        ]
      },
      "duration": "PT2H",
      "azureVirtualMachines": [
        "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-01",
        "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-02",
        "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-03"
      ],
      "nonAzureComputerNames": [
        "box1.contoso.com",
        "box2.contoso.com"
      ]
    },
    "scheduleInfo": {
      "description": "",
      "startTime": "2017-10-19T12:22:00-07:00",
      "startTimeOffsetMinutes": -420,
      "expiryTime": "2018-11-09T11:22:00-08:00",
      "expiryTimeOffsetMinutes": -480,
      "isEnabled": true,
      "nextRun": "2017-10-19T12:22:00-07:00",
      "nextRunOffsetMinutes": -420,
      "interval": 1,
      "frequency": "Week",
      "creationTime": "2017-10-19T18:54:50.5233333+00:00",
      "lastModifiedTime": "2017-10-19T18:54:50.5233333+00:00",
      "timeZone": "America/Los_Angeles"
    },
    "tasks": {
      "preTask": {
        "source": "HelloWorld",
        "parameters": {
          "COMPUTERNAME": "Computer1"
        }
      },
      "postTask": {
        "source": "GetCache",
        "parameters": null
      }
    },
    "provisioningState": "Provisioning",
    "createdBy": "eve@contoso.com",
    "error": {},
    "creationTime": "2017-10-19T18:54:50.5233333+00:00",
    "lastModifiedBy": "",
    "lastModifiedTime": "2017-10-19T18:54:50.68+00:00"
  }
}

Definitions

Name	Description
AdvancedSchedule	The properties of the create Advanced Schedule.
AdvancedScheduleMonthlyOccurrence	The properties of the create advanced schedule monthly occurrence.
AzureQueryProperties	Azure query for the update configuration.
ErrorResponse	Error response of an operation failure
LinuxProperties	Linux specific update configuration.
LinuxUpdateClasses	Update classifications included in the software update configuration.
NonAzureQueryProperties	Non Azure query for the update configuration.
OperatingSystemType	operating system of target machines
ScheduleDay	Day of the occurrence. Must be one of monday, tuesday, wednesday, thursday, friday, saturday, sunday.
ScheduleFrequency	Gets or sets the frequency of the schedule.
softwareUpdateConfiguration	Software update configuration properties.
softwareUpdateConfigurationTasks	Task properties of the software update configuration.
SUCScheduleProperties	Definition of schedule parameters.
TagOperators	Filter VMs by Any or All specified tags.
TagSettingsProperties	Tag filter information for the VM.
TargetProperties	Group specific to the update configuration.
taskProperties	Task properties of the software update configuration.
updateConfiguration	Update specific properties of the software update configuration.
WindowsProperties	Windows specific update configuration.
WindowsUpdateClasses	Update classification included in the software update configuration. A comma separated string with required values

AdvancedSchedule

Object

The properties of the create Advanced Schedule.

Name	Type	Description
monthDays	integer[] (int32)	Days of the month that the job should execute on. Must be between 1 and 31.
monthlyOccurrences	AdvancedScheduleMonthlyOccurrence[]	Occurrences of days within a month.
weekDays	string[]	Days of the week that the job should execute on.

AdvancedScheduleMonthlyOccurrence

Object

The properties of the create advanced schedule monthly occurrence.

Name	Type	Description
day	ScheduleDay	Day of the occurrence. Must be one of monday, tuesday, wednesday, thursday, friday, saturday, sunday.
occurrence	integer (int32)	Occurrence of the week within the month. Must be between 1 and 5

AzureQueryProperties

Object

Azure query for the update configuration.

Name	Type	Description
locations	string[]	List of locations to scope the query to.
scope	string[]	List of Subscription or Resource Group ARM Ids.
tagSettings	TagSettingsProperties	Tag settings for the VM.

ErrorResponse

Object

Error response of an operation failure

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

LinuxProperties

Object

Linux specific update configuration.

Name	Type	Description
excludedPackageNameMasks	string[]	packages excluded from the software update configuration.
includedPackageClassifications	LinuxUpdateClasses	Update classifications included in the software update configuration.
includedPackageNameMasks	string[]	packages included from the software update configuration.
rebootSetting	string	Reboot setting for the software update configuration.

LinuxUpdateClasses

Enumeration

Update classifications included in the software update configuration.

Value	Description
Unclassified
Critical
Security
Other

NonAzureQueryProperties

Object

Non Azure query for the update configuration.

Name	Type	Description
functionAlias	string	Log Analytics Saved Search name.
workspaceId	string	Workspace Id for Log Analytics in which the saved Search is resided.

OperatingSystemType

Enumeration

operating system of target machines

Value	Description
Windows
Linux

ScheduleDay

Enumeration

Day of the occurrence. Must be one of monday, tuesday, wednesday, thursday, friday, saturday, sunday.

Value	Description
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday

ScheduleFrequency

Enumeration

Gets or sets the frequency of the schedule.

Value	Description
OneTime
Day
Hour
Week
Month
Minute	The minimum allowed interval for Minute schedules is 15 minutes.