다음을 통해 공유


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 매개 변수

Name In(다음 안에) 필수 형식 Description
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 구독을 고유하게 식별하는 구독 자격 증명을 가져옵니다. 구독 ID는 모든 서비스 호출에 대한 URI의 일부를 형성합니다.

api-version
query True

string

클라이언트 API 버전입니다.

요청 헤더

Name 필수 형식 Description
clientRequestId

string

이 특정 클라이언트 요청을 식별합니다.

요청 본문

Name 필수 형식 Description
properties.scheduleInfo True

SUCScheduleProperties

소프트웨어 업데이트 구성에 대한 일정 정보

properties.updateConfiguration True

updateConfiguration

소프트웨어 업데이트 구성에 대한 특정 속성 업데이트

properties.error

ErrorResponse

프로비저닝 오류에 대한 세부 정보

properties.tasks

softwareUpdateConfigurationTasks

소프트웨어 업데이트 구성에 대한 작업 정보입니다.

응답

Name 형식 Description
200 OK

softwareUpdateConfiguration

이름과 속성이 같은 소프트웨어 업데이트 구성이 이미 있습니다.

201 Created

softwareUpdateConfiguration

소프트웨어 업데이트 구성이 만들어집니다.

Other Status Codes

ErrorResponse

작업이 실패한 이유를 설명하는 자동화 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

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

정의

Name Description
AdvancedSchedule

고급 일정 만들기의 속성입니다.

AdvancedScheduleMonthlyOccurrence

매월 발생하는 고급 일정 만들기의 속성입니다.

AzureQueryProperties

업데이트 구성에 대한 Azure 쿼리입니다.

ErrorResponse

작업 실패의 오류 응답

LinuxProperties

Linux 특정 업데이트 구성.

LinuxUpdateClasses

소프트웨어 업데이트 구성에 포함된 업데이트 분류입니다.

NonAzureQueryProperties

업데이트 구성에 대한 비 Azure 쿼리입니다.

OperatingSystemType

대상 컴퓨터의 운영 체제

ScheduleDay

발생일입니다. 월요일, 화요일, 수요일, 목요일, 금요일, 토요일, 일요일 중 하나여야 합니다.

ScheduleFrequency

일정의 빈도를 가져오거나 설정합니다.

softwareUpdateConfiguration

소프트웨어 업데이트 구성 속성입니다.

softwareUpdateConfigurationTasks

소프트웨어 업데이트 구성의 작업 속성입니다.

SUCScheduleProperties

일정 매개 변수의 정의입니다.

TagOperators

지정된 태그를 모두 또는 모두 사용하여 VM을 필터링합니다.

TagSettingsProperties

VM에 대한 태그 필터 정보입니다.

TargetProperties

업데이트 구성과 관련된 그룹입니다.

taskProperties

소프트웨어 업데이트 구성의 작업 속성입니다.

updateConfiguration

소프트웨어 업데이트 구성의 특정 속성을 업데이트합니다.

WindowsProperties

Windows 관련 업데이트 구성입니다.

WindowsUpdateClasses

소프트웨어 업데이트 구성에 포함된 업데이트 분류입니다. 필수 값이 있는 쉼표로 구분된 문자열

AdvancedSchedule

고급 일정 만들기의 속성입니다.

Name 형식 Description
monthDays

integer[] (int32)

작업을 실행해야 하는 월의 일입니다. 1에서 31 사이여야 합니다.

monthlyOccurrences

AdvancedScheduleMonthlyOccurrence[]

한 달 이내의 일 수입니다.

weekDays

string[]

작업이 실행되어야 하는 요일입니다.

AdvancedScheduleMonthlyOccurrence

매월 발생하는 고급 일정 만들기의 속성입니다.

Name 형식 Description
day

ScheduleDay

발생일입니다. 월요일, 화요일, 수요일, 목요일, 금요일, 토요일, 일요일 중 하나여야 합니다.

occurrence

integer (int32)

월 내 주의 발생입니다. 1에서 5 사이여야 합니다.

AzureQueryProperties

업데이트 구성에 대한 Azure 쿼리입니다.

Name 형식 Description
locations

string[]

쿼리 범위를 지정하는 위치 목록입니다.

scope

string[]

구독 또는 리소스 그룹 ARM ID 목록입니다.

tagSettings

TagSettingsProperties

VM에 대한 태그 설정입니다.

ErrorResponse

작업 실패의 오류 응답

Name 형식 Description
code

string

오류 코드

message

string

작업이 실패한 이유를 나타내는 오류 메시지입니다.

LinuxProperties

Linux 특정 업데이트 구성.

Name 형식 Description
excludedPackageNameMasks

string[]

소프트웨어 업데이트 구성에서 제외된 패키지입니다.

includedPackageClassifications

LinuxUpdateClasses

소프트웨어 업데이트 구성에 포함된 업데이트 분류입니다.

includedPackageNameMasks

string[]

소프트웨어 업데이트 구성에 포함된 패키지입니다.

rebootSetting

string

소프트웨어 업데이트 구성에 대한 다시 부팅 설정입니다.

LinuxUpdateClasses

소프트웨어 업데이트 구성에 포함된 업데이트 분류입니다.

Description
Critical
Other
Security
Unclassified

NonAzureQueryProperties

업데이트 구성에 대한 비 Azure 쿼리입니다.

Name 형식 Description
functionAlias

string

Log Analytics 저장된 검색 이름입니다.

workspaceId

string

저장된 검색이 상주하는 Log Analytics의 작업 영역 ID입니다.

OperatingSystemType

대상 컴퓨터의 운영 체제

Description
Linux
Windows

ScheduleDay

발생일입니다. 월요일, 화요일, 수요일, 목요일, 금요일, 토요일, 일요일 중 하나여야 합니다.

Description
Friday
Monday
Saturday
Sunday
Thursday
Tuesday
Wednesday

ScheduleFrequency

일정의 빈도를 가져오거나 설정합니다.

Description
Day
Hour
Minute

분 일정에 허용되는 최소 간격은 15분입니다.

Month
OneTime
Week

softwareUpdateConfiguration

소프트웨어 업데이트 구성 속성입니다.

Name 형식 Description
id

string

리소스 ID입니다.

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

소프트웨어 업데이트 구성의 작업 속성입니다.

Name 형식 Description
postTask

taskProperties

작업 속성을 게시합니다.

preTask

taskProperties

사전 작업 속성입니다.

SUCScheduleProperties

일정 매개 변수의 정의입니다.

Name 형식 Default value Description
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

지정된 태그를 모두 또는 모두 사용하여 VM을 필터링합니다.

Description
All
Any

TagSettingsProperties

VM에 대한 태그 필터 정보입니다.

Name 형식 Description
filterOperator

TagOperators

지정된 태그를 모두 또는 모두 사용하여 VM을 필터링합니다.

tags

object

값 목록이 있는 태그의 사전입니다.

TargetProperties

업데이트 구성과 관련된 그룹입니다.

Name 형식 Description
azureQueries

AzureQueryProperties[]

소프트웨어 업데이트 구성의 Azure 쿼리 목록입니다.

nonAzureQueries

NonAzureQueryProperties[]

소프트웨어 업데이트 구성의 비 Azure 쿼리 목록입니다.

taskProperties

소프트웨어 업데이트 구성의 작업 속성입니다.

Name 형식 Description
parameters

object

작업의 매개 변수를 가져오거나 설정합니다.

source

string

Runbook의 이름을 가져오거나 설정합니다.

updateConfiguration

소프트웨어 업데이트 구성의 특정 속성을 업데이트합니다.

Name 형식 Description
azureVirtualMachines

string[]

소프트웨어 업데이트 구성의 대상이 되는 Azure 가상 머신에 대한 Azure 리소스 ID 목록입니다.

duration

string (duration)

소프트웨어 업데이트 구성 실행에 허용되는 최대 시간입니다. 기간은 ISO8601 따라 PT[n]H[n]M[n]S 형식을 사용하여 지정해야 합니다.

linux

LinuxProperties

Linux 특정 업데이트 구성.

nonAzureComputerNames

string[]

소프트웨어 업데이트 구성의 대상이 되는 비 Azure 머신의 이름 목록입니다.

operatingSystem

OperatingSystemType

대상 컴퓨터의 운영 체제

targets

TargetProperties

소프트웨어 업데이트 구성에 대한 대상을 그룹화합니다.

windows

WindowsProperties

Windows 관련 업데이트 구성입니다.

WindowsProperties

Windows 관련 업데이트 구성입니다.

Name 형식 Description
excludedKbNumbers

string[]

소프트웨어 업데이트 구성에서 제외된 KB 번호입니다.

includedKbNumbers

string[]

소프트웨어 업데이트 구성에 포함된 KB 번호입니다.

includedUpdateClassifications

WindowsUpdateClasses

소프트웨어 업데이트 구성에 포함된 업데이트 분류입니다. 필수 값이 있는 쉼표로 구분된 문자열

rebootSetting

string

소프트웨어 업데이트 구성에 대한 다시 부팅 설정입니다.

WindowsUpdateClasses

소프트웨어 업데이트 구성에 포함된 업데이트 분류입니다. 필수 값이 있는 쉼표로 구분된 문자열

Description
Critical
Definition
FeaturePack
Security
ServicePack
Tools
Unclassified
UpdateRollup
Updates