Поделиться через


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

Имя В Обязательно Тип Описание
automationAccountName
path True

string

Имя учетной записи службы автоматизации.

resourceGroupName
path True

string

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

Имя группы ресурсов Azure.

softwareUpdateConfigurationName
path True

string

Имя создаваемой конфигурации обновления программного обеспечения.

subscriptionId
path True

string

Получает учетные данные подписки, которые однозначно определяют подписку Microsoft Azure. Идентификатор подписки входит в состав URI для каждого вызова службы.

api-version
query True

string

Версия клиентского API.

Заголовок запроса

Имя Обязательно Тип Описание
clientRequestId

string

Определяет этот конкретный запрос клиента.

Текст запроса

Имя Обязательно Тип Описание
properties.scheduleInfo True

SUCScheduleProperties

Планирование сведений о конфигурации обновления программного обеспечения

properties.updateConfiguration True

updateConfiguration

обновление определенных свойств конфигурации обновления программного обеспечения

properties.error

ErrorResponse

Сведения об ошибке подготовки

properties.tasks

softwareUpdateConfigurationTasks

Сведения о задачах конфигурации обновления программного обеспечения.

Ответы

Имя Тип Описание
200 OK

softwareUpdateConfiguration

Конфигурация обновления программного обеспечения с тем же именем и свойствами уже существует.

201 Created

softwareUpdateConfiguration

Создается конфигурация обновления программного обеспечения.

Other Status Codes

ErrorResponse

Ответ об ошибке автоматизации, описывающий, почему операция завершилась ошибкой.

Безопасность

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

Определения

Имя Описание
AdvancedSchedule

Свойства создания расширенного расписания.

AdvancedScheduleMonthlyOccurrence

Свойства создания расширенного расписания ежемесячного вхождения.

AzureQueryProperties

Запрос Azure к конфигурации обновления.

ErrorResponse

Ответ на ошибку сбоя операции

LinuxProperties

Конкретная конфигурация обновления Linux.

LinuxUpdateClasses

Классификации обновлений, включенные в конфигурацию обновления программного обеспечения.

NonAzureQueryProperties

Запрос к конфигурации обновления, отличный от Azure.

OperatingSystemType

операционная система целевых компьютеров

ScheduleDay

День возникновения. Должен быть одним из понедельников, вторник, среда, четверг, пятница, суббота, воскресенье.

ScheduleFrequency

Возвращает или задает частоту расписания.

softwareUpdateConfiguration

Свойства конфигурации обновления программного обеспечения.

softwareUpdateConfigurationTasks

Свойства задачи конфигурации обновления программного обеспечения.

SUCScheduleProperties

Определение параметров расписания.

TagOperators

Фильтрация виртуальных машин по любым или всем указанным тегам.

TagSettingsProperties

Сведения о фильтре тегов для виртуальной машины.

TargetProperties

Группа, относясь к конфигурации обновления.

taskProperties

Свойства задачи конфигурации обновления программного обеспечения.

updateConfiguration

Обновите определенные свойства конфигурации обновления программного обеспечения.

WindowsProperties

Определенная конфигурация обновления Windows.

WindowsUpdateClasses

Классификация обновлений, включенная в конфигурацию обновления программного обеспечения. Строка, разделенная запятыми с необходимыми значениями

AdvancedSchedule

Свойства создания расширенного расписания.

Имя Тип Описание
monthDays

integer[] (int32)

Дни месяца, на который должно выполняться задание. Должно быть от 1 до 31.

monthlyOccurrences

AdvancedScheduleMonthlyOccurrence[]

Вхождения дней в течение месяца.

weekDays

string[]

Дни недели, на которые должно выполняться задание.

AdvancedScheduleMonthlyOccurrence

Свойства создания расширенного расписания ежемесячного вхождения.

Имя Тип Описание
day

ScheduleDay

День возникновения. Должен быть одним из понедельников, вторник, среда, четверг, пятница, суббота, воскресенье.

occurrence

integer (int32)

Вхождения недели в течение месяца. Должно быть от 1 до 5

AzureQueryProperties

Запрос Azure к конфигурации обновления.

Имя Тип Описание
locations

string[]

Список расположений для области запроса.

scope

string[]

Список идентификаторов ARM подписки или группы ресурсов.

tagSettings

TagSettingsProperties

Параметры тегов для виртуальной машины.

ErrorResponse

Ответ на ошибку сбоя операции

Имя Тип Описание
code

string

Код ошибки

message

string

Сообщение об ошибке, указывающее, почему операция завершилась ошибкой.

LinuxProperties

Конкретная конфигурация обновления Linux.

Имя Тип Описание
excludedPackageNameMasks

string[]

пакеты, исключенные из конфигурации обновления программного обеспечения.

includedPackageClassifications

LinuxUpdateClasses

Классификации обновлений, включенные в конфигурацию обновления программного обеспечения.

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

ErrorResponse

Сведения об ошибке подготовки

properties.lastModifiedBy

string

Свойство LastModifiedBy, которое отображается только в ответе.

properties.lastModifiedTime

string (date-time)

При последнем изменении ресурса, который отображается только в ответе.

properties.provisioningState

string

Состояние подготовки для конфигурации обновления программного обеспечения, которое отображается только в ответе.

properties.scheduleInfo

SUCScheduleProperties

Планирование сведений о конфигурации обновления программного обеспечения

properties.tasks

softwareUpdateConfigurationTasks

Сведения о задачах конфигурации обновления программного обеспечения.

properties.updateConfiguration

updateConfiguration

обновление определенных свойств конфигурации обновления программного обеспечения

type

string

Тип ресурса

softwareUpdateConfigurationTasks

Свойства задачи конфигурации обновления программного обеспечения.

Имя Тип Описание
postTask

taskProperties

Свойства задачи post.

preTask

taskProperties

Свойства предварительной задачи.

SUCScheduleProperties

Определение параметров расписания.

Имя Тип Default value Описание
advancedSchedule

AdvancedSchedule

Возвращает или задает расширенное расписание.

creationTime

string (date-time)

Возвращает или задает время создания.

description

string

Возвращает или задает описание.

expiryTime

string (date-time)

Возвращает или задает время окончания расписания.

expiryTimeOffsetMinutes

number (double)

Возвращает или задает смещение времени истечения срока действия в минутах.

frequency

ScheduleFrequency

Возвращает или задает частоту расписания.

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

TagOperators

Фильтрация виртуальных машин по любым или всем указанным тегам.

tags

object

Словарь тегов со списком значений.

TargetProperties

Группа, относясь к конфигурации обновления.

Имя Тип Описание
azureQueries

AzureQueryProperties[]

Список запросов Azure в конфигурации обновления программного обеспечения.

nonAzureQueries

NonAzureQueryProperties[]

Список запросов, отличных от Azure, в конфигурации обновления программного обеспечения.

taskProperties

Свойства задачи конфигурации обновления программного обеспечения.

Имя Тип Описание
parameters

object

Возвращает или задает параметры задачи.

source

string

Возвращает или задает имя модуля Runbook.

updateConfiguration

Обновите определенные свойства конфигурации обновления программного обеспечения.

Имя Тип Описание
azureVirtualMachines

string[]

Список идентификаторов ресурсов Azure для виртуальных машин Azure, предназначенных для конфигурации обновления программного обеспечения.

duration

string (duration)

Максимально допустимое время для запуска конфигурации обновления программного обеспечения. Длительность должна быть указана с помощью формата PT[n]H[n]M[n]S в соответствии с ISO8601

linux

LinuxProperties

Конкретная конфигурация обновления Linux.

nonAzureComputerNames

string[]

Список имен компьютеров, отличных от Azure, предназначенных для конфигурации обновления программного обеспечения.

operatingSystem

OperatingSystemType

операционная система целевых компьютеров

targets

TargetProperties

Целевые объекты группы для конфигурации обновления программного обеспечения.

windows

WindowsProperties

Определенная конфигурация обновления Windows.

WindowsProperties

Определенная конфигурация обновления Windows.

Имя Тип Описание
excludedKbNumbers

string[]

Номера базы знаний, исключенные из конфигурации обновления программного обеспечения.

includedKbNumbers

string[]

Номера базы знаний, включенные в конфигурацию обновления программного обеспечения.

includedUpdateClassifications

WindowsUpdateClasses

Классификация обновлений, включенная в конфигурацию обновления программного обеспечения. Строка, разделенная запятыми с необходимыми значениями

rebootSetting

string

Параметр перезагрузки для конфигурации обновления программного обеспечения.

WindowsUpdateClasses

Классификация обновлений, включенная в конфигурацию обновления программного обеспечения. Строка, разделенная запятыми с необходимыми значениями

Значение Описание
Critical
Definition
FeaturePack
Security
ServicePack
Tools
Unclassified
UpdateRollup
Updates