Condividi tramite


Software Update Configurations - List

Ottenere tutte le configurazioni di aggiornamento software per l'account.

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}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
automationAccountName
path True

string

Nome dell'account di automazione.

resourceGroupName
path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._]+$

Nome di un gruppo di risorse di Azure.

subscriptionId
path True

string

Ottiene le credenziali di sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata al servizio.

api-version
query True

string

Versione dell'API client.

$filter
query

string

Filtro da applicare all'operazione.

Intestazione della richiesta

Nome Necessario Tipo Descrizione
clientRequestId

string

Identifica questa richiesta client specifica.

Risposte

Nome Tipo Descrizione
200 OK

softwareUpdateConfigurationListResult

Restituisce l'elenco delle configurazioni degli aggiornamenti software.

Other Status Codes

ErrorResponse

Risposta di errore di automazione che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

List software update configurations
List software update configurations Targeting a specific azure virtual machine

List software update configurations

Esempio di richiesta

GET https://management.azure.com/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurations?api-version=2019-06-01

Risposta di esempio

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

Esempio di richiesta

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')

Risposta di esempio

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

Definizioni

Nome Descrizione
AzureQueryProperties

Query di Azure per la configurazione dell'aggiornamento.

ErrorResponse

Risposta di errore di un errore dell'operazione

LinuxProperties

Configurazione dell'aggiornamento specifica di Linux.

LinuxUpdateClasses

Classificazioni degli aggiornamenti incluse nella configurazione degli aggiornamenti software.

NonAzureQueryProperties

Query non di Azure per la configurazione dell'aggiornamento.

OperatingSystemType

sistema operativo dei computer di destinazione

ScheduleFrequency

Ottiene o imposta la frequenza della pianificazione.

softwareUpdateConfigurationCollectionItem

Proprietà degli elementi della raccolta di configurazione degli aggiornamenti software.

softwareUpdateConfigurationListResult

risultato dell'elenco di tutte le configurazioni degli aggiornamenti software

softwareUpdateConfigurationTasks

Proprietà dell'attività della configurazione dell'aggiornamento software.

TagOperators

Filtrare le macchine virtuali in base a qualsiasi o a tutti i tag specificati.

TagSettingsProperties

Informazioni sul filtro dei tag per la macchina virtuale.

TargetProperties

Gruppo specifico della configurazione dell'aggiornamento.

taskProperties

Proprietà dell'attività della configurazione dell'aggiornamento software.

updateConfiguration

Aggiornare proprietà specifiche della configurazione dell'aggiornamento software.

WindowsProperties

Configurazione dell'aggiornamento specifica di Windows.

WindowsUpdateClasses

Classificazione degli aggiornamenti inclusa nella configurazione degli aggiornamenti software. Stringa delimitata da virgole con valori obbligatori

AzureQueryProperties

Query di Azure per la configurazione dell'aggiornamento.

Nome Tipo Descrizione
locations

string[]

Elenco di posizioni in cui definire l'ambito della query.

scope

string[]

Elenco di ID ARM di sottoscrizione o gruppo di risorse.

tagSettings

TagSettingsProperties

Impostazioni dei tag per la macchina virtuale.

ErrorResponse

Risposta di errore di un errore dell'operazione

Nome Tipo Descrizione
code

string

Codice di errore

message

string

Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.

LinuxProperties

Configurazione dell'aggiornamento specifica di Linux.

Nome Tipo Descrizione
excludedPackageNameMasks

string[]

pacchetti esclusi dalla configurazione dell'aggiornamento software.

includedPackageClassifications

LinuxUpdateClasses

Classificazioni degli aggiornamenti incluse nella configurazione degli aggiornamenti software.

includedPackageNameMasks

string[]

pacchetti inclusi nella configurazione dell'aggiornamento software.

rebootSetting

string

Impostazione di riavvio per la configurazione dell'aggiornamento software.

LinuxUpdateClasses

Classificazioni degli aggiornamenti incluse nella configurazione degli aggiornamenti software.

Valore Descrizione
Critical
Other
Security
Unclassified

NonAzureQueryProperties

Query non di Azure per la configurazione dell'aggiornamento.

Nome Tipo Descrizione
functionAlias

string

Nome della ricerca salvata in Log Analytics.

workspaceId

string

ID area di lavoro per Log Analytics in cui risiede la ricerca salvata.

OperatingSystemType

sistema operativo dei computer di destinazione

Valore Descrizione
Linux
Windows

ScheduleFrequency

Ottiene o imposta la frequenza della pianificazione.

Valore Descrizione
Day
Hour
Minute

L'intervallo minimo consentito per le pianificazioni dei minuti è di 15 minuti.

Month
OneTime
Week

softwareUpdateConfigurationCollectionItem

Proprietà degli elementi della raccolta di configurazione degli aggiornamenti software.

Nome Tipo Descrizione
id

string

ID risorsa della configurazione dell'aggiornamento software

name

string

Nome della configurazione dell'aggiornamento software.

properties.creationTime

string (date-time)

Ora di creazione della configurazione dell'aggiornamento software, che viene visualizzata solo nella risposta.

properties.frequency

ScheduleFrequency

frequenza di esecuzione della pianificazione associata alla configurazione dell'aggiornamento software

properties.lastModifiedTime

string (date-time)

Ora dell'ultima modifica della configurazione dell'aggiornamento software, visualizzata solo nella risposta.

properties.nextRun

string (date-time)

ext run time dell'aggiornamento.

properties.provisioningState

string

Stato di provisioning per la configurazione dell'aggiornamento software, visualizzato solo nella risposta.

properties.startTime

string (date-time)

ora di inizio dell'aggiornamento.

properties.tasks

softwareUpdateConfigurationTasks

Attività predefinite e successive definite

properties.updateConfiguration

updateConfiguration

Aggiornare proprietà specifiche della configurazione dell'aggiornamento software.

softwareUpdateConfigurationListResult

risultato dell'elenco di tutte le configurazioni degli aggiornamenti software

Nome Tipo Descrizione
value

softwareUpdateConfigurationCollectionItem[]

oggetto esterno restituito quando si elencano tutte le configurazioni di aggiornamento software

softwareUpdateConfigurationTasks

Proprietà dell'attività della configurazione dell'aggiornamento software.

Nome Tipo Descrizione
postTask

taskProperties

Pubblicare le proprietà dell'attività.

preTask

taskProperties

Proprietà pre-attività.

TagOperators

Filtrare le macchine virtuali in base a qualsiasi o a tutti i tag specificati.

Valore Descrizione
All
Any

TagSettingsProperties

Informazioni sul filtro dei tag per la macchina virtuale.

Nome Tipo Descrizione
filterOperator

TagOperators

Filtrare le macchine virtuali in base a qualsiasi o a tutti i tag specificati.

tags

object

Dizionario dei tag con il relativo elenco di valori.

TargetProperties

Gruppo specifico della configurazione dell'aggiornamento.

Nome Tipo Descrizione
azureQueries

AzureQueryProperties[]

Elenco di query di Azure nella configurazione dell'aggiornamento software.

nonAzureQueries

NonAzureQueryProperties[]

Elenco di query non di Azure nella configurazione dell'aggiornamento software.

taskProperties

Proprietà dell'attività della configurazione dell'aggiornamento software.

Nome Tipo Descrizione
parameters

object

Ottiene o imposta i parametri dell'attività.

source

string

Ottiene o imposta il nome del runbook.

updateConfiguration

Aggiornare proprietà specifiche della configurazione dell'aggiornamento software.

Nome Tipo Descrizione
azureVirtualMachines

string[]

Elenco degli ID risorsa di Azure per le macchine virtuali di Azure di destinazione della configurazione dell'aggiornamento software.

duration

string (duration)

Tempo massimo consentito per l'esecuzione della configurazione dell'aggiornamento software. La durata deve essere specificata usando il formato PT[n]H[n]M[n]S in base a ISO8601

linux

LinuxProperties

Configurazione dell'aggiornamento specifica di Linux.

nonAzureComputerNames

string[]

Elenco dei nomi di computer non azure di destinazione della configurazione dell'aggiornamento software.

operatingSystem

OperatingSystemType

sistema operativo dei computer di destinazione

targets

TargetProperties

Destinazioni di gruppo per la configurazione dell'aggiornamento software.

windows

WindowsProperties

Configurazione dell'aggiornamento specifica di Windows.

WindowsProperties

Configurazione dell'aggiornamento specifica di Windows.

Nome Tipo Descrizione
excludedKbNumbers

string[]

Numeri kb esclusi dalla configurazione dell'aggiornamento software.

includedKbNumbers

string[]

Numeri kb inclusi nella configurazione dell'aggiornamento software.

includedUpdateClassifications

WindowsUpdateClasses

Classificazione degli aggiornamenti inclusa nella configurazione degli aggiornamenti software. Stringa delimitata da virgole con valori obbligatori

rebootSetting

string

Impostazione di riavvio per la configurazione dell'aggiornamento software.

WindowsUpdateClasses

Classificazione degli aggiornamenti inclusa nella configurazione degli aggiornamenti software. Stringa delimitata da virgole con valori obbligatori

Valore Descrizione
Critical
Definition
FeaturePack
Security
ServicePack
Tools
Unclassified
UpdateRollup
Updates