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 |
Naam van een Azure-resourcegroep. Regex-patroon: |
subscription
|
path | True |
string |
Hiermee worden abonnementsreferenties opgehaald waarmee het Microsoft Azure-abonnement uniek wordt geïdentificeerd. De abonnements-id maakt deel uit van de URI voor elke service-aanroep. |
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 |
Retourneert een lijst 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 software-updates. |
Non |
Niet-Azure-query voor de updateconfiguratie. |
Operating |
besturingssysteem van doelmachines |
Schedule |
Hiermee wordt de frequentie van de planning opgehaald of ingesteld. |
software |
Eigenschappen van software-updateconfiguratieverzamelingsitems. |
software |
resultaat van het weergeven van alle software-updateconfiguraties |
software |
Taakeigenschappen van de configuratie van de software-update. |
Tag |
Vm's filteren op alle of alle opgegeven tags. |
Tag |
Informatie over tagfilters voor de VM. |
Target |
Groep die specifiek is voor de updateconfiguratie. |
task |
Taakeigenschappen van de configuratie van de software-update. |
update |
Specifieke eigenschappen van de software-updateconfiguratie bijwerken. |
Windows |
Windows-specifieke updateconfiguratie. |
Windows |
Updateclassificatie opgenomen in de configuratie van software-updates. 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 |
Taginstellingen voor de VM. |
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 software-updates. |
includedPackageClassifications |
Updateclassificaties die zijn opgenomen in de configuratie van software-updates. |
|
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 software-updates.
Name | Type | Description |
---|---|---|
Critical |
string |
|
Other |
string |
|
Security |
string |
|
Unclassified |
string |
NonAzureQueryProperties
Niet-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 zich bevindt. |
OperatingSystemType
besturingssysteem van doelmachines
Name | Type | Description |
---|---|---|
Linux |
string |
|
Windows |
string |
ScheduleFrequency
Hiermee wordt de frequentie van de planning opgehaald of ingesteld.
Name | Type | Description |
---|---|---|
Day |
string |
|
Hour |
string |
|
Minute |
string |
Het minimaal toegestane interval voor minutenschema's is 15 minuten. |
Month |
string |
|
OneTime |
string |
|
Week |
string |
softwareUpdateConfigurationCollectionItem
Eigenschappen van software-updateconfiguratieverzamelingsitems.
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 |
Aanmaaktijd van de software-updateconfiguratie, die alleen wordt weergegeven in het antwoord. |
properties.frequency |
uitvoeringsfrequentie van de planning die is gekoppeld aan de configuratie van de software-update |
|
properties.lastModifiedTime |
string |
De laatste keer dat de configuratie van software-updates is gewijzigd, wordt deze alleen weergegeven in het antwoord. |
properties.nextRun |
string |
ext uitvoeringstijd van de update. |
properties.provisioningState |
string |
Inrichtingsstatus voor de configuratie van de software-update, die alleen wordt weergegeven in het antwoord. |
properties.startTime |
string |
de begintijd van de update. |
properties.tasks |
Taken vooraf en na gedefinieerd |
|
properties.updateConfiguration |
Specifieke eigenschappen van de software-updateconfiguratie bijwerken. |
softwareUpdateConfigurationListResult
resultaat van het weergeven van alle software-updateconfiguraties
Name | Type | Description |
---|---|---|
value |
buitenste object geretourneerd bij het weergeven van alle software-updateconfiguraties |
softwareUpdateConfigurationTasks
Taakeigenschappen van de configuratie van de software-update.
Name | Type | Description |
---|---|---|
postTask |
Eigenschappen van posttaak. |
|
preTask |
Eigenschappen vóór taak. |
TagOperators
Vm's filteren op alle of alle opgegeven tags.
Name | Type | Description |
---|---|---|
All |
string |
|
Any |
string |
TagSettingsProperties
Informatie over tagfilters voor de VM.
Name | Type | Description |
---|---|---|
filterOperator |
Vm's filteren op alle of alle opgegeven tags. |
|
tags |
object |
Woordenlijst met tags met de bijbehorende lijst met waarden. |
TargetProperties
Groep die specifiek is voor de updateconfiguratie.
Name | Type | Description |
---|---|---|
azureQueries |
Lijst met Azure-query's in de configuratie van software-updates. |
|
nonAzureQueries |
Lijst met niet-Azure-query's in de configuratie van software-updates. |
taskProperties
Taakeigenschappen van de configuratie van de software-update.
Name | Type | Description |
---|---|---|
parameters |
object |
Hiermee worden de parameters van de taak opgehaald of ingesteld. |
source |
string |
Hiermee wordt de naam van het runbook opgehaald of ingesteld. |
updateConfiguration
Specifieke eigenschappen van de software-updateconfiguratie bijwerken.
Name | Type | Description |
---|---|---|
azureVirtualMachines |
string[] |
Lijst met azure-resource-id's voor virtuele Azure-machines waarop de software-updateconfiguratie is gericht. |
duration |
string |
Maximale tijd die is toegestaan voor het uitvoeren van de software-updateconfiguratie. De duur moet worden opgegeven met de notatie PT[n]H[n]M[n]S volgens ISO8601 |
linux |
Linux-specifieke updateconfiguratie. |
|
nonAzureComputerNames |
string[] |
Lijst met namen van niet-Azure-machines waarop de software-updateconfiguratie 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 software-updateconfiguratie. |
includedKbNumbers |
string[] |
KB-nummers die zijn opgenomen in de configuratie van de software-update. |
includedUpdateClassifications |
Updateclassificatie opgenomen in de configuratie van software-updates. Een door komma's gescheiden tekenreeks met vereiste waarden |
|
rebootSetting |
string |
Instelling voor opnieuw opstarten voor de configuratie van de software-update. |
WindowsUpdateClasses
Updateclassificatie opgenomen in de configuratie van software-updates. Een door komma's gescheiden tekenreeks met vereiste waarden
Name | Type | Description |
---|---|---|
Critical |
string |
|
Definition |
string |
|
FeaturePack |
string |
|
Security |
string |
|
ServicePack |
string |
|
Tools |
string |
|
Unclassified |
string |
|
UpdateRollup |
string |
|
Updates |
string |