기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 이벤트 AWS Ground Station 로 자동화
**참고**
이 문서에서는 전체적으로 “이벤트”라는 용어를 사용합니다. CloudWatch Events와 EventBridge는 기본 서비스 및 API가 동일합니다. 두 서비스를 사용하면 수신 이벤트를 확인한 후 처리 대상으로 라우팅하는 규칙을 생성할 수 있습니다.
이벤트를 사용하면 AWS 서비스를 자동화하고 애플리케이션 가용성 문제 또는 리소스 변경과 같은 시스템 이벤트에 자동으로 대응할 수 있습니다. AWS 서비스의 이벤트는 거의 실시간으로 전달됩니다. 원하는 이벤트만 표시하도록 간단한 규칙을 작성한 후 규칙과 일치하는 이벤트 발생 시 실행할 자동화 작업을 지정할 수 있습니다. 자동으로 트리거될 수 있는 작업 중 일부는 다음과 같습니다.
+ AWS Lambda 함수 호출
+ Amazon EC2 Run Command 호출
+ Amazon Kinesis Data Streams로 이벤트 릴레이
+ AWS Step Functions 상태 시스템 활성화
+ SNS 주제 또는 Amazon SQS 대기열 알림
에서 이벤트를 사용하는 몇 가지 예는 다음과 AWS Ground Station 같습니다.
+ Lambda 함수를 간접적으로 호출하여 이벤트 상태를 기반으로 Amazon EC2 인스턴스의 시작 및 중지를 자동화합니다.
+ 접촉의 상태가 변경될 때마다 Amazon SNS 주제에 게시합니다. 이러한 주제는 접촉의 시작 또는 끝 부분에 이메일 공지를 보내도록 설정할 수 있습니다.
자세한 내용은 [Amazon EventBridge Events 사용 설명서를](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) 참조하세요.
## AWS Ground Station 이벤트 유형
**참고**
AWS Ground Station에서 생성되는 모든 이벤트는 “소스”의 값으로 “aws.groundstation”을 사용합니다.
AWS Ground Station 는 상태 변경과 관련된 이벤트를 내보내 자동화를 사용자 지정하는 기능을 지원합니다. 현재는 고객 응대 상태 변경 이벤트, 데이터 흐름 엔드포인트 그룹 변경 이벤트 및 에페메리스 상태 변경 이벤트를 AWS Ground Station 지원합니다. 다음 섹션에서는 각 유형에 대한 자세한 정보를 제공합니다.
## 연락 이벤트 타임라인
AWS Ground Station 는 고객 응대 상태가 변경될 때 이벤트를 내보냅니다. 이러한 상태 변경의 정의와 상태 자체의 의미에 대한 자세한 내용은 [고객 응대 수명 주기 이해](contacts.lifecycle.md) 섹션을 참조하세요. 고객 응대에서 사용되는 모든 데이터 흐름 엔드포인트 그룹에는 독립적인 이벤트 세트가 있으며,이 이벤트 세트도 내보내집니다. 동일한 기간 동안 데이터 흐름 엔드포인트 그룹에 대한 이벤트도 내보냅니다. 사전 통과 및 사후 통과 이벤트의 정확한 시간은 미션 프로파일 및 데이터 흐름 엔드포인트 그룹을 설정할 때 사용자가 구성할 수 있습니다.
다음 다이어그램은 공칭 고객 응대 및 관련 데이터 흐름 엔드포인트 그룹에 대해 생성된 상태 및 이벤트를 보여줍니다.
**Ground Station 접촉 상태 변경**
예정된 고객 응대의 상태가 변경될 때 특정 작업을 수행하려면이 작업을 자동화하는 규칙을 설정할 수 있습니다. 이 기능은 접촉의 상태 변경에 대한 알림을 수신하려는 경우에 유용합니다. 이러한 이벤트를 수신할 때 변경하려는 경우 미션 프로파일의 [ contactPrePassDurationSeconds](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateMissionProfile.html#groundstation-UpdateMissionProfile-request-contactPrePassDurationSeconds) 및 [ contactPostPassDurationSeconds](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateMissionProfile.html#groundstation-UpdateMissionProfile-request-contactPostPassDurationSeconds)를 수정할 수 있습니다. 이벤트는 접촉이 예약된 리전으로 전송됩니다.
다음은 예제 이벤트입니다.
```
{
"version": "0",
"id": "01234567-0123-0123",
"account": "123456789012",
"time": "2019-05-30T17:40:30Z",
"region": "us-west-2",
"source": "aws.groundstation",
"resources": [
"arn:aws:groundstation:us-west-2:123456789012:contact/11111111-1111-1111-1111-111111111111"
],
"detailType": "Ground Station Contact State Change",
"detail": {
"contactId": "11111111-1111-1111-1111-111111111111",
"groundstationId": "Ground Station 1",
"missionProfileArn": "arn:aws:groundstation:us-west-2:123456789012:mission-profile/11111111-1111-1111-1111-111111111111",
"satelliteArn": "arn:aws:groundstation::123456789012:satellite/11111111-1111-1111-1111-111111111111",
"contactStatus": "PASS"
}
}
```
`contactStatus`에 대해 가능한 값은 [AWS Ground Station 고객 응대 상태](contacts.lifecycle.md#contact-statuses)에 정의됩니다.
**Ground Station 데이터 흐름 엔드포인트 그룹 상태 변경**
데이터 흐름 엔드포인트 그룹이 데이터 수신에 사용 중일 때 작업을 수행하고 싶으면 이 작업을 자동화하도록 규칙을 설정할 수 있습니다. 이렇게 하면 데이터 흐름 엔드포인트 그룹의 상태 변경에 따라 다른 작업을 수행할 수 있습니다. 이러한 이벤트를 수신할 때 변경하려면 [contactPrePassDurationSeconds](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateDataflowEndpointGroup.html#groundstation-CreateDataflowEndpointGroup-request-contactPrePassDurationSeconds)와 [contactPostPassDurationSeconds](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateDataflowEndpointGroup.html#groundstation-CreateDataflowEndpointGroup-request-contactPostPassDurationSeconds)가 다른 데이터 흐름 엔드포인트 그룹을 사용합니다. 이 이벤트는 데이터 흐름 엔드포인트 그룹의 리전으로 전송됩니다.
아래에 예제가 나와 있습니다.
```
{
"version": "0",
"id": "01234567-0123-0123",
"account": "123456789012",
"time": "2019-05-30T17:40:30Z",
"region": "us-west-2",
"source": "aws.groundstation",
"resources": [
"arn:aws:groundstation:us-west-2:123456789012:dataflow-endpoint-group/bad957a8-1d60-4c45-a92a-39febd98921d",
"arn:aws:groundstation:us-west-2:123456789012:contact/98ddd10f-f2bc-479c-bf7d-55644737fb09",
"arn:aws:groundstation:us-west-2:123456789012:mission-profile/c513c84c-eb40-4473-88a2-d482648c9234"
],
"detailType": "Ground Station Dataflow Endpoint Group State Change",
"detail": {
"dataflowEndpointGroupId": "bad957a8-1d60-4c45-a92a-39febd98921d",
"groundstationId": "Ground Station 1",
"contactId": "98ddd10f-f2bc-479c-bf7d-55644737fb09",
"dataflowEndpointGroupArn": "arn:aws:groundstation:us-west-2:680367718957:dataflow-endpoint-group/bad957a8-1d60-4c45-a92a-39febd98921d",
"missionProfileArn": "arn:aws:groundstation:us-west-2:123456789012:mission-profile/c513c84c-eb40-4473-88a2-d482648c9234",
"dataflowEndpointGroupState": "PREPASS"
}
}
```
`dataflowEndpointGroupState`에서 가능한 상태로는 `PREPASS`, `PASS`, `POSTPASS` 및 `COMPLETED`가 있습니다.
## 에페메리스 이벤트
**Ground Station 에페메리스 상태 변경**
에페메리스가 상태를 변경할 때 특정 작업을 수행하려는 경우 이 작업을 자동화하도록 규칙을 설정할 수 있습니다. 이렇게 하면 상태를 변경하는 에페메리스에 따라 다양한 작업을 수행할 수 있습니다. 예를 들어, 에페메리스의 검증이 완료되었는데 지금은 `ENABLED`일 때 작업을 수행할 수 있습니다. 이 이벤트에 대한 알림은 에페메리스가 업로드된 리전으로 전송됩니다.
아래에 예제가 나와 있습니다.
```
{
"id": "7bf73129-1428-4cd3-a780-95db273d1602",
"detail-type": "Ground Station Ephemeris State Change",
"source": "aws.groundstation",
"account": "123456789012",
"time": "2019-12-03T21:29:54Z",
"region": "us-west-2",
"resources": [
"arn:aws:groundstation::123456789012:satellite/10313191-c9d9-4ecb-a5f2-bc55cab050ec",
"arn:aws:groundstation::123456789012:ephemeris/111111-cccc-bbbb-a555-bcccca005000"
],
"detail": {
"ephemerisStatus": "ENABLED",
"ephemerisId": "111111-cccc-bbbb-a555-bcccca005000",
"satelliteId": "10313191-c9d9-4ecb-a5f2-bc55cab050ec"
}
}
```
`ephemerisStatus`에서 가능한 상태로는 `ENABLED`, `VALIDATING`, `INVALID`, `ERROR`, `DISABLED`, `EXPIRED`가 있습니다.