入門
Dynamic DeliveryIngestに次の機能が追加されました優先キューイングこれにより、パブリッシャーは、ジョブが処理される順序と適時性に影響を与えるために、必要な優先順位設定で取り込みジョブを送信できます。
動的配信の取り込みキューイングのしくみ
通常の優先キューイングでは、Dynamic DeliveryIngestionにはアカウントごとに100のアクティブなジョブの制限があります。その制限を超えると、取り込みシステムは後で処理するために追加の要求をキューに入れます。キューのサイズには個別の制限があり、それに達すると、顧客への取り込み要求を拒否します(429エラーコードを使用)。ジョブが終了すると、容量が解放され、キューに入れられたジョブが、受信された順序で一度に1つずつピックアップされて処理されます。
のビデオステータスCMS APIジョブがキューに入れられたことを反映していません-ステータスは次のようになりますpending
ジョブが処理中であるかキューに入れられているか。
優先キューイングが摂取に与える影響
優先キューイングにより、ユーザーはpriority
取り込み要求にフラグを立てます。の許容値priority
ですlow
そしてnormal
。その他の値を指定すると、リクエストは422エラーコードで拒否されます。ユーザーが優先度を指定しない場合、デフォルト値はnormal
使用されている。優先キューイングによって、キューからのジョブの処理方法がどのように変わるかについて簡単に説明します。
- キューに入れられたジョブがなく、ジョブを実行する容量がある場合、ジョブはすぐに実行されます。これは、優先度の低いジョブと通常のジョブの両方に適用されます。
- 別のジョブを実行するための容量がない場合、ジョブはキューに入れられます。
- キューにジョブがある場合は、新しいジョブもキューに入れられます。これは、キューに入れられたジョブの前に新しいジョブを開始できないことを意味します。
- 別のジョブを実行する容量があり、キューに入れられたジョブがある場合、ジョブはキューから取得されます。
- キューに通常の優先度のジョブがある場合は、最も古い通常の優先度のジョブが選択されます。
- キューに通常の優先度のジョブがない場合は、最も古い優先度の低いジョブが選択されます。
- 通常および低優先度のジョブは扱われます同じ実行中のジョブの数。処理するジョブの総数は、優先度に関係なく、アカウントごとに100に制限されています。
- がある分けるキューに入れることができる通常のジョブと優先度の低いジョブの数のクォータ。
注意すべき点
求人の送信後にレンディションの詳細が変更されました
動的取り込みジョブを作成すると、指定された取り込みプロファイルが動的取り込みシステムによってコピーされ、そのプロファイルがコピージョブの送信後にプロファイルが変更された場合でも、処理に使用されます。
場合によっては処理がかなりの時間遅延する可能性がある優先度の低いジョブの場合、そのプロファイルで指定されたレンディションは変更される可能性がありますジョブが実際に処理される前。その場合、ビデオの処理に使用されるレンディションは新着それらのレンディションの定義。ジョブが送信されたときのレンディションの定義ではありません。
あなたがしたい場合保証あなたはレンディションを取得しますジョブが送信されたときに指定されたとおり、レンディションのコピーを作成し、それらのコピーされたレンディションを参照する新しいプロファイルを作成してから、取り込みプロセスを開始する必要があります。(ビデオがすでにVideo Cloudに配置されている場合は、更新されたプロファイルを使用してビデオを再トランスコードできます。元のジョブの処理が完了するまで、ビデオを再トランスコードできないことに注意してください。)
ソースファイルのアップロード
ソースファイルをアップロードすると、24時間後にそのS3バケット内のファイルが削除されます。優先度の低いジョブは24時間以上処理されない場合があるため、ファイルはすでに削除されている可能性があり、その場合の処理は失敗します。ソースファイルのアップロードに優先度の低い取り込みをお勧めしません。
サンプルリクエスト
以下は、優先度の低い取り込みリクエスト本文のサンプルです。
{
"master": {
"url": "http://host/master.mp4"
},
"profile": "multi-platform-extended-static",
"priority": "low",
"callbacks": [
"http://mydomain.com/di-callbacks.php"
]
}
そして、これが通常の優先ジョブのサンプルです。
{
"master": {
"url": "http://host/master.mp4"
},
"profile": "multi-platform-extended-static",
"priority": "normal",
"callbacks": [
"http://mydomain.com/di-callbacks.php"
]
}
以来注意してくださいnormal
がデフォルト値の場合、前のリクエストは次のリクエストとまったく同じ方法で処理されます。
{
"master": {
"url": "http://host/master.mp4"
},
"profile": "multi-platform-extended-static",
"callbacks": [
"http://mydomain.com/di-callbacks.php"
]
}
優先キューの使用
前のセクションの最後の例から、そうする場合は明らかであるはずですない使用priority
取り込みジョブのフィールドでは、以前とまったく同じように処理され続けます。
の追加priority
フィールドは主に次の場合に役立ちます。
- かなりの数のビデオを摂取します
- 取得することが重要です いくつか 他の人を公開する緊急性はありませんが、できるだけ早くオンラインで動画を公開します(コンテンツの重要性が低いか、動画をすぐに公開する予定がないため)
- 再トランスコードしたい動画がありますが、それによって新しいコンテンツの取り込みが遅くなることは望ましくありません。
低優先度キューのしくみ
このセクションでは、優先度の低いキューがどのように機能するかについて説明します。
通常のジョブまたは優先度の低いジョブがいつ開始されるかは保証されません。ただし、通常の優先度のジョブは、常に優先度の低いジョブの前に開始されます。
通常の優先度のジョブを送信する速度が安定して速い場合、優先度の低いジョブが開始されるまでにかなりの時間がかかる可能性があります。
優先度の低いジョブは、同じビデオの通常の優先度よりも開始に時間がかかり、処理にも時間がかかる場合があります。