Compartilhar via


Software Update Configurations - List

Obtenha todas as configurações de atualização de software para a conta.

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}

Parâmetros de URI

Nome Em Obrigatório Tipo Description
automationAccountName
path True

string

O nome da conta de automação.

resourceGroupName
path True

string

Nome de um grupo de recursos do Azure.

Padrão Regex: ^[-\w\._]+$

subscriptionId
path True

string

Obtém as credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço.

api-version
query True

string

Versão da API do cliente.

$filter
query

string

O filtro a ser aplicado na operação.

Cabeçalho da solicitação

Nome Obrigatório Tipo Description
clientRequestId

string

Identifica essa solicitação de cliente específica.

Respostas

Nome Tipo Description
200 OK

softwareUpdateConfigurationListResult

Retornar lista de configurações de atualização de software.

Other Status Codes

ErrorResponse

Resposta de erro de automação que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

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

List software update configurations

Solicitação de exemplo

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

Resposta de exemplo

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

Solicitação de exemplo

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

Resposta de exemplo

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

Definições

Nome Description
AzureQueryProperties

Consulta do Azure para a configuração de atualização.

ErrorResponse

Resposta de erro de uma falha de operação

LinuxProperties

Configuração de atualização específica do Linux.

LinuxUpdateClasses

Atualizar classificações incluídas na configuração de atualização de software.

NonAzureQueryProperties

Consulta que não é do Azure para a configuração de atualização.

OperatingSystemType

sistema operacional de computadores de destino

ScheduleFrequency

Obtém ou define a frequência do agendamento.

softwareUpdateConfigurationCollectionItem

Propriedades do item de coleção de configuração de atualização de software.

softwareUpdateConfigurationListResult

resultado da listagem de todas as configurações de atualização de software

softwareUpdateConfigurationTasks

Propriedades da tarefa da configuração de atualização de software.

TagOperators

Filtrar VMs por Qualquer ou Todas as marcas especificadas.

TagSettingsProperties

Informações de filtro de marca para a VM.

TargetProperties

Agrupar específico para a configuração de atualização.

taskProperties

Propriedades da tarefa da configuração de atualização de software.

updateConfiguration

Atualize propriedades específicas da configuração de atualização de software.

WindowsProperties

Configuração de atualização específica do Windows.

WindowsUpdateClasses

Classificação de atualização incluída na configuração de atualização de software. Uma cadeia de caracteres separada por vírgulas com valores necessários

AzureQueryProperties

Consulta do Azure para a configuração de atualização.

Nome Tipo Description
locations

string[]

Lista de locais para os qual definir o escopo da consulta.

scope

string[]

Lista de IDs arm de assinatura ou grupo de recursos.

tagSettings

TagSettingsProperties

Configurações de marca para a VM.

ErrorResponse

Resposta de erro de uma falha de operação

Nome Tipo Description
code

string

Código do erro

message

string

Mensagem de erro indicando por que a operação falhou.

LinuxProperties

Configuração de atualização específica do Linux.

Nome Tipo Description
excludedPackageNameMasks

string[]

pacotes excluídos da configuração de atualização de software.

includedPackageClassifications

LinuxUpdateClasses

Atualizar classificações incluídas na configuração de atualização de software.

includedPackageNameMasks

string[]

pacotes incluídos na configuração de atualização de software.

rebootSetting

string

Configuração de reinicialização para a configuração de atualização de software.

LinuxUpdateClasses

Atualizar classificações incluídas na configuração de atualização de software.

Nome Tipo Description
Critical

string

Other

string

Security

string

Unclassified

string

NonAzureQueryProperties

Consulta que não é do Azure para a configuração de atualização.

Nome Tipo Description
functionAlias

string

Nome da Pesquisa Salva do Log Analytics.

workspaceId

string

ID do workspace do Log Analytics na qual a Pesquisa salva está resideda.

OperatingSystemType

sistema operacional de computadores de destino

Nome Tipo Description
Linux

string

Windows

string

ScheduleFrequency

Obtém ou define a frequência do agendamento.

Nome Tipo Description
Day

string

Hour

string

Minute

string

O intervalo mínimo permitido para agendamentos de minutos é de 15 minutos.

Month

string

OneTime

string

Week

string

softwareUpdateConfigurationCollectionItem

Propriedades do item de coleção de configuração de atualização de software.

Nome Tipo Description
id

string

ID do recurso da configuração de atualização de software

name

string

Nome da configuração de atualização de software.

properties.creationTime

string

Hora de criação da configuração de atualização de software, que só aparece na resposta.

properties.frequency

ScheduleFrequency

frequência de execução do agendamento associado à configuração de atualização de software

properties.lastModifiedTime

string

Da última vez que a configuração de atualização de software foi modificada, que só aparece na resposta.

properties.nextRun

string

ext tempo de execução da atualização.

properties.provisioningState

string

Estado de provisionamento para a configuração de atualização de software, que aparece apenas na resposta.

properties.startTime

string

a hora de início da atualização.

properties.tasks

softwareUpdateConfigurationTasks

Pré e Pós-Tarefas definidas

properties.updateConfiguration

updateConfiguration

Atualize propriedades específicas da configuração de atualização de software.

softwareUpdateConfigurationListResult

resultado da listagem de todas as configurações de atualização de software

Nome Tipo Description
value

softwareUpdateConfigurationCollectionItem[]

objeto outer retornado ao listar todas as configurações de atualização de software

softwareUpdateConfigurationTasks

Propriedades da tarefa da configuração de atualização de software.

Nome Tipo Description
postTask

taskProperties

Propriedades pós-tarefa.

preTask

taskProperties

Propriedades de pré-tarefa.

TagOperators

Filtrar VMs por Qualquer ou Todas as marcas especificadas.

Nome Tipo Description
All

string

Any

string

TagSettingsProperties

Informações de filtro de marca para a VM.

Nome Tipo Description
filterOperator

TagOperators

Filtrar VMs por Qualquer ou Todas as marcas especificadas.

tags

object

Dicionário de marcas com sua lista de valores.

TargetProperties

Agrupar específico para a configuração de atualização.

Nome Tipo Description
azureQueries

AzureQueryProperties[]

Lista de consultas do Azure na configuração de atualização de software.

nonAzureQueries

NonAzureQueryProperties[]

Lista de consultas que não são do Azure na configuração de atualização de software.

taskProperties

Propriedades da tarefa da configuração de atualização de software.

Nome Tipo Description
parameters

object

Obtém ou define os parâmetros da tarefa.

source

string

Obtém ou define o nome do runbook.

updateConfiguration

Atualize propriedades específicas da configuração de atualização de software.

Nome Tipo Description
azureVirtualMachines

string[]

Lista de IDs de recursos do Azure para máquinas virtuais do Azure direcionadas pela configuração de atualização de software.

duration

string

Tempo máximo permitido para a execução da configuração de atualização de software. A duração precisa ser especificada usando o formato PT[n]H[n]M[n]S de acordo com ISO8601

linux

LinuxProperties

Configuração de atualização específica do Linux.

nonAzureComputerNames

string[]

Lista de nomes de computadores não azure direcionados pela configuração de atualização de software.

operatingSystem

OperatingSystemType

sistema operacional de computadores de destino

targets

TargetProperties

Destinos de grupo para a configuração de atualização de software.

windows

WindowsProperties

Configuração de atualização específica do Windows.

WindowsProperties

Configuração de atualização específica do Windows.

Nome Tipo Description
excludedKbNumbers

string[]

Números de KB excluídos da configuração de atualização de software.

includedKbNumbers

string[]

Números de KB incluídos na configuração de atualização de software.

includedUpdateClassifications

WindowsUpdateClasses

Classificação de atualização incluída na configuração de atualização de software. Uma cadeia de caracteres separada por vírgulas com valores necessários

rebootSetting

string

Configuração de reinicialização para a configuração de atualização de software.

WindowsUpdateClasses

Classificação de atualização incluída na configuração de atualização de software. Uma cadeia de caracteres separada por vírgulas com valores necessários

Nome Tipo Description
Critical

string

Definition

string

FeaturePack

string

Security

string

ServicePack

string

Tools

string

Unclassified

string

UpdateRollup

string

Updates

string