翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# での EventBridge の使用 AWS Elemental MediaConvert
Amazon EventBridge を使用して AWS Elemental MediaConvert ジョブをモニタリングできます。EventBridge を使用してできることの例をご覧ください。
**ジョブの出力に関する詳細を入手します**
AWS Elemental MediaConvert は、`COMPLETE`イベントの通知でジョブ出力に関する詳細を提供します。この情報には、ジョブのメディアファイルとマニフェストの場所とファイル名が含まれます。詳細については、「[COMPLETE ステータスのイベント](ev_status_complete.md)」を参照してください。
Amazon CloudWatch に送られたジョブメトリクスの詳細については、「[MediaConvert での CloudWatch の使用](cloudwatch_metrics.md)」を参照してください。
**ジョブのステータスの変更を知らせる通知の設定**
EventBridge イベントルールの設定方法については「[チュートリアル: 失敗したジョブに関する E メール通知の設定](setting-up-cloudwatch-event-rules.md#mediaconvert_sns_tutorial)」を参照してください。
イベントルールを設定できるすべてのジョブステータスの変更通知のリストについては、「[MediaConvert EventBridge イベントのリスト](mediaconvert_event_list.md)」を参照してください。
**ジョブの進行状況を監視する**
`STATUS_UPDATE` イベントは、自分のジョブがどのフェーズにあるかについての情報 (`PROBING`、`TRANSCODING`、`UPLOADING`) を提供します。一部のジョブについては、MediaConvert はジョブがどの程度進行したかについて推測を提供します。この推測は、ジョブがキューを出てから出力ファイルが出力 Amazon S3 バケットに入るまでの合計時間に対する割合として表示されます。
`STATUS_UPDATE` イベントの詳細については、[MediaConvert EventBridge イベントのリスト](mediaconvert_event_list.md) のイベントタイプのテーブルを参照してください。
ステータス更新の頻度の調整については、[ステータスの更新間隔の調整](adjusting-the-status-update-interval.md) を参照してください。
** AWS Lambda 関数を使用して後処理を自動的に開始する**
EventBridge を設定して、ジョブの完了後に AWS Lambda 関数が後処理コードを開始できます。 AWS Lambda で を使用する方法の詳細については AWS Elemental MediaConvert、次のリソースのいずれかを参照してください。
+ 経験豊富なクラウドアーキテクトは、[*AWS Answers* ブログの「 AWS」でのオンデマンドビデオ](https://aws.amazon.com/solutions/video-on-demand-on-aws/)の投稿を参照してください。
+ MediaConvert および Lambda を初めて使用する開発者は、GitHub にある[「Automating MediaConvert jobs with Lambda (Lambda を使用して MediaConvert ジョブを自動化する)」](https://github.com/aws-samples/aws-media-services-simple-vod-workflow/blob/master/7-MediaConvertJobLambda/README.md)チュートリアルを参照してください。
**作成するジョブやその他 MediaConvert オペレーションに関する情報を入手する**
MediaConvert では、作成する新しいジョブや実行するその他 MediaConvert オペレーションに関する EventBridge イベントをデフォルトでは送信しません。このような場合に EventBridge イベントを受信するには、まず AWS CloudTrail 証跡を作成する必要があります。
詳細については、「[Working with CloudTrail trails](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-getting-started.html)」を参照してください。
**注記**
EventBridge は、MediaConvert イベントストリームから各イベントを少なくとも 1 回配信します。
MediaConvert では、EventBridge にイベントを配信するための追加のアクセス権限は必要ありません。
**Topics**
+ [EventBridge ルールの設定](setting-up-cloudwatch-event-rules.md)
+ [MediaConvert ジョブの進行状況のモニタリング](how-mediaconvert-jobs-progress.md)
+ [MediaConvert EventBridge イベントのリスト](mediaconvert_event_list.md)
# EventBridge ルールの設定
Amazon EventBridge ルールを設定するには: からの AWS Elemental MediaConvert イベントと、Amazon Simple Notification Service (Amazon SNS) や などのジョブステータスの変更に応答するターゲットサービスをリンクするルールを作成します AWS Lambda。
で EventBridge ルールを設定するチュートリアルについては AWS Elemental MediaConvert、「」を参照してください[チュートリアル: 失敗したジョブに関する E メール通知の設定](#mediaconvert_sns_tutorial)。
MediaConvert によって EventBridge イベントストリームで送信されるイベントのリストについては、「[MediaConvert EventBridge イベントのリスト](mediaconvert_event_list.md)」を参照してください。
EventBridge の使用方法の詳細については、[「Amazon EventBridge ユーザーガイド」](https://docs.aws.amazon.com/eventbridge/latest/userguide/)を参照してください。
トラブルシューティングの詳細については、「Amazon EventBridge ユーザーガイド」の[「Amazon EventBridge のトラブルシューティング」](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-troubleshooting.html)を参照してください 。
**Topics**
+ [チュートリアル: 失敗したジョブに関する E メール通知の設定](#mediaconvert_sns_tutorial)
+ [ステップ 1: Amazon SNS でトピックを作成する](#mediaconvert_sns_create_topic)
+ [ステップ 2: EventBridge ルールでイベントパターンを指定する](#mediaconvert_sns_rule_event_source)
+ [ステップ 3: Amazon SNS トピックを追加してルールを完了する](#add-target-and-finish-rule)
+ [ステップ 4: ルールをテストする](#mediaconvert_sns_test_rule)
## チュートリアル: 失敗したジョブに関する E メール通知の設定
このチュートリアルでは、ジョブのステータスが `ERROR` に変わったときのイベントをキャプチャし、そのイベントをユーザーに通知する EventBridge イベントルールを設定します。これを行うには、まず、失敗したジョブに関する E メール通知を送信する Amazon SNS のトピックを作成します。次に、EventBridge でルールを作成します。イベントソースを定義して Amazon SNS トピック (「ターゲット」) を参照します。
## ステップ 1: Amazon SNS でトピックを作成する
EventBridge ルールの設定の前半部分では、ルールのターゲットを作成します。この例では、Amazon SNS トピックを作成してサブスクライブします。
**Amazon SNS トピックを作成するには**
1. Amazon SNS コンソール ([https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home)) を開きます。
1. ナビゲーションペインで、[**Topics (トピック)**]、[**Create topic (トピックの作成)**] の順に選択してください。
1. [**Type (タイプ)**] で、[**Standard (標準)**] を選択します。
1. [**名**] については、**MediaConvertJobErrorAlert** を入力し、[**トピックを作成**] を選択します。
1. 作成したトピックの**[名前]**を選択して、**[トピックの詳細]**を表示します。
1. **[MediaConvertJobErrorAlert]** の [**トピックの詳細**] ページで、[**サブスクリプション**] セクションの **[サブスクリプションを作成] **を選択します。
1. [**Protocol (プロトコル)**] で [**Email (Eメール)**] を選択します。**[Endpoint (エンドポイント)]** に、Amazon SNS から通知を送信する先の E メールアドレスを入力します。
1. [**Create subscription (サブスクリプションを作成)**] を選択します。
1. Amazon SNS から通知 E メールが送信されます。受信した E メールで、[**Confirm subscription (サブスクリプションを確認)**] リンクを選択します。
## ステップ 2: EventBridge ルールでイベントパターンを指定する
このステップでは、EventBridge ルールでイベントパターンを指定する方法を説明します。このルールはジョブステータスが `ERROR` に変更したときに MediaConvert によって送信されるイベントをキャプチャします。
**EventBridge ルールでイベントパターンを設定するには**
1. Amazon EventBridge コンソール ([https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/)) を開きます。
1. ナビゲーションペインで [**Rules (ルール)**] を選択します。**デフォルト**の **[イベントバス]** を維持し、次に **[ルールを作成]** を選択します。
1. **[名前]** に「**MediaConvertJobStateError**」と入力し、**[次へ]** を選択します。
1. [イベントソース] から始まる **[イベントパターン]** セクションで、以下の設定を選択します。
+ **イベントソース**: **AWS services**
+ **AWS サービス**: **MediaConvert**
+ **イベントタイプ**: **MediaConvert Job State Change**
+ **イベントタイプ、特定の状態**：**ERROR**
1. **[イベントパターン]** ボックスは以下の例のようになります。
```
{
"source": ["aws.mediaconvert"],
"detail-type": ["MediaConvert Job State Change"],
"detail": {
"status": ["ERROR"]
}
}
```
このコードは、ジョブのステータスが `ERROR` に変わるイベントに一致する EventBridge イベントルールを定義します。イベントパターンの詳細については、*「Amazon CloudWatch ユーザーガイド」*の[「Events and event patterns (イベントとイベントパターン)」](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/CloudWatchEventsandEventPatterns.html)を参照してください。
1. [**次へ**] を選択します。
## ステップ 3: Amazon SNS トピックを追加してルールを完了する
次に、ステップ 1 で作成した Amazon SNS トピックを、ステップ 2 で開始した EventBridge ルールに追加します。
**Amazon SNS トピックを追加して EventBridge ルールを完了するには**
1. **[ターゲットを選択]** セクションで **[ターゲットの選択]** の **[SNS トピック]** を選択します。
1. **[トピック]** で、**[MediaConvertJobErrorAlert]** を選択します。
1. [**次へ**] を選択します。
1. オプションでタグを追加します。続いて、[**Next (次へ)**] を選択します。
1. 設定を確認します。次に、**[Create rule (ルールを作成)]** を選択します。
## ステップ 4: ルールをテストする
ルールをテストするには、エラーが発生することがわかっているジョブを送信します。例えば、存在しない入力の場所を指定します。イベントルールが正しく設定されていれば、数分以内にイベントテキストメッセージが記載された E メールが届きます。
**ルールをテストするには**
1. [https://console.aws.amazon.com/mediaconvert](https://console.aws.amazon.com/mediaconvert) で AWS Elemental MediaConvert コンソールを開きます。
1. MediaConvert の新しいジョブを送信します。詳細については、「[チュートリアル: ジョブ設定の構成](setting-up-a-job.md)」を参照してください。
1. Amazon SNS トピックの設定時に指定した E メールアカウントを確認します。ジョブエラーに関する E メール通知を受信したことを確認します。
# MediaConvert ジョブの進行状況のモニタリング
MediaConvert は、ユーザーが作成する各ジョブのステータス情報を提供します。ジョブのステータスをモニタリングすることで、ジョブで現在起きていることの確認、進行状況の追跡、問題のトラブルシューティングを行うことができます。
**Topics**
+ [ジョブステータス](#job-statuses)
+ [ジョブのステータスを確認する方法](#finding-job-status)
+ [ジョブフェーズ](#job-phase)
## ジョブステータス
送信する各ジョブは、さまざまなステータスで進行します。成功したジョブは `COMPLETE` ステータスで終了し、失敗したジョブは `ERROR` または `CANCELED` ステータスで終了します。
**成功したジョブ**
ジョブが成功すると、そのすべての出力が Amazon S3 バケットに書き込まれます。以下は、成功したジョブが通過するさまざまなステータスの詳細を一覧にしたものです。
1. `SUBMITTED`: ユーザーが MediaConvert コンソールまたは [https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-http-methods](https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-http-methods) オペレーションで作成したジョブであり、MediaConvert がまだ処理を開始していないジョブ。
1. `INPUT_INFORMATION`: MediaConvert が入力または出力に関する詳細を読み取っています。
1. `PROGRESSING`: MediaConvert はジョブの処理を開始しました。
1. `STATUS_UPDATE`: MediaConvert はジョブの処理を 1 分以上実行しています。このステータスのジョブは 3 つの*ジョブフェーズ*を通過します。詳細については、「[ジョブフェーズ](#job-phase)」を参照してください。
1. `COMPLETE`: MediaConvert がジョブの処理を完了し、出力はすべて Amazon S3 バケットに保存されています。
成功したジョブには [`NEW_WARNING`](ev_status_new_warning.md) や [`QUEUE_HOP`](ev_status_new_warning.md) などのステータスが含まれることもあります。
**失敗したジョブ**
ジョブが失敗すると、最初は成功したジョブと似た進行状況になることがありますが、出力が Amazon S3 バケットには書き込まれることはありません。失敗したジョブは次のいずれかのステータスになります。
+ `ERROR`: MediaConvert でジョブの処理中に問題が発生しました。詳細については、「[エラーコード](mediaconvert_error_codes.md)」を参照してください。
+ `CANCELED`: ユーザーが MediaConvert コンソールでまたは `CancelJob` オペレーションを通じてジョブをキャンセルしました。
## ジョブのステータスを確認する方法
現在のリージョンにあるすべてのジョブのステータスを一覧表示するには、MediaConvert コンソールの [[ジョブ]](https://console.aws.amazon.com/mediaconvert/home#/jobs/list) ページを開きます。または、`GetJob` か `ListJobs` オペレーションを送信します。
AWS CloudTrail は、作成する各ジョブ作成リクエストの詳細を記録します。CloudTrail は、CloudTrail 証跡も作成している場合にのみ、`SUBMITTED` ジョブの EventBridge イベントを送信します。詳細については、[CloudTrail 証跡の使用](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-getting-started.html)」および「 [を介した AWS サービスイベントへのアクセス AWS CloudTrail](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html)」を参照してください。
MediaConvert は、ジョブが処理を開始したとき、および、ステータスが変わるたび (`PROGRESSING` から `COMPLETE` または `ERROR` など) に、EventBridge イベントを送信します。EventBridge イベントのリストは「[MediaConvert EventBridge イベントのリスト](mediaconvert_event_list.md)」を参照してください。
## ジョブフェーズ
ジョブのステータスが 1 分以上 `PROGRESSING` であった場合、MediaConvert は現在のジョブ*フェーズ*で `STATUS_UPDATE` イベントを送信します。ジョブフェーズは、ジョブで現在起きていることの詳細を提供します。ジョブフェーズは次の順序で進行します。
1. `PROBING`: ジョブが `PROBING` フェーズにあるとき、MediaConvert は、サービスがトランスコードで必要な情報を入力ファイルから読み出します。
1. `TRANSCODING`: ジョブが `TRANSCODING` フェーズにある場合、サービスはコンテンツをデマックス、デコード、エンコード、リマックスします。一部のジョブにおいては、サービスは、このフェーズで出力の Amazon S3 バケットに出力をアップロードし始めます。すべてのトランスコードが完了するとフェーズは終了します。
1. `UPLOADING`: ジョブが `UPLOADING` フェーズにある場合、サービスは出力 Amazon S3 バケットにトランスコードされた出力をアップロードします。サービスが `TRANSCODING` フェーズ中にアップロードを開始するという出力の場合、`UPLOADING` フェーズはトランスコードの完了時に始まります。これはすべてのアップロードが完了するまで続きます。
ジョブフェーズを表示するには、MediaConvert コンソールの [[ジョブ]](https://console.aws.amazon.com/mediaconvert/home#/jobs/list) ページを開き、[[`STATUS_UPDATE` EventBridge イベント]](ev_status_status_update.md) をチェックするか、`GetJob` または `ListJobs` オペレーションを送信します。
# MediaConvert EventBridge イベントのリスト
AWS Elemental MediaConvert ジョブのステータスが変更されると、 は Amazon EventBridge にイベントを発行します。[EventBridge ルール](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)は次のどのイベントでも作成できます。
ほとんどのジョブはこれらのイベントのうち数個のみを発行し、最も一般的なものは、`INPUT_INFORMATION`、`PROGRESSING`、`COMPLETE` です。
各イベントタイプの詳細は、**イベント**列のリンクをクリックすると表示されます。
**MediaConvert イベント**
| イベント | 送信時点 | Contains |
| --- | --- | --- |
| [INPUT\$1INFORMATION](ev_status_input_information.md) | MediaConvert でジョブの処理が開始された直後。 | フレームの高さと幅、フレームレート、コーデックなどのメディア情報。 単一のイベントにおけるすべての入力についての MediaConvert からの情報。 |
| [PROGRESSING](ev_status_progressing.md) | ジョブが `SUBMITTED` 状態から `PROGRESSING` 状態に移行した。 | 基本ジョブの詳細 |
| [STATUS\$1UPDATE](ev_status_status_update.md) | MediaConvert がジョブの処理を開始してから約 1 分後。その後、ジョブが完了するかエラーが発生するまで約 1 分ごとに送信される。 | ジョブの開始後に変換されたフレームの数で表されたジョブの進行状況。 |
| [完了](ev_status_complete.md) | ジョブが完了し、MediaConvert はすべての出力をエラーなく書き出す。 | 完了したジョブに関する警告と出力情報。 |
| [CANCELED](ev_status_canceled.md) | ジョブがキャンセルされた。 | 基本ジョブの詳細 |
| [エラー](ev_status_error.md) | ジョブでエラーが発生した。少なくとも 1 つの出力にエラーがある。 | エラーコードとメッセージ。ジョブのエラーステータスについてのその他の一時的なジョブ情報を含む。 |
| [NEW\$1WARNING](ev_status_new_warning.md) | 警告の状態が発生。 | 警告コードと警告メッセージ。 |
| [QUEUE\$1HOP](ev_status_queue_hop.md) | ジョブがキューをホップするとき。 | 両方のキューの ARN と、キュー内のジョブの優先度。 |
**注記**
MediaConvert は `SUBMITTED` イベントを送信しません。API コール (MediaConvert コンソールからのコールを含む) を行うときは常に EventBridge イベントを受信するようにするには、 AWS CloudTrail 証跡を作成する必要があります。詳細については、[「 を介した AWS サービスイベントへのアクセス AWS CloudTrail](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html)」および[CloudTrail 証跡の使用](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-getting-started.html)」を参照してください。
MediaConvert が EventBridge にイベントを送信すると、結果の JSON に次のフィールドが表示されます。
+ **バージョン** — 現在、すべてのイベントで 0 (ゼロ)。
+ **id** − イベントごとに生成されるバージョン 4 UUID。
+ **詳細タイプ** — 送信されるイベントのタイプ。
+ **ソース** − イベントを生成したサービスを識別します。
+ **アカウント** — ジョブを実行した 12 桁の AWS アカウント ID。
+ **時間** — イベントが発生した時刻。
+ **リージョン** — ジョブの AWS リージョン を識別します。
+ **リソース** — ジョブの Amazon リソースネーム (ARN) を含む JSON 配列。
+ **詳細** − ジョブに関する情報を含む JSON オブジェクト。
以下のセクションは MediaConvert が発行する各 EventBridge イベントについて、イベントメッセージの詳細、JSON 応答、イベントパターンを含みます。
**Topics**
+ [INPUT\$1INFORMATION ステータスのイベント](ev_status_input_information.md)
+ [PROGRESSING ステータスのイベント](ev_status_progressing.md)
+ [STATUS\$1UPDATE ステータスのイベント](ev_status_status_update.md)
+ [COMPLETE ステータスのイベント](ev_status_complete.md)
+ [CANCELED ステータスのイベント](ev_status_canceled.md)
+ [ERROR ステータスのイベント](ev_status_error.md)
+ [NEW\$1WARNING ステータスのイベント](ev_status_new_warning.md)
+ [QUEUE\$1HOP ステータスのイベント](ev_status_queue_hop.md)
# INPUT\$1INFORMATION ステータスのイベント
MediaConvert はジョブが処理を開始し、MediaConvert が入力についての情報を読み込んだ後に、`INPUT_INFORMATION` についてイベントを送信します。イベントには主に、フレームの高さと幅、フレーム率、コーデックなど入力についてのメディア情報が含まれます。
MediaConvert はすべての入力に関する情報を 1 つのイベントに含めます。
以下の JSON は 1 回の入力で、ジョブについて `INPUT_INFORMATION` ステータスを含むイベントの例です。
```
{
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2022-12-19T19:07:12Z",
"region": "us-west-2",
"resources": [
"arn:aws:mediaconvert:us-west-2:111122223333:jobs/1671476818694-phptj0"
],
"detail": {
"timestamp": 1671476832075,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1671476818694-phptj0",
"status": "INPUT_INFORMATION",
"userMetadata": {},
"inputDetails": [
{
"id": 1,
"uri": "s3://amzn-s3-demo-bucket/file/file.mp4",
"audio": [
{
"channels": 2,
"codec": "AAC",
"language": "UND",
"sampleRate": 44100,
"streamId": 2
}
],
"video": [
{
"bitDepth": 8,
"codec": "H_264",
"colorFormat": "YUV_420",
"fourCC": "avc1",
"frameRate": 24,
"height": 1080,
"interlaceMode": "PROGRESSIVE",
"sar": "1:1",
"standard": "UNSPECIFIED",
"streamId": 1,
"width": 1920
}
]
}
]
}
}
```
以下のサンプル JSON を使用して、`INPUT_INFORMATION` ステータスのジョブについて EventBridge イベントパターンを作成します。
```
{
"source": ["aws.mediaconvert"],
"detail-type": ["MediaConvert Job State Change"],
"detail": {
"status": ["INPUT_INFORMATION"]
}
}
```
# PROGRESSING ステータスのイベント
MediaConvert はジョブが `SUBMITTED` 状態から `PROGRESSING` 状態に移行すると、`PROGRESSING` のイベントを送信します。
**注記**
ジョブが `PROGRESSING` ステータスになってから 48 時間経過すると、サービスは `ERROR` 状態になり停止します。`ERROR` 状態で終了したジョブには課金されません。
以下の JSON はジョブの `PROGRESSING` ステータスを含むイベントの例です。
```
{
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2022-12-19T19:20:21Z",
"region": "us-west-2",
"resources": [
"arn:aws:mediaconvert:us-west-2:111122223333:jobs/1671477617078-2886ye"
],
"detail": {
"timestamp": 1671477621654,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1671477617078-2886ye",
"status": "PROGRESSING",
"userMetadata": {}
}
}
```
以下のサンプル JSON を使用して、`PROGRESSING` ステータスのジョブについて EventBridge イベントパターンを作成します。
```
{
"source": ["aws.mediaconvert"],
"detail-type": ["MediaConvert Job State Change"],
"detail": {
"status": ["PROGRESSING"]
}
}
```
# STATUS\$1UPDATE ステータスのイベント
MediaConvert はジョブの処理を開始してから約 1 分後に `STATUS_UPDATE` のイベントを送信します。デフォルトでは、その後サービスによってトランスコードが完了するかエラーが発生するまで、更新情報が約 1 分ごとに送信されます。
オプションで、[**Status update interval (ステータス更新間隔)**] 設定を使用してジョブに異なる更新頻度を指定できます。更新頻度を高くするには、10、12、15、20、または 30 秒を選択できます。更新頻度を低くするには、2 分から 10 分の範囲で 1 分単位で選択できます。詳細については、「[ステータスの更新間隔の調整](adjusting-the-status-update-interval.md)」を参照してください。
`STATUS_UPDATE` イベントにはジョブの現在のフェーズについての情報が含まれています。適宜、ジョブの現在のフェーズ、ジョブの進捗度が含まれます。
ジョブのフェーズは以下のとおりです。
+ `PROBING` の間、サービスはトランスコードを開始する準備として入力に関する情報を読み取ります。
+ `TRANSCODING` の間、サービスはコンテンツをデマックス、デコード、エンコード、リマックスします。一部のジョブでは、サービスはまたこのフェーズで出力 Amazon S3 バケットに出力をアップロードし始めます。すべてのトランスコードが完了するとフェーズは終了します。
+ `UPLOADING` の間、サービスは残りのトランスコードされた出力を Amazon S3 バケットにアップロードします。
以下の JSON はジョブの `STATUS_UPDATE` ステータスを含むイベントの例です。
```
{
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2022-12-19T19:21:21Z",
"region": "us-west-2",
"resources": [
"arn:aws:mediaconvert:us-west-2:111122223333:jobs/1671477617078-2886ye"
],
"detail": {
"timestamp": 1671477681737,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1671477617078-2886ye",
"status": "STATUS_UPDATE",
"userMetadata": {},
"framesDecoded": 353,
"jobProgress": {
"phaseProgress": {
"PROBING": {
"status": "COMPLETE",
"percentComplete": 100
},
"TRANSCODING": {
"status": "PROGRESSING",
"percentComplete": 2
},
"UPLOADING": {
"status": "PENDING",
"percentComplete": 0
}
},
"jobPercentComplete": 7,
"currentPhase": "TRANSCODING",
"retryCount": 0
}
}
}
```
以下のサンプル JSON を使用して、`STATUS_UPDATE` ステータスのジョブについて EventBridge イベントパターンを作成します。
```
{
"source": ["aws.mediaconvert"],
"detail-type": ["MediaConvert Job State Change"],
"detail": {
"status": ["STATUS_UPDATE"]
}
}
```
# ステータスの更新間隔の調整
デフォルトでは、 は`STATUS_UPDATE`イベントを Amazon EventBridge に約 1 分に 1 回 AWS Elemental MediaConvert 送信します。これらのステータス更新によりジョブの進行状況に関する情報が提供されます。ジョブ内で別の更新頻度を指定することにより、ステータスの更新間隔を調整できます。
**STATUS\$1UPDATE 頻度を指定するには**
1. **[ジョブの作成]** ページにある左側の **[ジョブ]** ペインで、**[ジョブの設定]** セクションの **[AWS 統合]** を選択します。
1. 右側の **[AWS 統合]** セクションの **[ステータス更新間隔 (秒)]** で、**[更新の間隔 (秒)** を選択します。
API または SDK を使用する場合は、この設定はジョブの JSON ファイルに記載されています。設定名は [StatusUpdateInterval](https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-prop-createjobrequest-statusupdateinterval) です。
# COMPLETE ステータスのイベント
すべての出力がエラーなく Amazon S3 に書き出されたら、MediaConvert は `COMPLETE` のイベントを送信します。これには完了したジョブに関する警告と出力情報が含まれています。出力ファイル名とパスの詳細については、「[出力ファイルの名前とパス](output-file-names-and-paths.md)」を参照してください。
以下の JSON はジョブの `COMPLETE` ステータスを含むイベントの例です。
```
{
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2022-12-19T19:07:12Z",
"region": "us-west-2",
"resources": [
"arn:aws:mediaconvert:us-west-2::jobs/1671476818694-phptj0"
],
"detail": {
"timestamp": 1671476832124,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1671476818694-phptj0",
"status": "COMPLETE",
"userMetadata": {},
"warnings": [
{
"code": 000000,
"count": 1
}
],
"outputGroupDetails": [
{
"outputDetails": [
{
"outputFilePaths": [
"s3://amzn-s3-demo-bucket/file/file.mp4"
],
"durationInMs": 30041,
"videoDetails": {
"widthInPx": 1920,
"heightInPx": 1080,
"qvbrAvgQuality": 7.38,
"qvbrMinQuality": 7,
"qvbrMaxQuality": 8,
"qvbrMinQualityLocation": 2168,
"qvbrMaxQualityLocation": 25025
}
}
],
"type": "FILE_GROUP"
}
],
"paddingInserted": 0,
"blackVideoDetected": 10,
"blackSegments": [
{
"start": 0,
"end": 10
}
]
}
}
```
`COMPLETE` イベントにはジョブと出力についての追加情報が含まれています。以下の表はジョブのイベントメッセージ詳細で得られる様々なプロパティを一覧、説明しています。
**完了イベントメッセージの詳細**
| プロパティ | データ型 | Details |
| --- | --- | --- |
| `paddingInserted` | integer | MediaConvert がジョブのすべての出力に挿入した空白フレームの合計時間 (ミリ秒単位)。 ビデオパディングは空白フレームを挿入して、オーディオとビデオの再生時間を調整しやすくします。`paddingInserted` の値が大きいほど、挿入された空白フレームの数が多くなります。これらの値はまた、入力オーディオトラックがどの程度遅れて開始するか、早く終了するか、あるいはその両方かを示します。 |
| `qvbrAvgQuality` | float | 品質が定義された可変ビットレート (QVBR) 出力の平均ビデオ品質。 QVBR 出力にのみ含まれます。 |
| `qvbrMinQuality` | float | QVBR 出力で最低ビデオ品質が検出されました。 QVBR 出力にのみ含まれます。 |
| `qvbrMaxQuality` | float | QVBR 出力で最大ビデオ品質が検出されました。 QVBR 出力にのみ含まれます。 |
| `qvbrMinQualityLocation` | integer | `qvbrMinQuality` が検出された出力の場所 (ミリ秒単位)。 出力ビデオの品質と帯域幅の使用量を確認している間、`qvbrMinQualityLocation` を使用できます。 QVBR 出力にのみ含まれます。 |
| `qvbrMaxQualityLocation` | integer | `qvbrMaxQuality` が検出された出力の場所 (ミリ秒単位)。 出力ビデオの品質と帯域幅の使用量を確認している間、`qvbrMaxQualityLocation` を使用できます。 QVBR 出力にのみ含まれます。 |
| `warnings` コード count | array integer integer | ジョブで見られた警告コードおよびそれが発生した回数 詳細については、「[警告コード](warning_codes.md)」を参照してください。 |
| `blackVideoDetected` | integer | 出力のブラックビデオフレームのうち、入力にも含まれているものの合計時間 (ミリ秒単位)。 `blackVideoDetected` には MediaConvert が挿入した黒いフレームは含まれません。 |
| `blackVideoSegments` `start` `end` | array integer integer | ブラックビデオフレームが検出された出力中の場所。 出力のブラックビデオの各セグメントはその開始地点と終了地点と共に表示されます。 `blackVideoSegments` には MediaConvert が挿入した黒いフレームは含まれません。 |
| `averageBitrate` | integer | ビデオ出力の平均ビットレートは合計ビットで継続時間を割って計算されます。 |
以下のサンプル JSON を使用して、`COMPLETE` ステータスのジョブについて EventBridge イベントパターンを作成します。
```
{
"source": ["aws.mediaconvert"],
"detail-type": ["MediaConvert Job State Change"],
"detail": {
"status": ["COMPLETE"]
}
}
```
# 出力ファイルの名前とパス
EventBridge ジョブの `COMPLETE` 通知には、JSONの出力についての詳細が含まれます。この情報には、マニフェストとメディア アセットを含む、ジョブの出力のファイル名とパスが含まれます。
が AWS Elemental MediaConvert 作成するファイルは、ジョブで設定した出力グループによって異なります。例えば、DASH ISO パッケージには、.mpd マニフェストと .mp4 メディアフラグメントファイルが含まれています。
以下のプロパティで、出力ファイル名とパス情報を確認できます。
`playlistFilePaths`
マルチバリアントプレイリストへの Amazon S3 ファイルパスのリスト。
`outputFilePaths`
メディアまたはマニフェストへのファイルパス (出力グループのタイプに応じて異なる)。
`type`
出力グループのタイプ。`playlistFilePaths` と `outputFilePaths` に一覧表示されているファイルを決定します。
次の表は、出力グループのタイプに応じて、これらのプロパティの値をまとめたものです。
| タイプ | playlistFilePaths | outputFilePaths |
| --- | --- | --- |
| FILE\$1GROUP (標準出力) | 返されません | メディアファイルのファイル名とパス 例: `s3://amzn-s3-demo-bucket/file/file.mp4` |
| FILE\$1GROUP (追加のフレームキャプチャ出力) | 返されません | 最終的なキャプチャイメージのファイル名とパス 例: `s3://amzn-s3-demo-bucket/frameoutput/file.0000036.jpg` |
| HLS\$1GROUP | 多変量プレイリストのファイル名とパス。 例: `s3://amzn-s3-demo-bucket/hls/main.m3u8` | 個々の出力のマニフェストのファイル名とパス 例: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/mediaconvert/latest/ug/output-file-names-and-paths.html) |
| DASH\$1ISO\$1GROUP | マニフェストのファイル名とパス 例: `s3://amzn-s3-demo-bucket/dash/1.mpd` | 返されません |
| CMAF\$1GROUP | 各トップレベルマニフェストのファイル名とパス 例: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/mediaconvert/latest/ug/output-file-names-and-paths.html) | 返されません |
| MS\$1SMOOTH\$1GROUP | サーバー側マニフェストのファイル名とパス 例: `s3://amzn-s3-demo-bucket/smooth/1.ism` | 個々の出力のビデオマニフェストのファイル名とパス 例: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/mediaconvert/latest/ug/output-file-names-and-paths.html) |
出力グループタイプごとに JSON で応答する サンプル については、以下のトピックを参照してください。
**Topics**
+ [ファイルグループ](file-group.md)
+ [フレームキャプチャ出力を持つファイルグループ](file-group-with-frame-capture-output.md)
+ [Apple HLS グループ](apple-hls-group.md)
+ [DASH ISO グループ](dash-iso-group.md)
+ [CMAF グループ](cmaf-group.md)
+ [Microsoft Smooth Streaming グループ](microsoft-smooth-streaming-group.md)
# ファイルグループ
以下は `COMPLETE` ステータスのジョブの Amazon EventBridge のサンプルイベントです。例にはファイルグループの出力ファイルパス情報が含まれます。
```
{
"detail": {
"status": "COMPLETE",
"paddingInserted": 0,
"blackVideoDetected": 10,
"blackSegments": [
"start": 0,
"end": 10
],
"outputGroupDetails": [
{
"outputDetails": [
{
"outputFilePaths": [
"s3://amzn-s3-demo-bucket/file/file.mp4"
],
"durationInMs": 180041,
"videoDetails": {
"averageBitrate": 200000,
"widthInPx": 1280,
"heightInPx": 720,
"qvbrAvgQuality": 7.38,
"qvbrMinQuality": 7,
"qvbrMaxQuality": 8,
"qvbrMinQualityLocation": 2168,
"qvbrMaxQualityLocation": 25025
},
}
],
"type": "FILE_GROUP"
}
],
"timestamp": 1536964380391,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1536964333549-opn151",
"userMetadata": {},
"warnings": [
{
"code": 000000,
"count": 1
}
],
},
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2018-09-14T21:54:31Z",
"region": "us-west-2",
"resources": [
"arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
]
}
```
**注記**
QVBR 統計値はビデオ出力が品質が定義された可変ビットレート (QVBR) レート制御を使用している場合にのみ利用できます。
# フレームキャプチャ出力を持つファイルグループ
このガイドでは、`COMPLETE` ステータスのジョブの Amazon EventBridge イベント例を示します。これはフレームキャプチャ出力を持つファイルグループの出力ファイルパス情報も示します。
フレームキャプチャ出力は、ビデオの静止画を作成するために設定した出力です。通常の**ファイルグループ**出力グループについても同様に設定します。ただし、オーディオコンポーネントを削除して、コンテナについて **[コンテナなし]** を選択し、次にビデオコーデックについて **[JPEGへのフレームキャプチャ]** を選択します。
**注記**
フレームキャプチャ出力は、通常のオーディオまたはビデオ出力もあるジョブにおいてのみ作成できます。MediaConvert は、フレームキャプチャーのみの出力で構成されるジョブには対応していません。
フレームキャプチャ出力を作成すると、`COMPLETE` ステータスに `outputFilePaths` プロパティが含まれます。これから最終的なキャプチャイメージのファイル名とパスが分かります。
**ヒント**
このサービスには、フレームキャプチャファイル名に自動番号が付いているため、最後からすべてのイメージ名を推測することができます。例えば、`outputFilePaths` 値が `s3://amzn-s3-demo-bucket/frameoutput/file.0000036.jpg` の場合、同じ場所に `file.0000001`、`file.0000002` のような名前の 35 のイメージがあると推測できます。
以下は `COMPLETE` ステータスのジョブの EventBridge のサンプルイベントです。これにはフレームキャプチャ出力を持つファイルグループの出力ファイルパス情報が含まれます。
```
{
"detail": {
"status": "COMPLETE",
"paddingInserted": 0,
"blackVideoDetected": 10,
"blackSegments": [
{
"start": 0,
"end": 10
}
],
"outputGroupDetails": [
{
"outputDetails": [
{
"outputFilePaths": [
"s3://amzn-s3-demo-bucket/frameoutput/file.0000036.jpg"
],
"durationInMs": 185000,
"videoDetails": {
"widthInPx": 1280,
"heightInPx": 720
}
}
],
"type": "FILE_GROUP"
},
{
"outputDetails": [
{
"outputFilePaths": [
"s3://amzn-s3-demo-bucket/file/file.mp4"
],
"durationInMs": 180041,
"blackVideoDurationInMs": 0,
"videoDetails": {
"widthInPx": 1280,
"heightInPx": 720,
"averageQVBRScore": 7.38,
"minimumQVBRScore": 7,
"maximumQVBRScore": 8,
"minimumQVBRScoreLocationInMs": 2168,
"maximumQVBRScoreLocationInMs": 25025
}
}
],
"type": "FILE_GROUP"
}
],
"timestamp": 1536964380391,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1536964333549-opn151",
"userMetadata": {},
"warnings": [
{
"code": 000000,
"count": 1
}
]
},
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2018-09-14T21:54:31Z",
"region": "us-west-2",
"resources": [
"arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
]
}
```
**注記**
品質が定義された可変ビットレート (QVBR) 統計値はビデオ出力が QVBR レート制御を使用している場合にのみ利用できます。
# Apple HLS グループ
以下は `COMPLETE` ステータスのジョブの Amazon EventBridge のサンプルイベントです。これには Apple HLS グループの出力ファイルパス情報が含まれます。
```
{
"detail": {
"status": "COMPLETE",
"paddingInserted": 0,
"blackVideoDetected": 10,
"blackSegments": [
{
"start": 0,
"end": 10
}
],
"outputGroupDetails": [
{
"outputDetails": [
{
"outputFilePaths": [
"s3://amzn-s3-demo-bucket/hls/mainv2.m3u8"
],
"durationInMs": 180041,
"blackVideoDurationInMs": 0,
"videoDetails": {
"widthInPx": 426,
"heightInPx": 240,
"averageQVBRScore": 7.38,
"minimumQVBRScore": 7,
"maximumQVBRScore": 8,
"minimumQVBRScoreLocationInMs": 2168,
"maximumQVBRScoreLocationInMs": 25025
}
},
{
"outputFilePaths": [
"s3://amzn-s3-demo-bucket/hls/mainv1.m3u8"
],
"durationInMs": 180041,
"blackVideoDurationInMs": 0,
"videoDetails": {
"widthInPx": 1280,
"heightInPx": 720,
"averageQVBRScore": 7.38,
"minimumQVBRScore": 7,
"maximumQVBRScore": 8,
"minimumQVBRScoreLocationInMs": 2168,
"maximumQVBRScoreLocationInMs": 25025
}
}
],
"type": "HLS_GROUP",
"playlistFilePaths": [
"s3://amzn-s3-demo-bucket/hls/main.m3u8"
]
}
],
"timestamp": 1536964380391,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1536964333549-opn151",
"userMetadata": {},
"warnings": [
{
"code": 000000,
"count": 1
}
]
},
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2018-09-14T21:54:31Z",
"region": "us-west-2",
"resources": [
"arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
]
}
```
**注記**
品質が定義された可変ビットレート (QVBR) 統計値はビデオ出力が QVBR レート制御を使用している場合にのみ利用できます。
# DASH ISO グループ
以下は `COMPLETE` ステータスのジョブの Amazon EventBridge のサンプルイベントです。これには DASH ISO グループの出力ファイルパス情報が含まれます。
```
{
"detail": {
"status": "COMPLETE",
"paddingInserted": 0,
"blackVideoDetected": 10,
"blackSegments": [
{
"start": 0,
"end": 10
}
],
"outputGroupDetails": [
{
"outputDetails": [
{
"durationInMs": 180041,
"blackVideoDurationInMs": 0,
"videoDetails": {
"widthInPx": 1280,
"heightInPx": 720,
"averageQVBRScore": 7.38,
"minimumQVBRScore": 7,
"maximumQVBRScore": 8,
"minimumQVBRScoreLocationInMs": 2168,
"maximumQVBRScoreLocationInMs": 25025
}
}
],
"type": "DASH_ISO_GROUP",
"playlistFilePaths": [
"s3://amzn-s3-demo-bucket/dash/1.mpd"
]
}
],
"timestamp": 1536964380391,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1536964333549-opn151",
"userMetadata": {},
"warnings": [
{
"code": 000000,
"count": 1
}
]
},
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2018-09-14T21:54:31Z",
"region": "us-west-2",
"resources": [
"arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
]
}
```
**注記**
品質が定義された可変ビットレート (QVBR) 統計値はビデオ出力が QVBR レート制御を使用している場合にのみ利用できます。
# CMAF グループ
以下は `COMPLETE` ステータスのジョブの EventBridge のサンプルイベントです。これには CMAF グループの出力ファイルパス情報が含まれます。
```
{
"detail": {
"status": "COMPLETE",
"paddingInserted": 0,
"blackVideoDetected": 10,
"blackSegments": [
{
"start": 0,
"end": 10
}
],
"outputGroupDetails": [
{
"outputDetails": [
{
"durationInMs": 180041,
"blackVideoDurationInMs": 0,
"videoDetails": {
"widthInPx": 1280,
"heightInPx": 720,
"averageQVBRScore": 7.38,
"minimumQVBRScore": 7,
"maximumQVBRScore": 8,
"minimumQVBRScoreLocationInMs": 2168,
"maximumQVBRScoreLocationInMs": 25025
}
}
],
"type": "CMAF_GROUP",
"playlistFilePaths": [
"s3://amzn-s3-demo-bucket/cmaf/1.mpd",
"s3://amzn-s3-demo-bucket/cmaf/1.m3u8"
]
}
],
"timestamp": 1536964380391,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1536964333549-opn151",
"userMetadata": {},
"warnings": [
{
"code": 000000,
"count": 1
}
]
},
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2018-09-14T21:54:31Z",
"region": "us-west-2",
"resources": [
"arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
]
}
```
**注記**
品質が定義された可変ビットレート (QVBR) 統計値はビデオ出力が QVBR レート制御を使用している場合にのみ利用できます。
# Microsoft Smooth Streaming グループ
以下は `COMPLETE` ステータスのジョブの EventBridge のサンプルイベントです。これには Microsoft Smooth Streaming グループの出力ファイルパス情報が含まれます。
```
{
"detail": {
"status": "COMPLETE",
"paddingInserted": 0,
"blackVideoDetected": 10,
"blackSegments": [
{
"start": 0,
"end": 10
}
],
"outputGroupDetails": [
{
"outputDetails": [
{
"outputFilePaths": [
"s3://amzn-s3-demo-bucket/smooth/1_va.ismv"
],
"durationInMs": 180041,
"blackVideoDurationInMs": 0,
"videoDetails": {
"widthInPx": 1280,
"heightInPx": 534,
"averageQVBRScore": 7.38,
"minimumQVBRScore": 7,
"maximumQVBRScore": 8,
"minimumQVBRScoreLocationInMs": 2168,
"maximumQVBRScoreLocationInMs": 25025
}
}
],
"type": "MS_SMOOTH_GROUP",
"playlistFilePaths": [
"s3://amzn-s3-demo-bucket/smooth/1.ism"
]
}
],
"timestamp": 1536964380391,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1536964333549-opn151",
"userMetadata": {},
"warnings": [
{
"code": 000000,
"count": 1
}
]
},
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2018-09-14T21:54:31Z",
"region": "us-west-2",
"resources": [
"arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
]
}
```
**注記**
品質が定義された可変ビットレート (QVBR) 統計値はビデオ出力が QVBR レート制御を使用している場合にのみ利用できます。
# CANCELED ステータスのイベント
MediaConvert はジョブがキャンセルされると、`CANCELED` イベントを送信します。これには、`timestamp`、`accountID`、`queue`、`jobId`、`userMetadata` を含む基本的なジョブの詳細が含まれます。
以下の JSON はジョブの `CANCELED` ステータスを含むイベントの例です。
```
{
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2018-01-07T23:35:20Z",
"region": "us-west-2",
"resources": ["arn:aws:mediaconvert:us-west-2:111122223333:jobs/1515368087458-qnoxtd"],
"detail": {
"timestamp": 1515368120764,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1515368087458-qnoxtd",
"status": "CANCELED",
"userMetadata": {}
}
}
```
以下のサンプル JSON を使用して、`CANCELED` ステータスのジョブについて EventBridge イベントパターンを作成します。
```
{
"source": ["aws.mediaconvert"],
"detail-type": ["MediaConvert Job State Change"],
"detail": {
"status": ["CANCELED"]
}
}
```
# ERROR ステータスのイベント
1 つ以上の出力にエラーがある場合、MediaConvert は `ERROR` イベントを送信します。これには、エラーコードとメッセージ、およびジョブのエラーステータスに関する警告や他の一時的なジョブ情報が含まれます。エラーコードの詳細については、「[エラーコード](mediaconvert_error_codes.md)」を参照してください。
以下の JSON はジョブの `ERROR` ステータスを含むイベントの例です。
```
{
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2018-01-07T23:35:20Z",
"region": "us-west-2",
"resources": ["arn:aws:mediaconvert:us-west-2:111122223333:jobs/1515368087458-qnoxtd"],
"detail": {
"timestamp": 1515368120764,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1515368087458-qnoxtd",
"status": "ERROR",
"errorCode": 1040,
"errorMessage": "Example error message",
"userMetadata": {}
}
}
```
以下のサンプル JSON を使用して、`ERROR` ステータスのジョブについて EventBridge イベントパターンを作成します。
```
{
"source": ["aws.mediaconvert"],
"detail-type": ["MediaConvert Job State Change"],
"detail": {
"status": ["ERROR"]
}
}
```
# NEW\$1WARNING ステータスのイベント
警告の条件が生じると、MediaConvert は `NEW_WARNING` イベントを送信します。警告の条件が生じても、ジョブの実行は停止されません。これは、送信キュー ARN、ジョブ ID、および警告メッセージを含みます。警告メッセージは、ジョブを停止しない条件を通知しますが、ジョブが計画どおりに進行していないことを示している可能性があります。
例えば、キューをホップするように設定したジョブは、指定した待機時間に達してもホップできません。
`NEW_WARNING` には最も最近の警告メッセージのみが含まれます。警告の条件が有効なままであっても、その前の警告については報告しません。
警告メッセージの詳細については、「[警告コード](warning_codes.md)」を参照してください。
以下の JSON はジョブの `NEW_WARNING` ステータスを含むイベントの例です。
```
{
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2018-01-07T23:35:20Z",
"region": "us-west-2",
"resources": ["arn:aws:mediaconvert:us-west-2:111122223333:jobs/1515368087458-qnoxtd"],
"detail": {
"timestamp": 1515368120764,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1515368087458-qnoxtd",
"status": "NEW_WARNING",
"warningCode": "000000",
"warningMessage": "Example warning message",
"userMetadata": {}
}
}
```
以下のサンプル JSON を使用して、`NEW_WARNING` ステータスのジョブについて EventBridge イベントパターンを作成します。
```
{
"source": ["aws.mediaconvert"],
"detail-type": ["MediaConvert Job State Change"],
"detail": {
"status": ["NEW_WARNING"]
}
}
```
# QUEUE\$1HOP ステータスのイベント
MediaConvert はジョブがキューをホップすると、`QUEUE_HOP` イベントを送信します。両方のキューの ARN と、キュー内のジョブの優先度が含まれます。
キューのホッピング設定でジョブにキューをホップする際の新しい優先度を指定しないかぎり、`priority` と `previousPriority` は同じです。
以下の JSON はジョブの `QUEUE_HOP` ステータスを含むイベントの例です。
```
{
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2018-01-07T23:35:20Z",
"region": "us-west-2",
"resources": ["arn:aws:mediaconvert:us-west-2:111122223333:jobs/1515368087458-qnoxtd"],
"detail": {
"timestamp": 1515368120764,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"previousQueue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Alternate",
"priority": 0,
"previousPriority": 0,
"jobId": "1515368087458-qnoxtd",
"status": "QUEUE_HOP",
"userMetadata": {}
}
}
```
以下のサンプル JSON を使用して、`QUEUE_HOP` ステータスのジョブについて EventBridge イベントパターンを作成します。
```
{
"source": ["aws.mediaconvert"],
"detail-type": ["MediaConvert Job State Change"],
"detail": {
"status": ["QUEUE_HOP"]
}
}
```