• AWS Systems Manager CloudWatch 대시보드는 2026년 4월 30일 이후에는 더 이상 사용할 수 없습니다. 고객은 Amazon CloudWatch 콘솔을 계속 사용하여 현재와 마찬가지로 Amazon CloudWatch 대시보드를 보고, 생성하고, 관리할 수 있습니다. 자세한 내용은 [Amazon CloudWatch 대시보드 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)를 참조하세요.

# Change Calendar 상태 가져오기
<a name="change-calendar-getstate"></a>

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` 상태가 반환됩니다.