翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# イベント AWS Ground Station による自動化
**注記**
このドキュメントでは、全体を通して「イベント」という用語を使用しています。CloudWatch Events と EventBridge は同じ基盤となるサービスと API です。いずれかのサービスを使用することで、受信イベントを一致させ、処理のためにターゲットにルーティングするルールを作成できます。
イベントを使用すると、 AWS サービスを自動化し、アプリケーションの可用性の問題やリソースの変更などのシステムイベントに自動的に対応できます。 AWS サービスからのイベントはほぼリアルタイムで配信されます。簡単なルールを記述して、注目するイベントと、イベントがルールに一致した場合に自動的に実行するアクションを指定できます。自動的にトリガーできるアクションには、次のようなものがあります。
+ AWS Lambda 関数の呼び出し
+ Amazon EC2 Run Command の呼び出し
+ Amazon Kinesis Data Streams へのイベントの中継
+ AWS Step Functions ステートマシンのアクティブ化
+ Amazon SNS トピックまたは Amazon SQS キューの通知
でイベントを使用する例 AWS Ground Station には、次のようなものがあります。
+ イベント状態に基づいて Amazon EC2 インスタンスの開始と停止を自動化する Lambda 関数を呼び出す。
+ コンタクトの状態が変化するたびに Amazon SNS トピックを発行する。これらのトピックは、コンタクトの最初または最後に E メール通知を送信するように設定できます。
詳細については、[「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` が考えられます。