Software Update Configurations - Create
Создайте новую конфигурацию обновления программного обеспечения с именем, указанным в URI.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/softwareUpdateConfigurations/{softwareUpdateConfigurationName}?api-version=2019-06-01
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
automation
|
path | True |
string |
Имя учетной записи службы автоматизации. |
resource
|
path | True |
string minLength: 1maxLength: 90 pattern: ^[-\w\._]+$ |
Имя группы ресурсов Azure. |
software
|
path | True |
string |
Имя создаваемой конфигурации обновления программного обеспечения. |
subscription
|
path | True |
string |
Получает учетные данные подписки, которые однозначно определяют подписку Microsoft Azure. Идентификатор подписки входит в состав URI для каждого вызова службы. |
api-version
|
query | True |
string |
Версия клиентского API. |
Заголовок запроса
Имя | Обязательно | Тип | Описание |
---|---|---|---|
clientRequestId |
string |
Определяет этот конкретный запрос клиента. |
Текст запроса
Имя | Обязательно | Тип | Описание |
---|---|---|---|
properties.scheduleInfo | True |
Планирование сведений о конфигурации обновления программного обеспечения |
|
properties.updateConfiguration | True |
обновление определенных свойств конфигурации обновления программного обеспечения |
|
properties.error |
Сведения об ошибке подготовки |
||
properties.tasks |
Сведения о задачах конфигурации обновления программного обеспечения. |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
Конфигурация обновления программного обеспечения с тем же именем и свойствами уже существует. |
|
201 Created |
Создается конфигурация обновления программного обеспечения. |
|
Other Status Codes |
Ответ об ошибке автоматизации, описывающий, почему операция завершилась ошибкой. |
Безопасность
azure_auth
Поток OAuth2 Azure Active Directory
Тип:
oauth2
Flow:
implicit
URL-адрес авторизации:
https://login.microsoftonline.com/common/oauth2/authorize
Области
Имя | Описание |
---|---|
user_impersonation | олицетворения учетной записи пользователя |
Примеры
Create software update configuration
Образец запроса
PUT https://management.azure.com/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurations/testpatch?api-version=2019-06-01
{
"properties": {
"updateConfiguration": {
"operatingSystem": "Windows",
"duration": "PT2H0M",
"windows": {
"excludedKbNumbers": [
"168934",
"168973"
],
"includedUpdateClassifications": "Critical",
"rebootSetting": "IfRequired"
},
"azureVirtualMachines": [
"/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-01",
"/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-02",
"/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-03"
],
"nonAzureComputerNames": [
"box1.contoso.com",
"box2.contoso.com"
],
"targets": {
"azureQueries": [
{
"scope": [
"/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources",
"/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067"
],
"tagSettings": {
"tags": {
"tag1": [
"tag1Value1",
"tag1Value2",
"tag1Value3"
],
"tag2": [
"tag2Value1",
"tag2Value2",
"tag2Value3"
]
},
"filterOperator": "All"
},
"locations": [
"Japan East",
"UK South"
]
}
],
"nonAzureQueries": [
{
"functionAlias": "SavedSearch1",
"workspaceId": "WorkspaceId1"
},
{
"functionAlias": "SavedSearch2",
"workspaceId": "WorkspaceId2"
}
]
}
},
"scheduleInfo": {
"frequency": "Hour",
"startTime": "2017-10-19T12:22:57+00:00",
"timeZone": "America/Los_Angeles",
"interval": 1,
"expiryTime": "2018-11-09T11:22:57+00:00",
"advancedSchedule": {
"weekDays": [
"Monday",
"Thursday"
]
}
},
"tasks": {
"preTask": {
"source": "HelloWorld",
"parameters": {
"COMPUTERNAME": "Computer1"
}
},
"postTask": {
"source": "GetCache",
"parameters": null
}
}
}
}
Пример ответа
{
"name": "testpatch",
"id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurations/testpatch",
"properties": {
"updateConfiguration": {
"operatingSystem": "Windows",
"windows": {
"includedUpdateClassifications": "Critical",
"excludedKbNumbers": [
"168934",
"168973"
]
},
"linux": {},
"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": "PT2H",
"azureVirtualMachines": [
"/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-01",
"/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-02",
"/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-03"
],
"nonAzureComputerNames": [
"box1.contoso.com",
"box2.contoso.com"
]
},
"scheduleInfo": {
"description": "",
"startTime": "2017-10-19T12:22:00-07:00",
"startTimeOffsetMinutes": -420,
"expiryTime": "2018-11-09T11:22:00-08:00",
"expiryTimeOffsetMinutes": -480,
"isEnabled": true,
"nextRun": "2017-10-19T12:22:00-07:00",
"nextRunOffsetMinutes": -420,
"interval": 1,
"frequency": "Week",
"creationTime": "2017-10-19T18:54:50.5233333+00:00",
"lastModifiedTime": "2017-10-19T18:54:50.5233333+00:00",
"timeZone": "America/Los_Angeles",
"advancedSchedule": {}
},
"tasks": {
"preTask": {
"source": "HelloWorld",
"parameters": {
"COMPUTERNAME": "Computer1"
}
},
"postTask": {
"source": "GetCache",
"parameters": null
}
},
"provisioningState": "Provisioning",
"error": {},
"creationTime": "2017-10-19T18:54:50.5233333+00:00",
"createdBy": "adam@contoso.com",
"lastModifiedBy": "adam@contoso.com",
"lastModifiedTime": "2017-10-19T18:54:50.68+00:00"
}
}
{
"name": "testpatch",
"id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurations/testpatch",
"properties": {
"updateConfiguration": {
"operatingSystem": "Windows",
"windows": {
"includedUpdateClassifications": "Critical",
"excludedKbNumbers": [
"168934",
"168973"
]
},
"linux": {},
"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": "PT2H",
"azureVirtualMachines": [
"/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-01",
"/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-02",
"/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-03"
],
"nonAzureComputerNames": [
"box1.contoso.com",
"box2.contoso.com"
]
},
"scheduleInfo": {
"description": "",
"startTime": "2017-10-19T12:22:00-07:00",
"startTimeOffsetMinutes": -420,
"expiryTime": "2018-11-09T11:22:00-08:00",
"expiryTimeOffsetMinutes": -480,
"isEnabled": true,
"nextRun": "2017-10-19T12:22:00-07:00",
"nextRunOffsetMinutes": -420,
"interval": 1,
"frequency": "Week",
"creationTime": "2017-10-19T18:54:50.5233333+00:00",
"lastModifiedTime": "2017-10-19T18:54:50.5233333+00:00",
"timeZone": "America/Los_Angeles"
},
"tasks": {
"preTask": {
"source": "HelloWorld",
"parameters": {
"COMPUTERNAME": "Computer1"
}
},
"postTask": {
"source": "GetCache",
"parameters": null
}
},
"provisioningState": "Provisioning",
"error": {},
"creationTime": "2017-10-19T18:54:50.5233333+00:00",
"lastModifiedBy": "",
"lastModifiedTime": "2017-10-19T18:54:50.68+00:00"
}
}
Определения
Имя | Описание |
---|---|
Advanced |
Свойства создания расширенного расписания. |
Advanced |
Свойства создания расширенного расписания ежемесячного вхождения. |
Azure |
Запрос Azure к конфигурации обновления. |
Error |
Ответ на ошибку сбоя операции |
Linux |
Конкретная конфигурация обновления Linux. |
Linux |
Классификации обновлений, включенные в конфигурацию обновления программного обеспечения. |
Non |
Запрос к конфигурации обновления, отличный от Azure. |
Operating |
операционная система целевых компьютеров |
Schedule |
День возникновения. Должен быть одним из понедельников, вторник, среда, четверг, пятница, суббота, воскресенье. |
Schedule |
Возвращает или задает частоту расписания. |
software |
Свойства конфигурации обновления программного обеспечения. |
software |
Свойства задачи конфигурации обновления программного обеспечения. |
SUCSchedule |
Определение параметров расписания. |
Tag |
Фильтрация виртуальных машин по любым или всем указанным тегам. |
Tag |
Сведения о фильтре тегов для виртуальной машины. |
Target |
Группа, относясь к конфигурации обновления. |
task |
Свойства задачи конфигурации обновления программного обеспечения. |
update |
Обновите определенные свойства конфигурации обновления программного обеспечения. |
Windows |
Определенная конфигурация обновления Windows. |
Windows |
Классификация обновлений, включенная в конфигурацию обновления программного обеспечения. Строка, разделенная запятыми с необходимыми значениями |
AdvancedSchedule
Свойства создания расширенного расписания.
Имя | Тип | Описание |
---|---|---|
monthDays |
integer[] (int32) |
Дни месяца, на который должно выполняться задание. Должно быть от 1 до 31. |
monthlyOccurrences |
Вхождения дней в течение месяца. |
|
weekDays |
string[] |
Дни недели, на которые должно выполняться задание. |
AdvancedScheduleMonthlyOccurrence
Свойства создания расширенного расписания ежемесячного вхождения.
Имя | Тип | Описание |
---|---|---|
day |
День возникновения. Должен быть одним из понедельников, вторник, среда, четверг, пятница, суббота, воскресенье. |
|
occurrence |
integer (int32) |
Вхождения недели в течение месяца. Должно быть от 1 до 5 |
AzureQueryProperties
Запрос Azure к конфигурации обновления.
Имя | Тип | Описание |
---|---|---|
locations |
string[] |
Список расположений для области запроса. |
scope |
string[] |
Список идентификаторов ARM подписки или группы ресурсов. |
tagSettings |
Параметры тегов для виртуальной машины. |
ErrorResponse
Ответ на ошибку сбоя операции
Имя | Тип | Описание |
---|---|---|
code |
string |
Код ошибки |
message |
string |
Сообщение об ошибке, указывающее, почему операция завершилась ошибкой. |
LinuxProperties
Конкретная конфигурация обновления Linux.
Имя | Тип | Описание |
---|---|---|
excludedPackageNameMasks |
string[] |
пакеты, исключенные из конфигурации обновления программного обеспечения. |
includedPackageClassifications |
Классификации обновлений, включенные в конфигурацию обновления программного обеспечения. |
|
includedPackageNameMasks |
string[] |
пакеты, включенные в конфигурацию обновления программного обеспечения. |
rebootSetting |
string |
Параметр перезагрузки для конфигурации обновления программного обеспечения. |
LinuxUpdateClasses
Классификации обновлений, включенные в конфигурацию обновления программного обеспечения.
Значение | Описание |
---|---|
Critical | |
Other | |
Security | |
Unclassified |
NonAzureQueryProperties
Запрос к конфигурации обновления, отличный от Azure.
Имя | Тип | Описание |
---|---|---|
functionAlias |
string |
Имя сохраненного поиска Log Analytics. |
workspaceId |
string |
Идентификатор рабочей области для Log Analytics, в котором хранится сохраненный поиск. |
OperatingSystemType
операционная система целевых компьютеров
Значение | Описание |
---|---|
Linux | |
Windows |
ScheduleDay
День возникновения. Должен быть одним из понедельников, вторник, среда, четверг, пятница, суббота, воскресенье.
Значение | Описание |
---|---|
Friday | |
Monday | |
Saturday | |
Sunday | |
Thursday | |
Tuesday | |
Wednesday |
ScheduleFrequency
Возвращает или задает частоту расписания.
Значение | Описание |
---|---|
Day | |
Hour | |
Minute |
Минимальный допустимый интервал для расписаний минут составляет 15 минут. |
Month | |
OneTime | |
Week |
softwareUpdateConfiguration
Свойства конфигурации обновления программного обеспечения.
Имя | Тип | Описание |
---|---|---|
id |
string |
Идентификатор ресурса. |
name |
string |
Имя ресурса. |
properties.createdBy |
string |
Свойство CreatedBy, которое отображается только в ответе. |
properties.creationTime |
string (date-time) |
Время создания ресурса, которое отображается только в ответе. |
properties.error |
Сведения об ошибке подготовки |
|
properties.lastModifiedBy |
string |
Свойство LastModifiedBy, которое отображается только в ответе. |
properties.lastModifiedTime |
string (date-time) |
При последнем изменении ресурса, который отображается только в ответе. |
properties.provisioningState |
string |
Состояние подготовки для конфигурации обновления программного обеспечения, которое отображается только в ответе. |
properties.scheduleInfo |
Планирование сведений о конфигурации обновления программного обеспечения |
|
properties.tasks |
Сведения о задачах конфигурации обновления программного обеспечения. |
|
properties.updateConfiguration |
обновление определенных свойств конфигурации обновления программного обеспечения |
|
type |
string |
Тип ресурса |
softwareUpdateConfigurationTasks
Свойства задачи конфигурации обновления программного обеспечения.
Имя | Тип | Описание |
---|---|---|
postTask |
Свойства задачи post. |
|
preTask |
Свойства предварительной задачи. |
SUCScheduleProperties
Определение параметров расписания.
Имя | Тип | Default value | Описание |
---|---|---|---|
advancedSchedule |
Возвращает или задает расширенное расписание. |
||
creationTime |
string (date-time) |
Возвращает или задает время создания. |
|
description |
string |
Возвращает или задает описание. |
|
expiryTime |
string (date-time) |
Возвращает или задает время окончания расписания. |
|
expiryTimeOffsetMinutes |
number (double) |
Возвращает или задает смещение времени истечения срока действия в минутах. |
|
frequency |
Возвращает или задает частоту расписания. |
||
interval |
integer (int64) |
Возвращает или задает интервал расписания. |
|
isEnabled |
boolean |
False |
Возвращает или задает значение, указывающее, включено ли это расписание. |
lastModifiedTime |
string (date-time) |
Возвращает или задает время последнего изменения. |
|
nextRun |
string (date-time) |
Возвращает или задает следующее время выполнения расписания. |
|
nextRunOffsetMinutes |
number (double) |
Возвращает или задает смещение следующего времени выполнения в минутах. |
|
startTime |
string (date-time) |
Возвращает или задает время начала расписания. |
|
startTimeOffsetMinutes |
number (double) |
Возвращает смещение времени начала в минутах. |
|
timeZone |
string |
Возвращает или задает часовой пояс расписания. |
TagOperators
Фильтрация виртуальных машин по любым или всем указанным тегам.
Значение | Описание |
---|---|
All | |
Any |
TagSettingsProperties
Сведения о фильтре тегов для виртуальной машины.
Имя | Тип | Описание |
---|---|---|
filterOperator |
Фильтрация виртуальных машин по любым или всем указанным тегам. |
|
tags |
object |
Словарь тегов со списком значений. |
TargetProperties
Группа, относясь к конфигурации обновления.
Имя | Тип | Описание |
---|---|---|
azureQueries |
Список запросов Azure в конфигурации обновления программного обеспечения. |
|
nonAzureQueries |
Список запросов, отличных от Azure, в конфигурации обновления программного обеспечения. |
taskProperties
Свойства задачи конфигурации обновления программного обеспечения.
Имя | Тип | Описание |
---|---|---|
parameters |
object |
Возвращает или задает параметры задачи. |
source |
string |
Возвращает или задает имя модуля Runbook. |
updateConfiguration
Обновите определенные свойства конфигурации обновления программного обеспечения.
Имя | Тип | Описание |
---|---|---|
azureVirtualMachines |
string[] |
Список идентификаторов ресурсов Azure для виртуальных машин Azure, предназначенных для конфигурации обновления программного обеспечения. |
duration |
string (duration) |
Максимально допустимое время для запуска конфигурации обновления программного обеспечения. Длительность должна быть указана с помощью формата PT[n]H[n]M[n]S в соответствии с ISO8601 |
linux |
Конкретная конфигурация обновления Linux. |
|
nonAzureComputerNames |
string[] |
Список имен компьютеров, отличных от Azure, предназначенных для конфигурации обновления программного обеспечения. |
operatingSystem |
операционная система целевых компьютеров |
|
targets |
Целевые объекты группы для конфигурации обновления программного обеспечения. |
|
windows |
Определенная конфигурация обновления Windows. |
WindowsProperties
Определенная конфигурация обновления Windows.
Имя | Тип | Описание |
---|---|---|
excludedKbNumbers |
string[] |
Номера базы знаний, исключенные из конфигурации обновления программного обеспечения. |
includedKbNumbers |
string[] |
Номера базы знаний, включенные в конфигурацию обновления программного обеспечения. |
includedUpdateClassifications |
Классификация обновлений, включенная в конфигурацию обновления программного обеспечения. Строка, разделенная запятыми с необходимыми значениями |
|
rebootSetting |
string |
Параметр перезагрузки для конфигурации обновления программного обеспечения. |
WindowsUpdateClasses
Классификация обновлений, включенная в конфигурацию обновления программного обеспечения. Строка, разделенная запятыми с необходимыми значениями
Значение | Описание |
---|---|
Critical | |
Definition | |
FeaturePack | |
Security | |
ServicePack | |
Tools | |
Unclassified | |
UpdateRollup | |
Updates |