本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
AWS Elemental MediaPackage 事件
AWS Elemental MediaPackage 与 Amazon E CloudWatch vents 集成,可通知您某些影响您的渠道和终端节点的事件。每个事件都以 JSON(JavaScript 对象表示法)
有关将事件用于其他类型 CloudWatch 事件的更多信息,请参阅 Amazon CloudWatch Events 用户指南。
以下主题描述了 MediaPackage 创建 CloudWatch 的事件。
输入通知事件
您将收到直播和视频点播 (VOD) 内容的输入通知事件。当 MediaPackage 摄取出现问题时,这些事件会通知你。下面是您可能会收到的输入通知事件:
-
已超出最大输入流
-
输入切换
-
VOD采集状态更改
-
VOD播放就绪
以下各部分介绍了这些事件中的每个事件。
- “已超出最大输入流”事件
-
对于直播内容,进入的频道 MediaPackage 超过了输入流数量的配额。有关配额的信息,请参阅AWS Elemental MediaPackage 中的配额。
例
{ "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 切换其中一个端点的输入。
每五分钟发送一个事件。如果输入在五分钟内多次切换(例如,如果 MediaPackage 切换到一个输入,然后切换回另一个输入),则只会收到一个事件。
有关输入冗余以及什么导致切换输入的信息,请参阅实时输入冗余 AWS Elemental MediaPackage 处理流程。
例
{ "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
例
{ "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打包配置,则您会收到两个VodAssetPlayable
事件:一个针对您的DASH打包配置,另一个针对您的HLS打包配置。例
{ "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/。
例 实时密钥提供程序通知事件
{
"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
"
}
}
例 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。
例 成功的采集作业事件
{
"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
"
}
}
}
例 失败的采集作业事件
{
"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
"
}
}