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 |
---|---|---|---|---|
automation
|
path | True |
string |
O nome da conta de automação. |
resource
|
path | True |
string |
Nome de um grupo de recursos do Azure. Padrão Regex: |
subscription
|
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 |
Retornar lista de configurações de atualização de software. |
|
Other Status Codes |
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
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 |
---|---|
Azure |
Consulta do Azure para a configuração de atualização. |
Error |
Resposta de erro de uma falha de operação |
Linux |
Configuração de atualização específica do Linux. |
Linux |
Atualizar classificações incluídas na configuração de atualização de software. |
Non |
Consulta que não é do Azure para a configuração de atualização. |
Operating |
sistema operacional de computadores de destino |
Schedule |
Obtém ou define a frequência do agendamento. |
software |
Propriedades do item de coleção de configuração de atualização de software. |
software |
resultado da listagem de todas as configurações de atualização de software |
software |
Propriedades da tarefa da configuração de atualização de software. |
Tag |
Filtrar VMs por Qualquer ou Todas as marcas especificadas. |
Tag |
Informações de filtro de marca para a VM. |
Target |
Agrupar específico para a configuração de atualização. |
task |
Propriedades da tarefa da configuração de atualização de software. |
update |
Atualize propriedades específicas da configuração de atualização de software. |
Windows |
Configuração de atualização específica do Windows. |
Windows |
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 |
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 |
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 |
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 |
Pré e Pós-Tarefas definidas |
|
properties.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 |
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 |
Propriedades pós-tarefa. |
|
preTask |
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 |
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 |
Lista de consultas do Azure na configuração de atualização de software. |
|
nonAzureQueries |
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 |
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 |
sistema operacional de computadores de destino |
|
targets |
Destinos de grupo para a configuração de atualização de software. |
|
windows |
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 |
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 |