Software Update Configurations - List
Alle software-updateconfiguraties voor het account ophalen.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/softwareUpdateConfigurations?api-version=2019-06-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/softwareUpdateConfigurations?api-version=2019-06-01&$filter={$filter}
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
automation
|
path | True |
string |
De naam van het Automation-account. |
resource
|
path | True |
string minLength: 1maxLength: 90 pattern: ^[-\w\._]+$ |
Naam van een Azure-resourcegroep. |
subscription
|
path | True |
string |
Hiermee haalt u abonnementsreferenties op die het Microsoft Azure-abonnement uniek identificeren. De abonnements-id maakt deel uit van de URI voor elke serviceoproep. |
api-version
|
query | True |
string |
Client-API-versie. |
$filter
|
query |
string |
Het filter dat moet worden toegepast op de bewerking. |
Aanvraagkoptekst
Name | Vereist | Type | Description |
---|---|---|---|
clientRequestId |
string |
Identificeert deze specifieke clientaanvraag. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
Retourlijst met software-updateconfiguraties. |
|
Other Status Codes |
Automatiseringsfoutreactie waarin wordt beschreven waarom de bewerking is mislukt. |
Beveiliging
azure_auth
Azure Active Directory OAuth2-stroom
Type:
oauth2
Stroom:
implicit
Autorisatie-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiken
Name | Description |
---|---|
user_impersonation | Uw gebruikersaccount imiteren |
Voorbeelden
List software update configurations |
List software update configurations Targeting a specific azure virtual machine |
List software update configurations
Voorbeeldaanvraag
Voorbeeldrespons
{
"value": [
{
"name": "testpatch-01",
"id": "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/Mo-Resources-WCUS/providers/Microsoft.Automation/automationAccounts/Mo-AAA-WCUS/softwareUpdateConfigurations/testpatch-01",
"properties": {
"updateConfiguration": {
"operatingSystem": "Windows",
"windows": {
"includedUpdateClassifications": "Critical, Security, UpdateRollup, FeaturePack, ServicePack, Definition, Tools, Updates",
"excludedKbNumbers": null
},
"linux": null,
"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/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-01",
"/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-02",
"/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-03"
],
"nonAzureComputerNames": null
},
"tasks": {
"preTask": {
"source": "HelloWorld",
"parameters": {
"COMPUTERNAME": "Computer1"
}
},
"postTask": {
"source": "GetCache",
"parameters": null
}
},
"frequency": "Week",
"startTime": "2017-10-19T12:22:00-07:00",
"creationTime": "2017-10-19T18:54:50.5233333+00:00",
"lastModifiedTime": "2017-10-19T18:54:50.68+00:00",
"provisioningState": "Succeeded",
"nextRun": "2017-10-23T12:22:00-07:00"
}
},
{
"name": "testpatch-02",
"id": "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/Mo-Resources-WCUS/providers/Microsoft.Automation/automationAccounts/Mo-AAA-WCUS/softwareUpdateConfigurations/testpatch-02",
"properties": {
"updateConfiguration": {
"operatingSystem": "Windows",
"windows": {
"includedUpdateClassifications": "Critical, FeaturePack",
"excludedKbNumbers": null
},
"linux": null,
"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": [
"Japan East",
"UK South"
]
}
]
},
"duration": "PT2H30M",
"azureVirtualMachines": [
"/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-04",
"/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-05",
"/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-06"
],
"nonAzureComputerNames": null
},
"tasks": {
"preTask": {
"source": "HelloWorld",
"parameters": {
"COMPUTERNAME": "Computer1"
}
},
"postTask": {
"source": "GetCache",
"parameters": null
}
},
"frequency": "Hour",
"startTime": "2018-05-05T12:26:00-07:00",
"creationTime": "2017-08-11T21:52:02.7733333+00:00",
"lastModifiedTime": "2017-08-11T21:52:22.88+00:00",
"provisioningState": "Succeeded",
"nextRun": "2018-05-05T12:26:00-07:00"
}
}
]
}
List software update configurations Targeting a specific azure virtual machine
Voorbeeldaanvraag
GET https://management.azure.com/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurations?api-version=2019-06-01&$filter=properties/updateConfiguration/azureVirtualMachines/any(m: m eq '/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-01')
Voorbeeldrespons
{
"value": [
{
"name": "testpatch-01",
"id": "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/Mo-Resources-WCUS/providers/Microsoft.Automation/automationAccounts/Mo-AAA-WCUS/softwareUpdateConfigurations/testpatch-01",
"properties": {
"updateConfiguration": {
"operatingSystem": "Windows",
"windows": {
"includedUpdateClassifications": "Critical, Security, UpdateRollup, FeaturePack, ServicePack, Definition, Tools, Updates",
"excludedKbNumbers": null
},
"linux": null,
"duration": "PT2H",
"azureVirtualMachines": [
"/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-01",
"/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-02",
"/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-03"
],
"nonAzureComputerNames": null
},
"tasks": {
"preTask": {
"source": "HelloWorld",
"parameters": {
"COMPUTERNAME": "Computer1"
}
},
"postTask": {
"source": "GetCache",
"parameters": null
}
},
"frequency": "Week",
"startTime": "2017-10-19T12:22:00-07:00",
"creationTime": "2017-10-19T18:54:50.5233333+00:00",
"lastModifiedTime": "2017-10-19T18:54:50.68+00:00",
"provisioningState": "Succeeded",
"nextRun": "2017-10-23T12:22:00-07:00"
}
},
{
"name": "testpatch-02",
"id": "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/Mo-Resources-WCUS/providers/Microsoft.Automation/automationAccounts/Mo-AAA-WCUS/softwareUpdateConfigurations/testpatch-02",
"properties": {
"updateConfiguration": {
"operatingSystem": "Windows",
"windows": {
"includedUpdateClassifications": "Critical, FeaturePack",
"excludedKbNumbers": null
},
"linux": null,
"duration": "PT2H30M",
"azureVirtualMachines": [
"/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-01",
"/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-05",
"/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-06"
],
"nonAzureComputerNames": null
},
"tasks": {
"preTask": {
"source": "HelloWorld",
"parameters": {
"COMPUTERNAME": "Computer1"
}
},
"postTask": {
"source": "GetCache",
"parameters": null
}
},
"frequency": "Hour",
"startTime": "2018-05-05T12:26:00-07:00",
"creationTime": "2017-08-11T21:52:02.7733333+00:00",
"lastModifiedTime": "2017-08-11T21:52:22.88+00:00",
"provisioningState": "Succeeded",
"nextRun": "2018-05-05T12:26:00-07:00"
}
}
]
}
Definities
Name | Description |
---|---|
Azure |
Azure-query voor de updateconfiguratie. |
Error |
Foutreactie van een bewerkingsfout |
Linux |
Linux-specifieke updateconfiguratie. |
Linux |
Updateclassificaties die zijn opgenomen in de configuratie van de software-update. |
Non |
Geen Azure-query voor de updateconfiguratie. |
Operating |
besturingssysteem van doelmachines |
Schedule |
Hiermee haalt u de frequentie van het schema op of stelt u deze in. |
software |
Eigenschappen van configuratieverzamelingsitem voor software-updates. |
software |
resultaat van het weergeven van alle configuratie van software-updates |
software |
Taakeigenschappen van de configuratie van de software-update. |
Tag |
Filter VM's op alle opgegeven tags of alle opgegeven tags. |
Tag |
Labelfilterinformatie voor de VIRTUELE machine. |
Target |
Groep die specifiek is voor de updateconfiguratie. |
task |
Taakeigenschappen van de configuratie van de software-update. |
update |
Werk specifieke eigenschappen van de configuratie van de software-update bij. |
Windows |
Windows-specifieke updateconfiguratie. |
Windows |
Updateclassificatie die is opgenomen in de configuratie van de software-update. Een door komma's gescheiden tekenreeks met vereiste waarden |
AzureQueryProperties
Azure-query voor de updateconfiguratie.
Name | Type | Description |
---|---|---|
locations |
string[] |
Lijst met locaties voor het bereik van de query. |
scope |
string[] |
Lijst met ARM-id's voor abonnement of resourcegroep. |
tagSettings |
Tag-instellingen voor de virtuele machine. |
ErrorResponse
Foutreactie van een bewerkingsfout
Name | Type | Description |
---|---|---|
code |
string |
Foutcode |
message |
string |
Foutbericht dat aangeeft waarom de bewerking is mislukt. |
LinuxProperties
Linux-specifieke updateconfiguratie.
Name | Type | Description |
---|---|---|
excludedPackageNameMasks |
string[] |
pakketten die zijn uitgesloten van de configuratie van de software-update. |
includedPackageClassifications |
Updateclassificaties die zijn opgenomen in de configuratie van de software-update. |
|
includedPackageNameMasks |
string[] |
pakketten die zijn opgenomen in de configuratie van de software-update. |
rebootSetting |
string |
Instelling voor opnieuw opstarten voor de configuratie van de software-update. |
LinuxUpdateClasses
Updateclassificaties die zijn opgenomen in de configuratie van de software-update.
Waarde | Description |
---|---|
Critical | |
Other | |
Security | |
Unclassified |
NonAzureQueryProperties
Geen Azure-query voor de updateconfiguratie.
Name | Type | Description |
---|---|---|
functionAlias |
string |
Naam van opgeslagen zoekopdracht in Log Analytics. |
workspaceId |
string |
Werkruimte-id voor Log Analytics waarin de opgeslagen zoekopdracht is opgeslagen. |
OperatingSystemType
besturingssysteem van doelmachines
Waarde | Description |
---|---|
Linux | |
Windows |
ScheduleFrequency
Hiermee haalt u de frequentie van het schema op of stelt u deze in.
Waarde | Description |
---|---|
Day | |
Hour | |
Minute |
Het minimaal toegestane interval voor minutenschema's is 15 minuten. |
Month | |
OneTime | |
Week |
softwareUpdateConfigurationCollectionItem
Eigenschappen van configuratieverzamelingsitem voor software-updates.
Name | Type | Description |
---|---|---|
id |
string |
Resource-id van de configuratie van de software-update |
name |
string |
Naam van de configuratie van de software-update. |
properties.creationTime |
string (date-time) |
Maaktijd van de configuratie van de software-update, die alleen in het antwoord wordt weergegeven. |
properties.frequency |
uitvoeringsfrequentie van de planning die is gekoppeld aan de configuratie van de software-update |
|
properties.lastModifiedTime |
string (date-time) |
De laatste keer dat de configuratie van software-updates is gewijzigd, wordt deze alleen weergegeven in het antwoord. |
properties.nextRun |
string (date-time) |
ext runtime van de update. |
properties.provisioningState |
string |
Inrichtingsstatus voor de configuratie van de software-update, die alleen in het antwoord wordt weergegeven. |
properties.startTime |
string (date-time) |
de begintijd van de update. |
properties.tasks |
Vooraf en na taken gedefinieerd |
|
properties.updateConfiguration |
Werk specifieke eigenschappen van de configuratie van de software-update bij. |
softwareUpdateConfigurationListResult
resultaat van het weergeven van alle configuratie van software-updates
Name | Type | Description |
---|---|---|
value |
outer object geretourneerd bij het weergeven van alle software-updateconfiguraties |
softwareUpdateConfigurationTasks
Taakeigenschappen van de configuratie van de software-update.
Name | Type | Description |
---|---|---|
postTask |
Eigenschappen van taak posten. |
|
preTask |
Eigenschappen van de pre-taak. |
TagOperators
Filter VM's op alle opgegeven tags of alle opgegeven tags.
Waarde | Description |
---|---|
All | |
Any |
TagSettingsProperties
Labelfilterinformatie voor de VIRTUELE machine.
Name | Type | Description |
---|---|---|
filterOperator |
Filter VM's op alle opgegeven tags of alle opgegeven tags. |
|
tags |
object |
Woordenlijst met tags met de lijst met waarden. |
TargetProperties
Groep die specifiek is voor de updateconfiguratie.
Name | Type | Description |
---|---|---|
azureQueries |
Lijst met Azure-query's in de configuratie van de software-update. |
|
nonAzureQueries |
Lijst met niet-Azure-query's in de configuratie van de software-update. |
taskProperties
Taakeigenschappen van de configuratie van de software-update.
Name | Type | Description |
---|---|---|
parameters |
object |
Hiermee haalt u de parameters van de taak op of stelt u deze in. |
source |
string |
Hiermee haalt u de naam van het runbook op of stelt u deze in. |
updateConfiguration
Werk specifieke eigenschappen van de configuratie van de software-update bij.
Name | Type | Description |
---|---|---|
azureVirtualMachines |
string[] |
Lijst met azure-resource-id's voor virtuele Azure-machines waarop de configuratie van de software-update is gericht. |
duration |
string (duration) |
Maximale tijd die is toegestaan voor de uitvoering van de configuratie van de software-update. De duur moet worden opgegeven met de indeling PT[n]H[n]M[n]S volgens ISO8601 |
linux |
Linux-specifieke updateconfiguratie. |
|
nonAzureComputerNames |
string[] |
Lijst met namen van niet-Azure-machines waarop de configuratie van de software-update is gericht. |
operatingSystem |
besturingssysteem van doelmachines |
|
targets |
Groepsdoelen voor de configuratie van software-updates. |
|
windows |
Windows-specifieke updateconfiguratie. |
WindowsProperties
Windows-specifieke updateconfiguratie.
Name | Type | Description |
---|---|---|
excludedKbNumbers |
string[] |
KB-nummers die zijn uitgesloten van de configuratie van de software-update. |
includedKbNumbers |
string[] |
KB-nummers die zijn opgenomen in de configuratie van de software-update. |
includedUpdateClassifications |
Updateclassificatie die is opgenomen in de configuratie van de software-update. Een door komma's gescheiden tekenreeks met vereiste waarden |
|
rebootSetting |
string |
Instelling voor opnieuw opstarten voor de configuratie van de software-update. |
WindowsUpdateClasses
Updateclassificatie die is opgenomen in de configuratie van de software-update. Een door komma's gescheiden tekenreeks met vereiste waarden
Waarde | Description |
---|---|
Critical | |
Definition | |
FeaturePack | |
Security | |
ServicePack | |
Tools | |
Unclassified | |
UpdateRollup | |
Updates |