• AWS Systems Manager CloudWatch 대시보드는 2026년 4월 30일 이후에는 더 이상 사용할 수 없습니다. 고객은 Amazon CloudWatch 콘솔을 계속 사용하여 현재와 마찬가지로 Amazon CloudWatch 대시보드를 보고, 생성하고, 관리할 수 있습니다. 자세한 내용은 [Amazon CloudWatch 대시보드 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)를 참조하세요. # AWS Systems Manager Change Calendar AWS Systems Manager의 도구인 Change Calendar를 사용하면 지정한 작업(예: [Systems Manager Automation](systems-manager-automation.md) 런북에서)이 AWS 계정에서 수행되거나 수행되지 않을 때 날짜 및 시간 범위를 설정할 수 있습니다. Change Calendar에서는 이러한 범위를 *이벤트*라고 합니다. Change Calendar 항목을 생성하면 `ChangeCalendar` 유형의 [Systems Manager 문서](documents.md)가 생성됩니다. Change Calendar에서 문서는 [iCalendar 2.0](https://icalendar.org/) 데이터를 일반 텍스트 형식으로 저장합니다. Change Calendar 항목에 추가하는 이벤트는 문서의 일부가 됩니다. Change Calendar를 시작하려면 [Systems Manager 콘솔](https://console.aws.amazon.com//systems-manager/change-calendar)을 엽니다. 탐색 창에서 **Change Calendar**를 선택합니다. Systems Manager 콘솔에서 일정 및 해당 이벤트를 생성할 수 있습니다. 또한 지원되는 서드 파티 일정 공급자가 내보낸 iCalendar(`.ics`) 파일을 가져와 일정에 해당 이벤트를 추가할 수 있습니다. 지원되는 공급자에는 Google 캘린더, Microsoft Outlook, iCloud 캘린더가 있습니다. Change Calendar 항목은 다음 두 가지 유형 중 하나가 될 수 있습니다. **`DEFAULT_OPEN`** 또는 Open by default(기본적으로 열림) 일정 이벤트 중일 때를 제외하고 기본적으로 모든 작업이 실행될 수 있습니다. 이벤트 중 `DEFAULT_OPEN` 일정의 상태가 `CLOSED`이고 이벤트 실행이 차단됩니다. **`DEFAULT_CLOSED`** 또는 Closed by default(기본적으로 닫힘) 일정 이벤트 중일 때를 제외하고 기본적으로 모든 작업이 차단됩니다. 이벤트 중 `DEFAULT_CLOSED` 일정의 상태가 `OPEN`이고 작업 실행이 허용됩니다. 예약된 모든 자동화 워크플로, 유지 관리 기간 및 State Manager 연결이 캘린더에 자동으로 추가되도록 선택할 수 있습니다. 캘린더 표시에서 해당 개별 유형을 모두 제거할 수도 있습니다. ## Change Calendar는 누가 사용해야 하나요? **Change Manager 가용성 변경** AWS Systems Manager Change Manager는 2025년 11월 7일부터 신규 고객에게 더 이상 공개되지 않습니다. Change Manager를 사용하려면 해당 날짜 이전에 가입하세요. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [AWS Systems Manager Change Manager 가용성 변경](https://docs.aws.amazon.com/systems-manager/latest/userguide/change-manager-availability-change.html)을 참조하세요. + 다음과 같은 작업 유형을 수행하는 AWS 고객: + 자동화 런북을 생성하거나 실행합니다. + Change Manager에서 변경 요청을 생성합니다. + 유지 관리 기간을 실행합니다. + State Manager에서 연결을 생성합니다. Automation, Change Manager, Maintenance Windows 및 State Manager는 모두 AWS Systems Manager의 도구입니다. 이러한 도구를 Change Calendar와 통합하여 각각에 연결하는 Change Calendar의 현재 상태에 따라 이러한 작업 유형을 허용하거나 차단할 수 있습니다. + Systems Manager 관리형 노드의 구성을 일관되고 안정적이며 기능적으로 유지할 책임이 있는 관리자. ## Change Calendar의 이점 Change Calendar를 사용하면 다음과 같은 이점이 있습니다. + **적용 전 변경 사항 검토** Change Calendar 항목을 사용하면 환경에 부정적인 영향을 줄 수 있는 변경 사항을 적용하기 전에 검토할 수 있습니다. + **적절한 시간 동안에만 변경 사항 적용** Change Calendar 항목을 사용하면 이벤트 시간 동안 환경을 안정적으로 유지할 수 있습니다. 예를 들어, 컨퍼런스 또는 공개 마케팅 프로모션 기간과 같이 리소스에 대한 수요가 높은 경우 변경을 차단하는 Change Calendar 항목을 생성할 수 있습니다. 일정 항목은 휴가 또는 휴일과 같이 제한된 관리자 지원이 필요한 경우에도 변경을 차단할 수 있습니다. 일정 항목을 사용하여 작업 실패 또는 배포 문제를 해결하는 관리자 지원이 제한된 특정 요일 또는 주를 제외하고 변경을 허용할 수 있습니다. + **일정의 현재 또는 향후 상태 가져오기** Systems Manager `GetCalendarState` API 작업을 실행하여 일정의 현재 상태, 지정된 시간의 상태 또는 일정 상태가 변경되도록 예약된 다음 시간을 표시할 수 있습니다. **참고** `GetCalendarState` API에는 초당 10개 요청의 할당량이 있습니다. Systems Manager 할당량에 대한 자세한 내용은 *Amazon Web Services 일반 참조*의 [Systems Manager 서비스 할당량](https://docs.aws.amazon.com/general/latest/gr/ssm.html#limits_ssm)을 참조하세요. + **EventBridge 지원** 이 Systems Manager 도구는 Amazon EventBridge 규칙에서 *이벤트* 유형으로 지원됩니다. 자세한 내용은 [Amazon EventBridge로 Systems Manager 이벤트 모니터링](monitoring-eventbridge-events.md) 및 [참조: Systems Manager용 Amazon EventBridge 이벤트 패턴 및 유형](reference-eventbridge-events.md) 섹션을 참조하세요. **Topics** + [Change Calendar는 누가 사용해야 하나요?](#systems-manager-change-calendar-who) + [Change Calendar의 이점](#systems-manager-change-calendar-benefits) + [Change Calendar 설정](systems-manager-change-calendar-prereqs.md) + [Change Calendar 작업](systems-manager-change-calendar-working.md) + [Automation 실행서에 Change Calendar 종속성 추가](systems-manager-change-calendar-automations.md) + [Change Calendar 문제 해결](change-calendar-troubleshooting.md) # Change Calendar 설정 AWS Systems Manager의 도구인 Change Calendar를 사용하기 전에 다음을 완료합니다. ## 최신 명령줄 도구 설치 최신 명령줄 도구를 설치하여 일정에 대한 상태 정보를 가져옵니다. | 요구 사항 | 설명 | | --- | --- | | AWS CLI | (옵션) AWS Command Line Interface(AWS CLI)를 사용하여 일정에 대한 상태 정보를 가져오려면 로컬 컴퓨터에 AWS CLI의 최신 릴리스를 설치합니다. CLI를 설치하거나 업그레이드하는 방법에 대한 자세한 내용은 *AWS Command Line Interface 사용 설명서*의 [AWS CLI 설치, 업데이트 및 제거](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html)를 참조하세요. | | AWS Tools for PowerShell | (옵션) Tools for PowerShell을 사용하여 일정에 대한 상태 정보를 가져오려면 로컬 컴퓨터에 Tools for PowerShell의 최신 릴리스를 설치합니다. Tools for PowerShell을 설치하거나 업그레이드하는 방법에 대한 자세한 내용은 *AWS Tools for PowerShell 사용 설명서*의 [AWS Tools for PowerShell 설치](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up.html)를 참조하세요. | ## 권한 설정 사용자, 그룹 또는 역할에 관리자 권한이 할당되어 있는 경우 Change Calendar에 대한 전체 액세스 권한이 있습니다. 관리자 권한이 없는 경우에는 관리자가 사용자, 그룹 또는 역할에 `AmazonSSMFullAccess` 관리형 정책을 할당하거나 필요한 권한을 제공하는 정책을 할당하여 사용자에게 권한을 부여해야 합니다. Change Calendar로 작업하려면 다음과 같은 권한이 필요합니다. **Change Calendar 항목** 항목에서 이벤트 추가하고 제거하는 것을 포함하여 Change Calendar 항목을 생성, 업데이트 또는 삭제하려면 사용자, 그룹 또는 역할에 연결된 정책에서 다음과 같은 작업이 허용되어야 합니다. + `ssm:CreateDocument` + `ssm:DeleteDocument` + `ssm:DescribeDocument` + `ssm:DescribeDocumentPermission` + `ssm:GetCalendar` + `ssm:ListDocuments` + `ssm:ModifyDocumentPermission` + `ssm:PutCalendar` + `ssm:UpdateDocument` + `ssm:UpdateDocumentDefaultVersion` **일정 상태** 일정의 현재 또는 향후 상태에 대한 정보를 가져오려면 사용자, 그룹 또는 역할에 연결된 정책에서 다음과 같은 작업이 허용되어야 합니다. + `ssm:GetCalendarState` **운영 이벤트** 유지 관리 기간, 연결 및 계획된 자동화와 같은 운영 이벤트를 보려면 사용자, 그룹 또는 역할에 연결된 정책에서 다음과 같은 작업이 허용되어야 합니다. + `ssm:DescribeMaintenanceWindows` + `ssm:DescribeMaintenanceWindowExecution` + `ssm:DescribeAutomationExecutions` + `ssm:ListAssociations` **참고** 내 계정이 아닌 다른 계정이 소유한(생성한) Change Calendar 항목은 내 계정과 공유된 경우에도 읽기 전용입니다. 유지 관리 기간, State Manager 연결 및 자동화는 공유되지 않습니다. # Change Calendar 작업 AWS Systems Manager 콘솔을 사용하여 AWS Systems Manager의 도구인 Change Calendar의 항목을 추가, 관리 또는 삭제할 수 있습니다. 또한 소스 일정으로부터 내보낸 iCalendar(`.ics`) 파일을 가져와서 지원되는 서드 파티 일정 공급자로부터 이벤트를 가져올 수도 있습니다. 그리고 `GetCalendarState` API 연산 또는 `get-calendar-state` AWS Command Line Interface(AWS CLI) 명령을 사용하여 특정 시간의 Change Calendar 상태에 대한 정보를 가져올 수 있습니다. **Topics** + [Change Calendar 생성](change-calendar-create.md) + [Change Calendar에서의 이벤트 생성 및 관리](change-calendar-events.md) + [서드 파티 일정으로부터 이벤트 가져오기 및 관리](third-party-events.md) + [Change Calendar 업데이트](change-calendar-update.md) + [Change Calendar 공유](change-calendar-share.md) + [Change Calendar 삭제](change-calendar-delete.md) + [Change Calendar 상태 가져오기](change-calendar-getstate.md) # Change Calendar 생성 AWS Systems Manager의 도구인 Change Calendar에서 항목을 만들면 `text` 형식을 사용하는 Systems Manager 문서(SSM 문서)가 생성됩니다. **Change Calendar를 생성하려면** 1. AWS Systems Manager 콘솔([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/))을 엽니다. 1. 탐색 창에서 **Change Calendar**를 선택합니다. 1. **Create calendar(일정 생성)**를 선택합니다. -또는- **Change Calendar** 홈 페이지가 먼저 열리면 **변경 일정 생성(Create change calendar)**을 선택합니다. 1. **Create calendar(일정 생성)** 페이지의 **Calendar details(일정 세부 정보)**에 일정 항목의 이름을 입력합니다. 일정 항목 이름은 문자, 숫자, 마침표, 대시 및 밑줄을 포함할 수 있습니다. 이름은 일정 항목의 용도를 한눈에 파악할 수 있도록 구체적이어야 합니다. 예를 들면, **support-off-hours**입니다. 일정 항목을 생성한 후에는 이 이름을 업데이트할 수 없습니다. 1. (선택 사항) **설명(Description)**에 일정 항목에 대한 설명을 입력합니다. 1. (선택 사항) **일정 가져오기(Import calendar)** 영역에서 **파일 선택(Choose file)**을 선택하여 서드 파티 일정 공급자로부터 내보낸 iCalendar(`.ics`) 파일을 선택합니다. 파일을 가져오면 일정에 해당 이벤트가 추가됩니다. 지원되는 공급자에는 Google 캘린더, Microsoft Outlook, iCloud 캘린더가 있습니다. 자세한 내용은 [서드 파티 일정 공급자로부터 이벤트 가져오기](change-calendar-import.md) 단원을 참조하십시오. 1. **Calendar type(일정 유형)**에서 다음 중 하나를 선택합니다. + [**기본적으로 열림(Open by default)**] - 일정이 열리고(이벤트가 시작될 때까지 Automation 작업이 실행될 수 있음) 연결된 이벤트 기간 동안에는 닫혀 있습니다. + [**기본적으로 닫힘(Closed by default)**] - 일정이 닫히고(이벤트가 시작될 때까지 Automation 작업이 실행될 수 없음) 연결된 이벤트 기간 동안에는 열려 있습니다. 1. (선택 사항) **변경 관리 이벤트**에서 **일정에 변경 관리 이벤트 추가**를 선택합니다. 이렇게 선택하면 예약된 모든 유지 관리 기간, State Manager 연결, Automation 워크플로 및 Change Manager 변경 요청이 월별 일정 표시에 표시됩니다. **작은 정보** 나중에 일정 표시에서 이러한 이벤트 유형을 영구적으로 제거하려면 일정을 편집하고 이 확인란을 선택 취소한 다음에 **저장**을 선택합니다. 1. **Create calendar(일정 생성)**를 선택합니다. 일정 항목이 생성되면 Systems Manager는 **Change Calendar** 목록에 일정 항목을 표시합니다. 열에는 일정 버전과 일정 소유자의 AWS 계정 번호가 표시됩니다. 일정 항목은 이벤트를 하나 이상 생성하거나 가져올 때까지 작업을 금지하거나 허용할 수 없습니다. 이벤트 생성에 대한 자세한 내용은 [Change Calendar 이벤트 생성](change-calendar-create-event.md) 섹션을 참조하세요. 이벤트 가져오기에 대한 자세한 내용은 [서드 파티 일정 공급자로부터 이벤트 가져오기](change-calendar-import.md) 섹션을 참조하세요. # Change Calendar에서의 이벤트 생성 및 관리 AWS Systems Manager Change Calendar에서 일정을 생성한 후 열려 있거나 닫혀 있는 일정에 포함된 이벤트를 생성, 업데이트 및 삭제할 수 있습니다. Change Calendar는 AWS Systems Manager의 도구입니다. **작은 정보** Systems Manager 콘솔에서 직접 이벤트를 생성하는 대신 지원되는 서드 파티 일정 앱으로부터 iCalendar(`.ics`) 파일을 가져올 수 있습니다. 자세한 내용은 [서드 파티 일정으로부터 이벤트 가져오기 및 관리](third-party-events.md) 섹션을 참조하세요. **Topics** + [Change Calendar 이벤트 생성](change-calendar-create-event.md) + [Change Calendar 이벤트 업데이트](change-calendar-update-event.md) + [Change Calendar 이벤트 삭제](change-calendar-delete-event.md) # Change Calendar 이벤트 생성 AWS Systems Manager의 도구인 Change Calendar의 항목에 이벤트를 추가할 때 일정 항목의 기본 작업이 일시 중지되는 기간을 지정합니다. 예를 들어, 일정 항목 유형이 기본적으로 닫힘인 경우 일정은 이벤트 기간에 변경되도록 열려 있습니다. (또는 일정에서만 정보 제공 역할을 하는 공지 이벤트를 생성할 수 있습니다.) 현재는 콘솔을 사용해야만 Change Calendar 이벤트를 생성할 수 있습니다. Change Calendar 항목 생성 시 생성된 Change Calendar 문서에 이벤트가 추가됩니다. **Change Calendar 이벤트를 생성하려면** 1. AWS Systems Manager 콘솔([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/))을 엽니다. 1. 탐색 창에서 **Change Calendar**를 선택합니다. 1. 일정 목록에서 이벤트를 추가할 일정 항목의 이름을 선택합니다. 1. 일정 항목의 세부 정보 페이지에서 **Create event(이벤트 생성)**를 선택합니다. 1. **Create scheduled event(예약된 이벤트 생성)** 페이지의 **Event details(이벤트 세부 정보)**에서 이벤트의 표시 이름을 입력합니다. 이벤트 이름은 문자, 숫자, 마침표, 대시 및 밑줄을 포함할 수 있습니다. 이름은 이벤트의 용도를 파악할 수 있도록 구체적이어야 합니다. 예를 들면, **nighttime-hours**입니다. 1. **설명(Description)**에 이벤트에 대한 설명을 입력합니다. 예: **The support team isn't available during these hours**. 1. (선택 사항) 이 이벤트가 시각적 알림 또는 미리 알림으로만 제공되도록 하려면 **공지(Advisory)** 확인란을 선택합니다. 공지 이벤트는 일정에서 기능적인 역할을 하지 않습니다. 일정을 보는 사용자에게만 정보를 제공합니다. 1. **이벤트 시작 날짜(Event start date)**에서 이벤트를 시작할 날짜를 `MM/DD/YYYY` 형식으로 입력하거나 선택하고 지정된 날짜에 이벤트를 시작할 시간을 `hh:mm:ss`(시, 분, 초) 형식으로 입력합니다. 1. **이벤트 종료 날짜(Event end date)**에서 이벤트를 종료할 날짜를 `MM/DD/YYYY` 형식으로 입력하거나 선택하고 지정된 날짜에 이벤트를 종료할 시간을 `hh:mm:ss`(시, 분, 초) 형식으로 입력합니다. 1. **예약 시간대(Schedule time zone)**에서 이벤트의 시작 및 종료 시간에 적용할 시간대를 선택합니다. 도시 이름의 일부 또는 그리니치 표준시(GMT)와의 시간대 차이를 입력하여 시간대를 더 빨리 찾을 수 있습니다. 기본값은 협정 세계 표준시(UTC)입니다. 1. (선택 사항) 매일, 매주 또는 매월 반복되는 이벤트를 생성하려면 **반복(Recurrence)**을 설정한 다음 반복 빈도 및 선택적 종료 날짜를 지정합니다. 1. **Create scheduled event(예약된 이벤트 생성)**를 선택합니다. 새 이벤트가 일정 항목에 추가되고 일정 항목의 세부 정보 페이지에 있는 **이벤트** 탭에 표시됩니다. # Change Calendar 이벤트 업데이트 AWS Systems Manager 콘솔에서 Change Calendar 이벤트를 업데이트하려면 다음 절차를 따릅니다. Change Calendar는 AWS Systems Manager의 도구입니다. **Change Calendar 이벤트를 업데이트하려면** 1. AWS Systems Manager 콘솔([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/))을 엽니다. 1. 탐색 창에서 **Change Calendar**를 선택합니다. 1. 일정 목록에서 이벤트를 편집할 일정 항목의 이름을 선택합니다. 1. 일정 항목의 세부 정보 페이지에서 **이벤트**를 선택합니다. 1. 일정 페이지에서 편집할 이벤트를 선택합니다. **작은 정보** 왼쪽 위에 있는 버튼을 사용하여 1년 뒤로 또는 앞으로 이동하거나 한 달 뒤로 또는 앞으로 이동합니다. 필요한 경우 오른쪽 상단의 목록에서 올바른 시간대를 선택하여 시간대를 변경합니다. 1. **이벤트 세부 정보(Event details)**에서 **편집(Edit)**을 선택합니다. 이벤트 이름과 설명을 변경하려면 현재 텍스트 값을 추가하거나 바꿉니다. 1. **이벤트 시작 날짜(Event start date)** 값을 변경하려면 현재 시작 날짜를 선택한 다음 일정에서 새 날짜를 선택합니다. 시작 시간을 변경하려면 현재 시작 시간을 선택한 다음 목록에서 새 시간을 선택합니다. 1. **이벤트 종료 날짜(Event end date)** 값을 변경하려면 현재 날짜를 선택한 다음 일정에서 새 종료 날짜를 선택합니다. 종료 시간을 변경하려면 현재 종료 시간을 선택한 다음 목록에서 새 시간을 선택합니다. 1. **예약 시간대(Schedule time zone)** 값을 변경하려면 이벤트의 시작 및 종료 시간에 적용할 시간대를 선택합니다. 도시 이름의 일부 또는 그리니치 표준시(GMT)와의 시간대 차이를 입력하여 시간대를 더 빨리 찾을 수 있습니다. 기본값은 협정 세계 표준시(UTC)입니다. 1. (선택 사항) 이 이벤트가 시각적 알림 또는 미리 알림으로만 제공되도록 하려면 **공지(Advisory)** 확인란을 선택합니다. 공지 이벤트는 일정에서 기능적인 역할을 하지 않습니다. 일정을 보는 사용자에게만 정보를 제공합니다. 1. **Save**(저장)를 선택합니다. 변경 사항은 일정 항목의 세부 정보 페이지에 있는 **이벤트** 탭에 표시됩니다. 변경 사항을 보려면 업데이트한 이벤트를 선택합니다. # Change Calendar 이벤트 삭제 AWS Management Console을 사용하여 AWS Systems Manager의 도구인 Change Calendar에서 이벤트를 한 번에 하나씩 삭제할 수 있습니다. **작은 정보** 일정을 생성할 때 **일정에 변경 관리 이벤트 추가**를 선택한 경우 다음과 같이 수행할 수 있습니다. 일정 표시에서 변경 관리 이벤트 유형을 **일시적으로 숨기려면 월별 미리 보기 상단에 있는 유형에 **X**를 선택합니다. 일정 표시에서 이러한 유형을 **영구적으로 제거하려면 일정을 편집하고 **일정에 변경 관리 이벤트 추가** 확인란을 선택 취소한 다음에 **저장**을 선택합니다. 유형은 일정 표시에서 제거해도 계정에서는 삭제되지 않습니다. **Change Calendar 이벤트를 삭제하려면** 1. AWS Systems Manager 콘솔([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/))을 엽니다. 1. 탐색 창에서 **Change Calendar**를 선택합니다. 1. 일정 목록에서 이벤트를 삭제할 일정 항목의 이름을 선택합니다. 1. 일정 항목의 세부 정보 페이지에서 **이벤트**를 선택합니다. 1. 일정 페이지에서 삭제할 이벤트를 선택합니다. **작은 정보** 왼쪽 위에 있는 버튼을 사용하여 일정을 1년 뒤로 또는 앞으로 이동하거나 한 달 뒤로 또는 앞으로 이동합니다. 필요한 경우 오른쪽 상단의 목록에서 올바른 시간대를 선택하여 시간대를 변경합니다. 1. **Event details(이벤트 세부 정보)** 페이지에서 **삭제**를 선택합니다. 이벤트를 삭제할지 확인하는 메시지가 표시되면 **확인(Confirm)**을 선택합니다. # 서드 파티 일정으로부터 이벤트 가져오기 및 관리 AWS Systems Manager 콘솔에서 직접 이벤트를 생성하는 대신 지원되는 서드 파티 일정 앱으로부터 iCalendar(`.ics`) 파일을 가져올 수 있습니다. 일정에는 가져온 이벤트와 사용자가 AWS Systems Manager의 도구인 Change Calendar에서 생성한 이벤트가 모두 포함될 수 있습니다. **시작하기 전 준비 사항** 일정 파일을 가져오려고 시도하기 전에 다음 요구 사항 및 제약 조건을 검토하세요. 일정 파일 형식 유효한 iCalendar 파일(`.ics`)만 지원합니다. 지원되는 일정 공급자 다음 서드 파티 일정 공급자에서 내보낸 `.ics` 파일만 지원됩니다. + Google 캘린더([내보내기 지침](https://support.google.com/calendar/answer/37111)) + Microsoft Outlook([내보내기 지침](https://support.microsoft.com/en-us/office/export-an-outlook-calendar-to-google-calendar-662fa3bb-0794-4b18-add8-9968b665f4e6)) + iCloud 캘린더([내보내기 지침](https://support.apple.com/guide/calendar/import-or-export-calendars-icl1023/mac)) 파일 크기 유효한 `.ics` 파일 수만큼 가져올 수 있습니다. 그러나 각 일정에 대해 가져온 모든 파일의 총 크기는 64KB를 초과할 수 없습니다. `.ics` 파일의 크기를 최소화하기 위해, 일정 항목에 대한 기본 세부 정보만 내보내고 있는지 확인합니다. 필요한 경우 내보내는 시간 간격의 길이를 줄입니다. 시간대 내보낸 `.ics` 파일에는 일정 이름, 일정 공급자 및 하나 이상의 이벤트 외에 일정의 시간대도 표시되어야 합니다. 그렇지 않거나 표준 시간대를 식별하는 데 문제가 있는 경우 해당 파일을 가져온 후 표준 시간대를 지정하라는 메시지가 표시됩니다. 반복 이벤트 제한 사용자가 내보낸 `.ics` 파일에는 반복 이벤트가 포함될 수 있습니다. 그러나 소스 일정에서 반복 이벤트가 하나 이상 삭제된 경우 가져오기 작업이 실패합니다. **Topics** + [서드 파티 일정 공급자로부터 이벤트 가져오기](change-calendar-import.md) + [서드 파티 일정 공급자의 모든 이벤트 업데이트](change-calendar-import-add-remove.md) + [서드 파티 일정에서 가져온 모든 이벤트 삭제](change-calendar-delete-ics.md) # 서드 파티 일정 공급자로부터 이벤트 가져오기 지원되는 서드 파티 일정 앱의 iCalendar(`.ics`) 파일을 가져오려면 다음 절차를 따릅니다. 파일에 포함된 이벤트는 열려 있거나 닫혀 있는 일정의 규칙에 통합됩니다. Change Calendar(AWS Systems Manager의 도구)를 사용하여 생성하고 있는 새 일정으로 파일을 가져오거나 기존 일정으로 가져올 수 있습니다. `.ics` 파일을 가져온 후 Change Calendar 인터페이스를 사용하여 개별 이벤트를 삭제할 수 있습니다. 자세한 내용은 [Change Calendar 이벤트 삭제](change-calendar-delete-event.md) 섹션을 참조하세요. 또한 `.ics` 파일을 삭제하여 소스 일정의 모든 이벤트를 삭제할 수도 있습니다. 자세한 내용은 [서드 파티 일정에서 가져온 모든 이벤트 삭제](change-calendar-delete-ics.md) 섹션을 참조하세요. **서드 파티 일정 공급자로부터 이벤트를 가져오려면** 1. [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)에서 AWS Systems Manager 콘솔을 엽니다. 1. 탐색 창에서 **Change Calendar**를 선택합니다. 1. 새 일정으로 시작하려면 **일정 생성(Create calendar)**을 선택합니다. **일정 가져오기(Import calendar)** 영역에서 **파일 선택(Choose file)**을 선택합니다. 새 일정을 생성하는 다른 단계에 대한 자세한 내용은 [Change Calendar 생성](change-calendar-create.md) 섹션을 참조하세요. -또는- 서드 파티 이벤트를 기존 일정으로 가져오려면 기존 일정의 이름을 선택하여 엽니다. 1. **작업, 편집(Actions, Edit)**을 선택한 다음 **일정 가져오기(Import calendar)** 영역에서 **파일 선택(Choose file)**을 선택합니다. 1. 로컬 컴퓨터에서 내보낸 `.ics` 파일로 이동하고 선택합니다. 1. 메시지가 나타나면 **표준 시간대 선택(Select a time zone)**에서 일정에 적용할 시간대를 선택합니다. 1. **저장**을 선택합니다. # 서드 파티 일정 공급자의 모든 이벤트 업데이트 iCalendar `.ics` 파일을 가져온 후 소스 일정에 여러 이벤트가 추가되거나 제거된 경우 이러한 변경 사항을 Change Calendar에 반영할 수 있습니다. 먼저 소스 일정을 다시 내보낸 다음 새 파일을 Change Calendar로 가져옵니다. 이는 AWS Systems Manager의 도구입니다. Change Calendar의 이벤트는 최신 파일의 내용을 반영하도록 업데이트됩니다. **서드 파티 일정 공급자의 모든 이벤트를 업데이트하려면** 1. 서드 파티 일정에서 Change Calendar에 반영할 이벤트를 추가하거나 제거합니다. 그런 다음 해당 일정을 새 `.ics` 파일로 다시 내보냅니다. 1. [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)에서 AWS Systems Manager 콘솔을 엽니다. 1. 탐색 창에서 **Change Calendar**를 선택합니다. 1. 일정 목록에서 일정 이름을 선택합니다. 1. **파일 선택**을 선택하고, 대체 `.ics` 파일로 이동하고 선택합니다. 1. 기존 파일 덮어쓰기에 대한 알림이 뜨면 **확인(Confirm)**을 선택합니다. # 서드 파티 일정에서 가져온 모든 이벤트 삭제 서드 파티 공급자로부터 가져온 이벤트를 더 이상 일정에 포함시키지 않으려면, 가져온 iCalendar `.ics` 파일을 삭제할 수 있습니다. **서드 파티 일정에서 가져온 모든 이벤트를 삭제하려면** 1. [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)에서 AWS Systems Manager 콘솔을 엽니다. 1. 탐색 창에서 **Change Calendar**를 선택합니다. 1. 일정 목록에서 일정 이름을 선택합니다. 1. **일정 가져오기(Import calendar)** 영역의 **가져온 일정(My imported calendars)**에서, 가져온 일정의 이름을 찾은 다음 **X**를 선택합니다. 1. **저장**을 선택합니다. # Change Calendar 업데이트 Change Calendar에 대한 설명은 업데이트할 수 있지만 이름은 업데이트할 수 없습니다. 일정의 기본 상태를 변경할 수 있지만 이 경우 일정과 연결된 이벤트 기간에 변경 작업의 동작이 반대로 수행됩니다. 예를 들어 일정의 상태를 [**기본적으로 열림(Open by default)**]에서 [**기본적으로 닫힘(Closed by default)**]으로 변경하면 연결된 이벤트를 생성한 사용자가 변경을 기대하지 않는 이벤트 기간에 원치 않은 변경이 발생할 수 있습니다. Change Calendar를 업데이트할 때, 해당 항목을 생성할 때 생성한 Change Calendar 문서를 편집합니다. Change Calendar는 AWS Systems Manager의 도구입니다. **Change Calendar를 업데이트하려면** 1. AWS Systems Manager 콘솔([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/))을 엽니다. 1. 탐색 창에서 **Change Calendar**를 선택합니다. 1. 일정 목록에서 업데이트할 일정의 이름을 선택합니다. 1. 일정의 세부 정보 페이지에서 **작업, 편집(Actions, Edit)**을 선택합니다. 1. **설명**에서 설명 텍스트를 변경할 수 있습니다. Change Calendar의 이름은 편집할 수 없습니다. 1. 일정 상태를 변경하려면 **Calendar type(일정 유형)**에서 다른 값을 선택합니다. 이 경우 일정과 연결된 이벤트 기간에 변경 작업의 동작이 반대로 수행됩니다. 일정 유형을 변경하기 전에 일정 유형을 변경해도 사용자가 생성한 이벤트 기간에 원치 않는 변경이 허용되지 않음을 다른 Change Calendar 사용자와 함께 확인해야 합니다. + **기본적으로 열림(Open by default)** - 일정이 열리고(이벤트가 시작될 때까지 Automation 작업이 실행될 수 있음) 연결된 이벤트 기간 동안에는 닫혀 있습니다. + **기본적으로 닫힘(Closed by default)** - 일정이 닫히고(이벤트가 시작될 때까지 Automation 작업이 실행될 수 없음) 연결된 이벤트 기간 동안에는 열려 있습니다. 1. **Save**(저장)를 선택합니다. 일정은 이벤트를 하나 이상 추가할 때까지 작업을 금지하거나 허용할 수 없습니다. 이벤트를 추가하는 방법에 대한 자세한 내용은 [Change Calendar 이벤트 생성](change-calendar-create-event.md) 섹션을 참조하세요. # Change Calendar 공유 AWS Systems Manager 콘솔을 사용하여 AWS Systems Manager의 도구인 Change Calendar에서 Change Calendar를 다른 AWS 계정과 공유할 수 있습니다. 일정을 공유하면 공유 계정의 사용자가 일정을 읽기 전용으로 사용할 수 있습니다. 유지 관리 기간, State Manager 연결 및 자동화는 공유되지 않습니다. **Change Calendar를 공유하려면** 1. AWS Systems Manager 콘솔([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/))을 엽니다. 1. 탐색 창에서 **Change Calendar**를 선택합니다. 1. 일정 목록에서 공유할 일정의 이름을 선택합니다. 1. 일정의 세부 정보 페이지에서 **공유(Sharing)** 탭을 선택합니다. 1. **작업, 공유(Actions, Share)**를 선택합니다. 1. [**일정 공유(Share calendar)**]에서 [**계정 ID(Account ID)**]에 유효한 AWS 계정의 ID 번호를 입력한 다음 [**공유(Share)**]를 선택합니다. 공유 계정의 사용자는 Change Calendar를 읽을 수 있지만 변경할 수는 없습니다. # Change Calendar 삭제 Systems Manager 콘솔 또는 AWS Command Line Interface(AWS CLI)를 사용하여 AWS Systems Manager의 도구인 Change Calendar에서 일정을 삭제할 수 있습니다. Change Calendar를 삭제하면 연결된 모든 이벤트가 삭제됩니다. **Change Calendar를 삭제하려면** 1. AWS Systems Manager 콘솔([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/))을 엽니다. 1. 탐색 창에서 **Change Calendar**를 선택합니다. 1. 일정 목록에서 삭제할 일정의 이름을 선택합니다. 1. 일정의 세부 정보 페이지에서 **작업, 삭제(Actions, Delete)**를 선택합니다. 일정을 삭제할지 확인하는 메시지가 표시되면 **삭제(Delete)**를 선택합니다. # Change Calendar 상태 가져오기 AWS Systems Manager의 도구인 Change Calendar에서 일정의 전체 상태 또는 특정 시간의 일정 상태를 가져올 수 있습니다. 다음에 일정 상태가 `OPEN`에서 `CLOSED`로 또는 그 반대로 변경되는 시간을 표시할 수도 있습니다. **참고** 일정 상태 변경의 자동 모니터링을 위해 Amazon EventBridge에 Change Calendar를 통합하는 방법에 대한 자세한 내용은 [Amazon EventBridge과 Change Calendar 통합](monitoring-systems-manager-event-examples.md#change-calendar-eventbridge-integration) 섹션을 참조하세요. EventBridge 통합을 통해 일정 상태가 전환될 때 이벤트 기반 알림을 제공하여 `GetCalendarState` API 작업의 폴링 기반 접근 방식을 보완합니다. 이 태스크는 `GetCalendarState` API 작업을 사용해야만 수행할 수 있습니다. 이 섹션의 절차에서는 AWS Command Line Interface(AWS CLI)를 사용합니다. **Change Calendar 상태를 가져오려면** + 다음 명령을 실행하여 특정 시간에 하나 이상의 일정에 대한 상태를 표시합니다. `--calendar-names` 파라미터는 필수 사항이지만 `--at-time`은 선택 사항입니다. 각 *example resource placeholder*를 사용자의 정보로 바꿉니다. ------ #### [ Linux & macOS ] ``` aws ssm get-calendar-state \ --calendar-names "Calendar_name_or_document_ARN_1" "Calendar_name_or_document_ARN_2" \ --at-time "ISO_8601_time_format" ``` 다음은 예입니다. ``` aws ssm get-calendar-state \ --calendar-names "arn:aws:ssm:us-east-2:123456789012:document/MyChangeCalendarDocument" "arn:aws:ssm:us-east-2:123456789012:document/SupportOffHours" \ --at-time "2020-07-30T11:05:14-0700" ``` ------ #### [ Windows ] ``` aws ssm get-calendar-state ^ --calendar-names "Calendar_name_or_document_ARN_1" "Calendar_name_or_document_ARN_2" ^ --at-time "ISO_8601_time_format" ``` 다음은 예입니다. ``` aws ssm get-calendar-state ^ --calendar-names "arn:aws:ssm:us-east-2:123456789012:document/MyChangeCalendarDocument" "arn:aws:ssm:us-east-2:123456789012:document/SupportOffHours" ^ --at-time "2020-07-30T11:05:14-0700" ``` ------ 명령은 다음과 같은 정보를 반환합니다. ``` { "State": "OPEN", "AtTime": "2020-07-30T16:18:18Z", "NextTransitionTime": "2020-07-31T00:00:00Z" } ``` 결과는 해당 계정이 소유하거나 공유한 지정된 일정 항목의 일정 상태(일정이 `DEFAULT_OPEN`인지 아니면 `DEFAULT_CLOSED`인지 여부)를 `--at-time` 값으로 지정된 시간과 다음 전환 시간으로 표시합니다. `--at-time` 파라미터를 추가하지 않으면 현재 시간이 사용됩니다. **참고** 요청에 일정을 2개 이상 지정하는 경우 요청의 모든 달력이 열려 있는 경우에만 `OPEN` 상태가 반환됩니다. 요청의 일정이 하나 이상 닫혀 있는 경우 `CLOSED` 상태가 반환됩니다. # Automation 실행서에 Change Calendar 종속성 추가 Automation 작업이 AWS Systems Manager의 도구인 Change Calendar를 준수하도록 하려면 해당 [`aws:assertAwsResourceProperty`](automation-action-assertAwsResourceProperty.md) 작업을 사용하는 Automation 런북에 단계를 추가합니다. `GetCalendarState`를 실행하여 지정된 일정 항목이 원하는 상태(`OPEN` 또는 `CLOSED`)인지 확인하도록 작업을 구성합니다. Automation 실행서는 일정 상태가 `OPEN`인 경우에만 다음 단계를 계속 진행할 수 있습니다. 다음은 일정 상태가 `DesiredValues`에 지정된 `OPEN` 상태가 아닌 경우 다음 단계인 `LaunchInstance`로 진행할 수 없는 Automation 실행서의 YAML 기반 샘플 발췌 내용입니다. 다음은 예입니다. ``` mainSteps: - name: MyCheckCalendarStateStep action: 'aws:assertAwsResourceProperty' inputs: Service: ssm Api: GetCalendarState CalendarNames: ["arn:aws:ssm:us-east-2:123456789012:document/SaleDays"] PropertySelector: '$.State' DesiredValues: - OPEN description: "Use GetCalendarState to determine whether a calendar is open or closed." nextStep: LaunchInstance - name: LaunchInstance action: 'aws:executeScript' inputs: Runtime: python3.11 ... ``` # Change Calendar 문제 해결 다음 정보를 사용하면 AWS Systems Manager의 도구인 Change Calendar 관련 문제를 해결하는 데 도움이 됩니다. **Topics** + ['일정 가져오기 실패(Calendar import failed)' 오류](#change-manager-troubleshooting-1) ## '일정 가져오기 실패(Calendar import failed)' 오류 **문제**: iCalendar(`.ics`) 파일을 가져올 때 시스템이 일정 가져오기에 실패했음을 보고합니다. + **솔루션 1** - 지원되는 서드 파티 일정 공급자에서 내보낸 파일을 가져오고 있는지 확인합니다. 여기에는 다음이 포함됩니다. + Google 캘린더([내보내기 지침](https://support.google.com/calendar/answer/37111)) + Microsoft Outlook([내보내기 지침](https://support.microsoft.com/en-us/office/export-an-outlook-calendar-to-google-calendar-662fa3bb-0794-4b18-add8-9968b665f4e6)) + iCloud 캘린더([내보내기 지침](https://support.apple.com/guide/calendar/import-or-export-calendars-icl1023/mac)) + **솔루션 2** - 소스 일정에 반복 이벤트가 포함된 경우 이벤트의 개별 발생이 취소되거나 삭제되지 않았는지 확인합니다. 현재 Change Calendar는 개별 취소가 있는 반복 이벤트 가져오기를 지원하지 않습니다. 이 문제를 해결하려면 소스 일정에서 반복 이벤트를 제거하고, 해당 일정을 다시 내보내고 Change Calendar로 다시 가져온 다음, Change Calendar 인터페이스를 사용하여 반복 이벤트를 추가합니다. 자세한 내용은 [Change Calendar 이벤트 생성](change-calendar-create-event.md) 섹션을 참조하세요. + **솔루션 3** - 소스 일정에 하나 이상의 이벤트가 포함되어 있는지 확인합니다. 이벤트가 포함되지 않은 `.ics` 파일은 업로드에 실패합니다. + **솔루션 4** - `.ics` 파일이 너무 커서 시스템이 가져오는 데 실패했다고 보고하는 경우, 일정 항목에 대한 기본 세부 정보만 내보내고 있는지 확인하세요. 필요한 경우 내보내는 시간 간격의 길이를 줄입니다. + **솔루션 5** - 내보낸 일정을 **이벤트(Events)** 탭에서 가져오려고 할 때 Change Calendar에서 해당 일정의 표준 시간대를 확인할 수 없는 경우, 다음과 같은 메시지가 나타날 수 있습니다. “일정 가져오기에 실패했습니다. Change Calendar가 유효한 시간대를 찾을 수 없습니다. 편집 메뉴에서 일정을 가져올 수 있습니다.” 이 경우, **작업, 편집(Actions, Edit)**을 선택한 다음 **일정 편집(Edit calendar)** 페이지에서 파일을 가져옵니다. + **솔루션 6** - `.ics` 파일을 가져오기 전에 편집하지 마세요. 파일의 내용을 수정하려고 하면 일정 데이터가 손상될 수 있습니다. 가져오기를 시도하기 전에 파일을 수정한 경우, 소스 일정에서 다시 일정을 내보낸 다음 업로드를 다시 시도합니다.