Software Update Configurations - List
Hesap için tüm yazılım güncelleştirme yapılandırmalarını alın.
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 Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
automation
|
path | True |
string |
Otomasyon hesabının adı. |
resource
|
path | True |
string |
Azure Kaynak grubunun adı. Normal ifade deseni: |
subscription
|
path | True |
string |
Microsoft Azure aboneliğini benzersiz olarak tanımlayan abonelik kimlik bilgilerini alır. Abonelik kimliği, her hizmet çağrısı için URI'nin bir parçasını oluşturur. |
api-version
|
query | True |
string |
İstemci Api Sürümü. |
$filter
|
query |
string |
İşlemde uygulanacak filtre. |
İstek Başlığı
Name | Gerekli | Tür | Description |
---|---|---|---|
clientRequestId |
string |
Bu özel istemci isteğini tanımlar. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Yazılım güncelleştirme yapılandırmalarının dönüş listesi. |
|
Other Status Codes |
İşlemin neden başarısız olduğunu açıklayan otomasyon hatası yanıtı. |
Güvenlik
azure_auth
Azure Active Directory OAuth2 Flow
Tür:
oauth2
Akış:
implicit
Yetkilendirme URL’si:
https://login.microsoftonline.com/common/oauth2/authorize
Kapsamlar
Name | Description |
---|---|
user_impersonation | kullanıcı hesabınızın kimliğine bürünme |
Örnekler
List software update configurations |
List software update configurations Targeting a specific azure virtual machine |
List software update configurations
Örnek isteği
Örnek yanıt
{
"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
Örnek isteği
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')
Örnek yanıt
{
"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"
}
}
]
}
Tanımlar
Name | Description |
---|---|
Azure |
Güncelleştirme yapılandırması için Azure sorgusu. |
Error |
İşlem hatasının hata yanıtı |
Linux |
Linux'a özgü güncelleştirme yapılandırması. |
Linux |
Yazılım güncelleştirme yapılandırmasına dahil edilen güncelleştirme sınıflandırmaları. |
Non |
Güncelleştirme yapılandırması için Azure dışı sorgu. |
Operating |
hedef makinelerin işletim sistemi |
Schedule |
Zamanlamanın sıklığını alır veya ayarlar. |
software |
Yazılım güncelleştirmesi yapılandırma koleksiyonu öğesi özellikleri. |
software |
tüm yazılım güncelleştirme yapılandırmasını listelemenin sonucu |
software |
Yazılım güncelleştirme yapılandırmasının görev özellikleri. |
Tag |
VM'leri belirtilen etiketlere veya Tümüne göre filtreleyin. |
Tag |
VM için etiket filtresi bilgileri. |
Target |
Güncelleştirme yapılandırmasına özgü grup. |
task |
Yazılım güncelleştirme yapılandırmasının görev özellikleri. |
update |
Yazılım güncelleştirme yapılandırmasının belirli özelliklerini güncelleştirin. |
Windows |
Windows'a özgü güncelleştirme yapılandırması. |
Windows |
Yazılım güncelleştirme yapılandırmasına dahil edilen güncelleştirme sınıflandırması. Gerekli değerlere sahip virgülle ayrılmış dize |
AzureQueryProperties
Güncelleştirme yapılandırması için Azure sorgusu.
Name | Tür | Description |
---|---|---|
locations |
string[] |
Sorgunun kapsamına almak için konumların listesi. |
scope |
string[] |
Abonelik veya Kaynak Grubu ARM Kimliklerinin listesi. |
tagSettings |
VM için etiket ayarları. |
ErrorResponse
İşlem hatasının hata yanıtı
Name | Tür | Description |
---|---|---|
code |
string |
Hata kodu |
message |
string |
İşlemin neden başarısız olduğunu belirten hata iletisi. |
LinuxProperties
Linux'a özgü güncelleştirme yapılandırması.
Name | Tür | Description |
---|---|---|
excludedPackageNameMasks |
string[] |
yazılım güncelleştirme yapılandırmasının dışında tutulan paketler. |
includedPackageClassifications |
Yazılım güncelleştirme yapılandırmasına dahil edilen güncelleştirme sınıflandırmaları. |
|
includedPackageNameMasks |
string[] |
yazılım güncelleştirme yapılandırmasından dahil edilen paketler. |
rebootSetting |
string |
Yazılım güncelleştirme yapılandırması için yeniden başlatma ayarı. |
LinuxUpdateClasses
Yazılım güncelleştirme yapılandırmasına dahil edilen güncelleştirme sınıflandırmaları.
Name | Tür | Description |
---|---|---|
Critical |
string |
|
Other |
string |
|
Security |
string |
|
Unclassified |
string |
NonAzureQueryProperties
Güncelleştirme yapılandırması için Azure dışı sorgu.
Name | Tür | Description |
---|---|---|
functionAlias |
string |
Log Analytics Kayıtlı Arama adı. |
workspaceId |
string |
Kaydedilen Aramanın bulunduğu Log Analytics çalışma alanı kimliği. |
OperatingSystemType
hedef makinelerin işletim sistemi
Name | Tür | Description |
---|---|---|
Linux |
string |
|
Windows |
string |
ScheduleFrequency
Zamanlamanın sıklığını alır veya ayarlar.
Name | Tür | Description |
---|---|---|
Day |
string |
|
Hour |
string |
|
Minute |
string |
Dakika zamanlamaları için izin verilen en düşük aralık 15 dakikadır. |
Month |
string |
|
OneTime |
string |
|
Week |
string |
softwareUpdateConfigurationCollectionItem
Yazılım güncelleştirmesi yapılandırma koleksiyonu öğesi özellikleri.
Name | Tür | Description |
---|---|---|
id |
string |
Yazılım güncelleştirme yapılandırmasının Kaynak Kimliği |
name |
string |
Yazılım güncelleştirme yapılandırmasının adı. |
properties.creationTime |
string |
Yalnızca yanıtta görünen yazılım güncelleştirme yapılandırması oluşturma zamanı. |
properties.frequency |
yazılım güncelleştirme yapılandırmasıyla ilişkili zamanlamanın yürütme sıklığı |
|
properties.lastModifiedTime |
string |
Yazılım güncelleştirme yapılandırmasının son değiştirildiği zaman, yalnızca yanıtta görünür. |
properties.nextRun |
string |
güncelleştirmenin ext çalışma zamanı. |
properties.provisioningState |
string |
Yalnızca yanıtta görünen yazılım güncelleştirme yapılandırması için sağlama durumu. |
properties.startTime |
string |
güncelleştirmenin başlangıç saati. |
properties.tasks |
Tanımlı Görevleri Önceden ve Deftere Naklettiğinde |
|
properties.updateConfiguration |
Yazılım güncelleştirme yapılandırmasının belirli özelliklerini güncelleştirin. |
softwareUpdateConfigurationListResult
tüm yazılım güncelleştirme yapılandırmasını listelemenin sonucu
Name | Tür | Description |
---|---|---|
value |
tüm yazılım güncelleştirme yapılandırmaları listelenirken döndürülen dış nesne |
softwareUpdateConfigurationTasks
Yazılım güncelleştirme yapılandırmasının görev özellikleri.
Name | Tür | Description |
---|---|---|
postTask |
Posta görevi özellikleri. |
|
preTask |
Görev öncesi özellikleri. |
TagOperators
VM'leri belirtilen etiketlere veya Tümüne göre filtreleyin.
Name | Tür | Description |
---|---|---|
All |
string |
|
Any |
string |
TagSettingsProperties
VM için etiket filtresi bilgileri.
Name | Tür | Description |
---|---|---|
filterOperator |
VM'leri belirtilen etiketlere veya Tümüne göre filtreleyin. |
|
tags |
object |
Değer listesini içeren etiket sözlüğü. |
TargetProperties
Güncelleştirme yapılandırmasına özgü grup.
Name | Tür | Description |
---|---|---|
azureQueries |
Yazılım güncelleştirme yapılandırmasındaki Azure sorgularının listesi. |
|
nonAzureQueries |
Yazılım güncelleştirme yapılandırmasındaki Azure dışı sorguların listesi. |
taskProperties
Yazılım güncelleştirme yapılandırmasının görev özellikleri.
Name | Tür | Description |
---|---|---|
parameters |
object |
Görevin parametrelerini alır veya ayarlar. |
source |
string |
Runbook'un adını alır veya ayarlar. |
updateConfiguration
Yazılım güncelleştirme yapılandırmasının belirli özelliklerini güncelleştirin.
Name | Tür | Description |
---|---|---|
azureVirtualMachines |
string[] |
Yazılım güncelleştirme yapılandırması tarafından hedeflenen azure sanal makineleri için azure kaynak kimliklerinin listesi. |
duration |
string |
Yazılım güncelleştirme yapılandırma çalıştırması için izin verilen en uzun süre. Süre, ISO8601 göre PT[n]H[n]M[n]S biçimi kullanılarak belirtilmelidir |
linux |
Linux'a özgü güncelleştirme yapılandırması. |
|
nonAzureComputerNames |
string[] |
Yazılım güncelleştirme yapılandırması tarafından hedeflenen Azure dışı makinelerin adları listesi. |
operatingSystem |
hedef makinelerin işletim sistemi |
|
targets |
Yazılım güncelleştirme yapılandırması için grup hedefleri. |
|
windows |
Windows'a özgü güncelleştirme yapılandırması. |
WindowsProperties
Windows'a özgü güncelleştirme yapılandırması.
Name | Tür | Description |
---|---|---|
excludedKbNumbers |
string[] |
Yazılım güncelleştirme yapılandırmasının dışında tutulan KB numaraları. |
includedKbNumbers |
string[] |
Yazılım güncelleştirme yapılandırmasından eklenen KB numaraları. |
includedUpdateClassifications |
Yazılım güncelleştirme yapılandırmasına dahil edilen güncelleştirme sınıflandırması. Gerekli değerlere sahip virgülle ayrılmış dize |
|
rebootSetting |
string |
Yazılım güncelleştirme yapılandırması için yeniden başlatma ayarı. |
WindowsUpdateClasses
Yazılım güncelleştirme yapılandırmasına dahil edilen güncelleştirme sınıflandırması. Gerekli değerlere sahip virgülle ayrılmış dize
Name | Tür | Description |
---|---|---|
Critical |
string |
|
Definition |
string |
|
FeaturePack |
string |
|
Security |
string |
|
ServicePack |
string |
|
Tools |
string |
|
Unclassified |
string |
|
UpdateRollup |
string |
|
Updates |
string |