AWS Elemental MediaPackage Ereignisse - AWS Elemental MediaPackage
Ereignisse mit EingabebenachrichtigungenWichtige Ereignisse im Zusammenhang mit Benachrichtigungen von AnbieternEreignisse mit Jobbenachrichtigungen auswerten

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

AWS Elemental MediaPackage Ereignisse

AWS Elemental MediaPackage integriert sich in Amazon CloudWatch Events, um Sie über bestimmte Ereignisse zu informieren, die sich auf Ihre Kanäle und Endpunkte auswirken. Jedes Ereignis wird in JSON (JavaScript Object Notation) dargestellt und enthält den Namen des Ereignisses, Datum und Uhrzeit des Ereignisses, den betroffenen Kanal oder Endpunkt und vieles mehr. MediaPackage sendet Ereignisse nach bestem Wissen aus. Sie können CloudWatch Ereignisse verwenden, um diese Ereignisse zu sammeln und Regeln einzurichten, die sie an ein oder mehrere Ziele weiterleiten, z. B. an AWS Lambda Funktionen, Amazon SNS SNS-Themen, Amazon SQS SQS-Warteschlangen, Streams in Amazon Kinesis Data Streams oder integrierte Ziele.

Weitere Informationen zur Verwendung von CloudWatch Events mit anderen Arten von Veranstaltungen finden Sie im Amazon CloudWatch Events-Benutzerhandbuch.

In den folgenden Themen werden die CloudWatch Ereignisse beschrieben, die MediaPackage erstellt werden.

Ereignisse mit Eingabebenachrichtigungen

Sie erhalten Eingabe-Benachrichtigungsereignisse für Live- und Video-on-Demand (VOD)-Inhalte. Diese Ereignisse benachrichtigen Sie, wenn bei der Aufnahme etwas passiert MediaPackage . Dies sind die Eingabe-Benachrichtigungsereignisse, die Sie möglicherweise erhalten:

  • Überschreiten der maximalen Zahl von Eingabe-Streams

  • Eingabewechsel

  • VOD-Aufnahmestatusänderung

  • VOD-Wiedergabebereitschaft

In den folgenden Abschnitten wird jedes dieser Ereignisse beschrieben.

Ereignis "Überschreiten der maximalen Zahl von Eingabe-Streams"

Bei Live-Inhalten MediaPackage überschreitet ein Kanaleingang das Kontingent für die Anzahl der Eingangsstreams. Hinweise zu Kontingenten finden Sie unter Kontingente in AWS Elemental MediaPackage.

Beispiel 
{
   "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)"
   }
}
Ereignis "Wechsel der Eingabe"

MediaPackage Schaltet bei Live-Inhalten die Eingänge für einen Ihrer Endpunkte um.

Alle fünf Minuten wird ein einzelnes Ereignis gesendet. Wenn der Eingang innerhalb von fünf Minuten mehrmals wechselt (z. B. wenn er zu einem Eingang MediaPackage wechselt und dann wieder zum anderen), erhalten Sie nur ein Ereignis.

Informationen zur Eingaberedundanz und zu den Ursachen, die zu einem Wechsel von Eingaben führen, finden Sie unter AWS Elemental MediaPackage Redundanzverarbeitungsablauf für Live-Eingaben.

Beispiel 
{
   "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-Aufnahmestatusereignis

Bei Video-on-Demand-Inhalten (VOD) MediaPackage ändert sich der Aufnahmestatus eines Assets. Sie erhalten Benachrichtigungen für die folgenden Ereignisse:

  • IngestStart

  • IngestError

  • IngestComplete

Beispiel 
{
   "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-Wiedergabeereignis

Bei VOD-Inhalten steht ein Asset-In zur MediaPackage Wiedergabe zur Verfügung. Es gibt einen Zeitraum zwischen dem Abschluss der Aufnahme einer Komponente und dem Zeitpunkt, an dem die Komponente wiedergegeben werden kann. Das Ereignis VodAssetPlayable bedeutet, dass jetzt Wiedergabeanforderungen für das Asset erfüllt werden MediaPackage können.

Sie erhalten individuelle VodAssetPlayable Ereignisse für jede Verpackungskonfiguration in Ihrer Verpackungsgruppe. Wenn Ihre Verpackungsgruppe beispielsweise eine DASH- und eine HLS-Paketkonfiguration enthält, erhalten Sie zwei VodAssetPlayable Ereignisse — eines für Ihre DASH-Paketkonfiguration und eines für Ihre HLS-Paketkonfiguration.

Beispiel 
{
   "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"
      ]
    }
}

Wichtige Ereignisse im Zusammenhang mit Benachrichtigungen von Anbietern

Sie erhalten Benachrichtigungsereignisse für Schlüsselanbieter, wenn Sie Inhaltsverschlüsselung auf einem Endpunkt verwenden und den Schlüsselanbieter nicht erreichen MediaPackage können. Informationen zu DRM und Verschlüsselung finden Sie unter https://docs.aws.amazon.com/speke/latest/documentation/.

Beispiel Live-Benachrichtigungsereignis für den Schlüsselanbieter
{
   "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"
   }
}
Beispiel Benachrichtigungsereignis für den VOD-Schlüsselanbieter
{
   "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"
   }
}

Ereignisse mit Jobbenachrichtigungen auswerten

Wenn Sie einen Clip aus einem Live-Stream exportieren, um ein Live-to-VOD-Objekt zu erstellen, erhalten Sie Ereignisse zum Harvester-Job-Status. MediaPackage erstellt Benachrichtigungen, wenn der Harvest-Job erfolgreich ist oder fehlschlägt. Hinweise zu Entnahmeaufgaben und Live-to-VOD-Komponenten finden Sie unter Live-to-VOD-Assets erstellen mit AWS Elemental MediaPackage.

Beispiel Erfolgreiches Harvest-Job-Ereignis
{
   "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"
      }
   }
}
Beispiel Event zum Erntejob gescheitert
{
   "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"
   }
}