翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# AWS Elemental MediaPackage イベント
AWS Elemental MediaPackage は Amazon CloudWatch Events と統合して、チャネルとエンドポイントに影響する特定のイベントを通知します。各イベントは [JSON (JavaScript Object Notation)](http://json.org) 形式で、イベント名、イベントの発生日時、影響を受けるチェネルやエンドポイントなどが含まれます。MediaPackage は、ベストエフォートを基準としてイベントを発行します。CloudWatch Events を使用してこれらのイベントを収集し、 AWS Lambda 関数、Amazon SNS トピック、Amazon SQS キュー、Amazon Kinesis Data Streams のストリーム、組み込み*ターゲット*などの 1 つ以上のターゲットにルーティングするルールを設定できます。
CloudWatch Events での他の種類のイベント使用については、[Amazon CloudWatch Events ユーザーガイド](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/)を参照してください。
以下のトピックでは、MediaPackage が作成する CloudWatch Events について説明します。
**Topics**
+ [入力通知イベント](#input-state-events)
+ [キープロバイダーの通知イベント](#key-provider-state-events)
+ [収集ジョブの通知イベント](#hj-status-events)
## 入力通知イベント
ライブおよびビデオオンデマンド (VOD) コンテンツの入力通知イベントを取得します。これらのイベントは、MediaPackage の取り込みに関連して何かが発生すると、その旨を通知します。以下は、受け取る可能性のある入力通知イベントです。
+ 最大入力ストリームの超過
+ 入力スイッチ
+ VOD 取り込みステータスの変更
+ VOD 再生の準備完了
以下のセクションでは、これらの各イベントについて説明します。
** 最大入力ストリーム超過イベント **
ライブコンテンツの場合、MediaPackage のいずれかのチャネルが、入力ストリーム数のクォータを超過しています。クォータの詳細については、「[のクォータ AWS Elemental MediaPackage](quotas.md)」を参照してください。
**Example**
```
{
"id": "7bf73129-1428-4cd3-a780-95db273d1602",
"detail-type": "MediaPackage Input Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2015-11-11T21:29:54Z",
"region": "us-west-2",
"resources":[
"arn:aws:mediapackage:us-west-2:aws_account_id:channels/262ff182d46d4b399fcabea1364df682"
],
"detail":{
"event": "MaxIngestStreamsError",
"message": "Parent Manifest [%s] has [23] streams, more than [20] allowed: (index_1.m3u8,index_2.m3u8,index_3.m3u8,index_4.m3u8,index_5.m3u8,index_6.m3u8,index_7.m3u8,index_8.m3u8,index_9.m3u8,index_10.m3u8,index_11.m3u8,index_12.m3u8,index_13.m3u8,index_14.m3u8,index_15.m3u8,index_16.m3u8,index_17.m3u8,index_18.m3u8,index_19.m3u8,index_20.m3u8,index_21.m3u8,index_22.m3u8,index_23.m3u8)"
}
}
```
**入力切り替えイベント**
ライブコンテンツの場合、MediaPackage がいずれかのエンドポイントで入力を切り替えました。
1 つのイベントは 5 分間隔で送信されます。5 分の間に入力が複数回切り替わった場合 (例えば、MediaPackage がある入力に切り替えた後、元の入力に戻した場合) でも、受信するイベントは 1 つのみです。
入力冗長およびどのような場合に入力が切り替えられるかについては、「[ライブ入力冗長 AWS Elemental MediaPackage 処理フロー](what-is-flow-ir.md)」を参照してください。
**Example**
```
{
"id": "8f9b8e72-0b31-e883-f19c-aec84742f3ce",
"detail-type": "MediaPackage Input Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2018-07-16T17:29:36Z",
"region": "us-east-1",
"resources":[
"arn:aws:mediapackage:us-east-1:aws_account_id:origin_endpoints/82d6b9bc04cb4612b487963d6c8d0f1a"
],
"detail":{
"event": "InputSwitchEvent",
"message": "Origin endpoint experienced an Input Switch Event",
"EventDetails": {
"Channel": "channel name",
"PreviousIngestEndpoint": "endpoint uuid before input switch",
"CurrentIngestEndpoint": "endpoint uuid after input switch",
}
}
}
```
**VOD 取り込みステータスイベント**
ビデオオンデマンド (VOD) コンテンツの場合、MediaPackage のアセットが取り込みステータスを変更しました。以下のイベントの通知を受け取ります。
+ `IngestStart`
+ `IngestError`
+ `IngestComplete`
**Example**
```
{
"id": "8f9b8e72-0b31-e883-f19c-aec84742f3ce",
"detail-type": "MediaPackage Input Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2019-05-03T17:29:36Z",
"region": "us-west-2",
"resources":[
"arn:aws:mediapackage-vod:us-west-2:aws_account_id:assets/asset_name"
],
"detail":{
"event": "IngestComplete",
"message": "message text"
}
}
```
** VOD 再生イベント**
VOD コンテンツの場合、MediaPackageでアセットが再生用として使用可能になりました。アセットの取り込みが完了してから、アセットが再生可能になるまでに時間がかかります。イベント `VodAssetPlayable` は、MediaPackage がアセットの再生リクエストに対応できるようになったことを意味します。
パッケージンググループ内の各パッケージング設定について、個別の `VodAssetPlayable` イベントを取得することができます。例えば、パッケージンググループに DASH と HLS のパッケージング設定が各 1 つずつ含まれている場合は、ユーザーは (DASH パッケージング設定用と HLS パッケージング設定用として) 2 つの `VodAssetPlayable` イベントを受け取ります。
**Example**
```
{
"id": "81e896e4-d9e5-ec79-f82a-b4cf3246c567",
"detail-type": "MediaPackage Input Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2019-11-03T21:46:00Z",
"region": "us-west-2",
"resources":[
"arn:aws:mediapackage-vod:us-west-2:aws_account_id:assets/asset_id",
"arn:aws:mediapackage-vod:us-west-2:aws_account_id:packaging_configuration/packaging_configuration_id"
],
"detail":{
"event": "VodAssetPlayable",
"message": "Asset 'asset_id' is now playable for PackagingConfiguration 'packaging_configuration_id'",
"packaging_configuration_id": "packaging_configuration_id",
"manifest_urls":[
"https://555555555555.egress.mediapackage-vod.us-west-2.amazonaws.com/out/v1/b9cc115bf7f1a/b848dfb116920772aa69ba/a3c74b1cae6a451c/index.m3u8"
]
}
}
{
"id": "91e896e4-d9e5-ab80-f82a-b4cf3246c568",
"detail-type": "MediaPackage Input Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2019-11-03T21:47:00Z",
"region": "us-west-2",
"resources":[
"arn:aws:mediapackage-vod:us-west-2:aws_account_id:assets/asset_id",
"arn:aws:mediapackage-vod:us-west-2:aws_account_id:packaging_configuration/packaging_configuration_id"
],
"detail":{
"event": "VodAssetPlayable",
"message": "Asset 'asset_id' is now playable for PackagingConfiguration 'packaging_configuration_id'",
"packaging_configuration_id": "packaging_configuration_id",
"manifest_urls":[
"https://111122223333.egress.mediapackage-vod.us-west-2.amazonaws.com/out/v1/1234567890abc/021345abcdef6789012345/abcdef0123456789/index.mpd"
]
}
}
```
## キープロバイダーの通知イベント
エンドポイントでコンテンツの暗号化を使用する際にキープロバイダーの通知イベントを受け取った場合、MediaPackage はキープロバイダーに到達できていません。DRM と暗号化の詳細については、[https://docs.aws.amazon.com/speke/latest/documentation/](https://docs.aws.amazon.com/speke/latest/documentation/) を参照してください。
**Example ライブキープロバイダーの通知イベント**
```
{
"id": "7bf73129-1428-4cd3-a780-98ds273d1602",
"detail-type": "MediaPackage Key Provider Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2015-11-11T21:29:54Z",
"region": "us-west-2",
"resources":[
"arn:aws:mediapackage:us-west-2:aws_account_id:origin_endpoints/endpoint_id"
],
"detail":{
"event": "KeyProviderError",
"message": "message-text"
}
}
```
**Example VOD キープロバイダーの通知イベント**
```
{
"id": "7bf73129-1428-4cd3-a780-98ds273d1602",
"detail-type": "MediaPackage Key Provider Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2015-11-11T21:29:54Z",
"region": "us-west-2",
"resources":[
"arn:aws:mediapackage-vod:us-west-2:aws_account_id:packaging_configurations/packaging_group_name"
],
"detail":{
"event": "KeyProviderError",
"message": "message-text"
}
}
```
## 収集ジョブの通知イベント
ライブストリームからクリップをエクスポートして Live-to-VOD アセットを作成すると、収集ジョブのステータスイベントが発生します。MediaPackage は、収集ジョブの成功時 (または失敗時) に通知を作成します。収集ジョブと live-to-VOD アセットについては、「[を使用した live-to-VOD アセットの作成 AWS Elemental MediaPackage](ltov.md)」を参照してください。
**Example 成功した収集ジョブのイベント**
```
{
"id": "8f9b8e72-0b31-e883-f19c-aec84742f3ce",
"detail-type": "MediaPackage HarvestJob Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2019-07-16T17:29:36Z",
"region": "us-east-1",
"resources":[
"arn:aws:mediapackage:us-east-1:aws_account_id:harvest_jobs/harvest_job_id"
],
"detail":{
"harvest_job": {
"id": "harvest_job_id",
"arn": "arn:aws:mediapackage-vod:us-east-1:aws_account_id:harvest_jobs/harvest_job_id",
"status": "SUCCEEDED",
"origin_endpoint_id": "endpoint_id",
"start_time": "2019-06-26T20:30:00-08:00",
"end_time": "2019-06-26T21:00:00-08:00",
"s3_destination": {
"bucket_name": "s3_bucket_name",
"manifest_key": "path/and/manifest_name/index.m3u8",
"role_arn": "arn:aws:iam::aws_account_id:role/S3Access_role",
},
"created_at": "2019-06-26T21:03:12-08:00"
}
}
}
```
**Example 失敗した収集ジョブのイベント**
```
{
"id": "8f9b8e72-0b31-e883-f19c-aec84742f3ce",
"detail-type": "MediaPackage HarvestJob Notification",
"source": "aws.mediapackage",
"account": "aws_account_id",
"time": "2019-07-16T17:29:36Z",
"region": "us-east-1",
"resources":[
"arn:aws:mediapackage:us-east-1:aws_account_id:harvest_jobs/harvest_job_id"
],
"detail":{
"harvest_job": {
"id": "harvest_job_id",
"arn": "arn:aws:mediapackage-vod:us-east-1:aws_account_id:harvest_jobs/harvest_job_id",
"status": "FAILED",
"origin_endpoint_id": "endpoint_id",
"start_time": "2019-06-26T20:30:00-08:00",
"end_time": "2019-06-26T21:00:00-08:00",
"s3_destination": {
"bucket_name": "s3_bucket_name",
"manifest_key": "path/and/manifest_name/index.m3u8",
"role_arn": "arn:aws:iam::aws_account_id:role/S3Access_role",
},
"created_at": "2019-06-26T21:03:12-08:00"
},
"message": "Message text"
}
}
```