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 |
---|---|---|---|---|
automation
|
path | True |
string |
자동화 계정의 이름입니다. |
resource
|
path | True |
string minLength: 1maxLength: 90 pattern: ^[-\w\._]+$ |
Azure 리소스 그룹의 이름입니다. |
software
|
path | True |
string |
만들 소프트웨어 업데이트 구성의 이름입니다. |
subscription
|
path | True |
string |
Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명을 가져옵니다. 구독 ID는 모든 서비스 호출에 대한 URI의 일부를 형성합니다. |
api-version
|
query | True |
string |
클라이언트 API 버전입니다. |
요청 헤더
Name | 필수 | 형식 | Description |
---|---|---|---|
clientRequestId |
string |
이 특정 클라이언트 요청을 식별합니다. |
요청 본문
Name | 필수 | 형식 | Description |
---|---|---|---|
properties.scheduleInfo | True |
소프트웨어 업데이트 구성에 대한 일정 정보 |
|
properties.updateConfiguration | True |
소프트웨어 업데이트 구성에 대한 특정 속성 업데이트 |
|
properties.error |
프로비저닝 오류에 대한 세부 정보 |
||
properties.tasks |
소프트웨어 업데이트 구성에 대한 작업 정보입니다. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
이름과 속성이 같은 소프트웨어 업데이트 구성이 이미 있습니다. |
|
201 Created |
소프트웨어 업데이트 구성이 만들어집니다. |
|
Other Status Codes |
작업이 실패한 이유를 설명하는 자동화 오류 응답입니다. |
보안
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 |
---|---|
Advanced |
고급 일정 만들기의 속성입니다. |
Advanced |
매월 발생하는 고급 일정 만들기의 속성입니다. |
Azure |
업데이트 구성에 대한 Azure 쿼리입니다. |
Error |
작업 실패의 오류 응답 |
Linux |
Linux 특정 업데이트 구성. |
Linux |
소프트웨어 업데이트 구성에 포함된 업데이트 분류입니다. |
Non |
업데이트 구성에 대한 비 Azure 쿼리입니다. |
Operating |
대상 컴퓨터의 운영 체제 |
Schedule |
발생일입니다. 월요일, 화요일, 수요일, 목요일, 금요일, 토요일, 일요일 중 하나여야 합니다. |
Schedule |
일정의 빈도를 가져오거나 설정합니다. |
software |
소프트웨어 업데이트 구성 속성입니다. |
software |
소프트웨어 업데이트 구성의 작업 속성입니다. |
SUCSchedule |
일정 매개 변수의 정의입니다. |
Tag |
지정된 태그를 모두 또는 모두 사용하여 VM을 필터링합니다. |
Tag |
VM에 대한 태그 필터 정보입니다. |
Target |
업데이트 구성과 관련된 그룹입니다. |
task |
소프트웨어 업데이트 구성의 작업 속성입니다. |
update |
소프트웨어 업데이트 구성의 특정 속성을 업데이트합니다. |
Windows |
Windows 관련 업데이트 구성입니다. |
Windows |
소프트웨어 업데이트 구성에 포함된 업데이트 분류입니다. 필수 값이 있는 쉼표로 구분된 문자열 |
AdvancedSchedule
고급 일정 만들기의 속성입니다.
Name | 형식 | Description |
---|---|---|
monthDays |
integer[] (int32) |
작업을 실행해야 하는 월의 일입니다. 1에서 31 사이여야 합니다. |
monthlyOccurrences |
한 달 이내의 일 수입니다. |
|
weekDays |
string[] |
작업이 실행되어야 하는 요일입니다. |
AdvancedScheduleMonthlyOccurrence
매월 발생하는 고급 일정 만들기의 속성입니다.
Name | 형식 | Description |
---|---|---|
day |
발생일입니다. 월요일, 화요일, 수요일, 목요일, 금요일, 토요일, 일요일 중 하나여야 합니다. |
|
occurrence |
integer (int32) |
월 내 주의 발생입니다. 1에서 5 사이여야 합니다. |
AzureQueryProperties
업데이트 구성에 대한 Azure 쿼리입니다.
Name | 형식 | Description |
---|---|---|
locations |
string[] |
쿼리 범위를 지정하는 위치 목록입니다. |
scope |
string[] |
구독 또는 리소스 그룹 ARM ID 목록입니다. |
tagSettings |
VM에 대한 태그 설정입니다. |
ErrorResponse
작업 실패의 오류 응답
Name | 형식 | Description |
---|---|---|
code |
string |
오류 코드 |
message |
string |
작업이 실패한 이유를 나타내는 오류 메시지입니다. |
LinuxProperties
Linux 특정 업데이트 구성.
Name | 형식 | Description |
---|---|---|
excludedPackageNameMasks |
string[] |
소프트웨어 업데이트 구성에서 제외된 패키지입니다. |
includedPackageClassifications |
소프트웨어 업데이트 구성에 포함된 업데이트 분류입니다. |
|
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 |
프로비저닝 오류에 대한 세부 정보 |
|
properties.lastModifiedBy |
string |
응답에만 나타나는 LastModifiedBy 속성입니다. |
properties.lastModifiedTime |
string (date-time) |
마지막으로 리소스를 수정한 후 응답에만 표시됩니다. |
properties.provisioningState |
string |
응답에만 나타나는 소프트웨어 업데이트 구성에 대한 프로비전 상태입니다. |
properties.scheduleInfo |
소프트웨어 업데이트 구성에 대한 일정 정보 |
|
properties.tasks |
소프트웨어 업데이트 구성에 대한 작업 정보입니다. |
|
properties.updateConfiguration |
소프트웨어 업데이트 구성에 대한 특정 속성 업데이트 |
|
type |
string |
리소스 종류 |
softwareUpdateConfigurationTasks
소프트웨어 업데이트 구성의 작업 속성입니다.
Name | 형식 | Description |
---|---|---|
postTask |
작업 속성을 게시합니다. |
|
preTask |
사전 작업 속성입니다. |
SUCScheduleProperties
일정 매개 변수의 정의입니다.
Name | 형식 | Default value | Description |
---|---|---|---|
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
지정된 태그를 모두 또는 모두 사용하여 VM을 필터링합니다.
값 | Description |
---|---|
All | |
Any |
TagSettingsProperties
VM에 대한 태그 필터 정보입니다.
Name | 형식 | Description |
---|---|---|
filterOperator |
지정된 태그를 모두 또는 모두 사용하여 VM을 필터링합니다. |
|
tags |
object |
값 목록이 있는 태그의 사전입니다. |
TargetProperties
업데이트 구성과 관련된 그룹입니다.
Name | 형식 | Description |
---|---|---|
azureQueries |
소프트웨어 업데이트 구성의 Azure 쿼리 목록입니다. |
|
nonAzureQueries |
소프트웨어 업데이트 구성의 비 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 |
Linux 특정 업데이트 구성. |
|
nonAzureComputerNames |
string[] |
소프트웨어 업데이트 구성의 대상이 되는 비 Azure 머신의 이름 목록입니다. |
operatingSystem |
대상 컴퓨터의 운영 체제 |
|
targets |
소프트웨어 업데이트 구성에 대한 대상을 그룹화합니다. |
|
windows |
Windows 관련 업데이트 구성입니다. |
WindowsProperties
Windows 관련 업데이트 구성입니다.
Name | 형식 | Description |
---|---|---|
excludedKbNumbers |
string[] |
소프트웨어 업데이트 구성에서 제외된 KB 번호입니다. |
includedKbNumbers |
string[] |
소프트웨어 업데이트 구성에 포함된 KB 번호입니다. |
includedUpdateClassifications |
소프트웨어 업데이트 구성에 포함된 업데이트 분류입니다. 필수 값이 있는 쉼표로 구분된 문자열 |
|
rebootSetting |
string |
소프트웨어 업데이트 구성에 대한 다시 부팅 설정입니다. |
WindowsUpdateClasses
소프트웨어 업데이트 구성에 포함된 업데이트 분류입니다. 필수 값이 있는 쉼표로 구분된 문자열
값 | Description |
---|---|
Critical | |
Definition | |
FeaturePack | |
Security | |
ServicePack | |
Tools | |
Unclassified | |
UpdateRollup | |
Updates |