Public Maintenance Configurations - Get

서비스:: Maintenance

API 버전:: 2023-09-01-preview

공용 유지 관리 구성 레코드 가져오기

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/{resourceName}?api-version=2023-09-01-preview

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
resourceName	path	True	string	유지 관리 구성 이름
subscriptionId	path	True	string	Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명입니다. 구독 ID는 모든 서비스 호출에 대한 URI의 일부를 형성합니다.
api-version	query	True	string	클라이언트 요청과 함께 사용할 API의 버전입니다.

응답

Name	형식	Description
200 OK	MaintenanceConfiguration	그래
Other Status Codes	MaintenanceError	BadRequest

예제

PublicMaintenanceConfigurations_GetForResource

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/configuration1?api-version=2023-09-01-preview

샘플 응답

상태 코드:: 200

{
  "id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/configuration1",
  "name": "configuration1",
  "location": "westus2",
  "properties": {
    "namespace": "Microsoft.Maintenance",
    "maintenanceScope": "SQLDB",
    "visibility": "Public",
    "maintenanceWindow": {
      "startDateTime": "2020-04-30 08:00",
      "expirationDateTime": "9999-12-31 00:00",
      "duration": "05:00",
      "timeZone": "Pacific Standard Time",
      "recurEvery": "2Weeks"
    }
  }
}

정의

Name	Description
createdByType	리소스를 만든 ID의 형식입니다.
ErrorDetails	Azure 유지 관리 서비스에서 받은 오류 응답 세부 정보입니다.
InputLinuxParameters	Linux 머신을 패치하기 위한 입력 속성입니다.
InputPatchConfiguration	패치 실행에 대한 입력 구성
InputWindowsParameters	Windows 컴퓨터를 패치하기 위한 입력 속성입니다.
MaintenanceConfiguration	유지 관리 구성 레코드 유형
MaintenanceError	Azure 유지 관리 서비스에서 받은 오류 응답입니다.
MaintenanceScope	구성의 maintenanceScope를 가져오거나 설정합니다.
RebootOptions	패치 작업이 완료된 후 컴퓨터를 다시 부팅할지 여부에 따라 사용자가 정의한 대로 가능한 다시 부팅 기본 설정입니다.
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
Visibility	구성의 표시 여부를 가져오거나 설정합니다. 기본값은 'Custom'입니다.

createdByType

열거형

리소스를 만든 ID의 형식입니다.

값	Description
User
Application
ManagedIdentity
Key

ErrorDetails

Object

Azure 유지 관리 서비스에서 받은 오류 응답 세부 정보입니다.

Name	형식	Description
code	string	서비스 정의 오류 코드입니다. 이 코드는 응답에 지정된 HTTP 오류 코드의 하위 상태로 사용됩니다.
message	string	사람이 읽을 수 있는 오류 표현입니다.

InputLinuxParameters

Object

Linux 머신을 패치하기 위한 입력 속성입니다.

Name	형식	Description
classificationsToInclude	string[]	패치할 패치의 분류 범주입니다. 허용되는 값은 '위험', '보안' 및 '기타'입니다.
packageNameMasksToExclude	string[]	패치를 위해 제외할 패키지 이름입니다.
packageNameMasksToInclude	string[]	패치를 위해 포함할 패키지 이름입니다.

InputPatchConfiguration

Object

패치 실행에 대한 입력 구성

Name	형식	Default value	Description
linuxParameters	InputLinuxParameters		Linux 머신 패치와 관련된 입력 매개 변수입니다. Windows 컴퓨터의 경우 이 속성을 전달하지 마세요.
rebootSetting	RebootOptions	IfRequired	패치 작업이 완료된 후 컴퓨터를 다시 부팅할지 여부에 따라 사용자가 정의한 대로 가능한 다시 부팅 기본 설정입니다.
windowsParameters	InputWindowsParameters		Windows 컴퓨터 패치와 관련된 입력 매개 변수입니다. Linux 컴퓨터의 경우 이 속성을 전달하지 마세요.

InputWindowsParameters

Object

Windows 컴퓨터를 패치하기 위한 입력 속성입니다.

Name	형식	Description
classificationsToInclude	string[]	패치할 패치의 분류 범주입니다. 허용되는 값은 'Critical', 'Security', 'UpdateRollup', 'FeaturePack', 'ServicePack', 'Definition', 'Tools' 및 'Updates'입니다.
excludeKbsRequiringReboot	boolean	다시 부팅해야 하는 패치 제외
kbNumbersToExclude	string[]	패치를 위해 제외할 Windows KBID입니다.
kbNumbersToInclude	string[]	패치를 위해 포함할 Windows KBID입니다.

MaintenanceConfiguration

Object

유지 관리 구성 레코드 유형

Name	형식	Description
id	string	리소스의 정규화된 식별자
location	string	리소스의 위치를 가져오거나 설정합니다.
name	string	리소스의 이름
properties.extensionProperties	object	maintenanceConfiguration의 extensionProperties를 가져오거나 설정합니다.
properties.installPatches	InputPatchConfiguration	패치 실행 작업에 전달할 입력 매개 변수입니다.
properties.maintenanceScope	MaintenanceScope	구성의 maintenanceScope를 가져오거나 설정합니다.
properties.maintenanceWindow.duration	string	유지 관리 기간(HH:mm 형식)입니다. 제공되지 않으면 제공된 유지 관리 범위에 따라 기본값이 사용됩니다. 예: 05:00.
properties.maintenanceWindow.expirationDateTime	string	유지 관리 기간의 유효 만료 날짜(YYYY-MM-DD hh:mm 형식)입니다. 창은 제공된 표준 시간대에 만들어지고 해당 표준 시간대에 따라 일광 절약으로 조정됩니다. 만료 날짜는 이후 날짜로 설정해야 합니다. 제공되지 않으면 최대 날짜/시간 9999-12-31 23:59:59로 설정됩니다.
properties.maintenanceWindow.recurEvery	string	유지 관리 기간이 다시 발생할 것으로 예상되는 속도입니다. 이 비율은 매일, 매주 또는 매월 일정으로 표시될 수 있습니다. 일별 일정은 recurEvery: [Frequency as integer]['Day(s)']]로 형식이 지정됩니다. 빈도가 제공되지 않으면 기본 빈도는 1입니다. 일별 일정 예제는 recurEvery: Day, recurEvery: 3Days입니다. 주간 일정의 형식은 recurEvery: [Frequency as integer]['Week(s)'] [선택적 쉼표로 구분된 평일 목록 월요일-일요일]입니다. 주간 일정 예제는 recurEvery: 3주, recurEvery: 주 토요일, 일요일입니다. 월별 일정의 형식은 [Frequency as integer]['Month(s)'] [쉼표로 구분된 월 목록] 또는 [Frequency as integer]['Month(s)'] [Week of Month (First, Second, Third, Fourth, Last)] [Weekday Monday-Sunday] [Optional Offset(No. of days)]입니다. 오프셋 값은 -6~6(포함) 사이여야 합니다. 월별 일정 예제는 recurEvery: Month, recurEvery: 2Months, recurEvery: Month day23,day24, recurEvery: Month Last Sunday, recurEvery: Month Fourth Monday, recurEvery: Month Last Sunday Offset-3, recurEvery: Month Third Sunday Offset6.
properties.maintenanceWindow.startDateTime	string	유지 관리 기간의 유효 시작 날짜(YYYY-MM-DD hh:mm 형식)입니다. 시작 날짜는 현재 날짜 또는 이후 날짜로 설정할 수 있습니다. 창은 제공된 표준 시간대에 만들어지고 해당 표준 시간대에 따라 일광 절약으로 조정됩니다.
properties.maintenanceWindow.timeZone	string	표준 시간대의 이름입니다. PowerShell에서 [System.TimeZoneInfo]::GetSystemTimeZones()를 실행하여 표준 시간대 목록을 가져올 수 있습니다. 예: 태평양 표준시, UTC, W. 유럽 표준시, 한국 표준시, Cen. 오스트레일리아 표준시.
properties.namespace	string	리소스의 네임스페이스를 가져오거나 설정합니다.
properties.visibility	Visibility	구성의 표시 여부를 가져오거나 설정합니다. 기본값은 'Custom'입니다.
systemData	systemData	createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
tags	object	리소스의 태그를 가져오거나 설정합니다.
type	string	리소스 유형

MaintenanceError

Object

Azure 유지 관리 서비스에서 받은 오류 응답입니다.

Name	형식	Description
error	ErrorDetails	오류 세부 정보

MaintenanceScope

열거형

구성의 maintenanceScope를 가져오거나 설정합니다.

값	Description
Host	이 유지 관리 범위는 Azure 플랫폼 업데이트의 설치를 제어합니다. 즉, 고객 VM을 호스팅하는 물리적 노드의 서비스입니다.
Resource	이 유지 관리 범위는 Azure 리소스의 기본 업데이트 유지 관리를 제어합니다.
OSImage	이 유지 관리 범위는 VM/VMSS에서 os 이미지 설치를 제어합니다.
Extension	이 유지 관리 범위는 VM/VMSS에서 확장 설치를 제어합니다.
InGuestPatch	이 유지 관리 범위는 VM/VMSS에서 Windows 및 Linux 패키지 설치를 제어합니다.
SQLDB	이 유지 관리 범위는 SQL Server 플랫폼 업데이트의 설치를 제어합니다.
SQLManagedInstance	이 유지 관리 범위는 SQL Managed Instance 플랫폼 업데이트의 설치를 제어합니다.

RebootOptions

열거형

패치 작업이 완료된 후 컴퓨터를 다시 부팅할지 여부에 따라 사용자가 정의한 대로 가능한 다시 부팅 기본 설정입니다.

값	Description
IfRequired
Never
Always

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string (date-time)	리소스 만들기의 타임스탬프(UTC)입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string (date-time)	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID의 형식입니다.

Visibility

열거형

구성의 표시 여부를 가져오거나 설정합니다. 기본값은 'Custom'입니다.

값	Description
Custom	권한이 있는 사용자만 볼 수 있습니다.
Public	모든 사용자에게 표시됩니다.

다음을 통해 공유

Public Maintenance Configurations - Get

URI 매개 변수

응답

예제

PublicMaintenanceConfigurations_GetForResource

샘플 요청

샘플 응답

정의

createdByType

ErrorDetails

InputLinuxParameters

InputPatchConfiguration

InputWindowsParameters

MaintenanceConfiguration

MaintenanceError

MaintenanceScope

RebootOptions

systemData

Visibility