View a markdown version of this page

関数の作成と管理 - AWS Elemental MediaTailor
関数のセットアップ関数の管理関数の削除検証ルールAPI リファレンス

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

関数の作成と管理

このページでは、MediaTailor コンソールを使用して Functions を作成、アタッチ、更新、削除する方法について説明します。関数を使用すると、再生中にキーポイントでロジックを実行して、セッション動作と広告リクエストをカスタマイズできます。

関数のセットアップ

コンソールを使用した関数の作成

  1. MediaTailor コンソール (https://console.aws.amazon.com/mediatailor/) を開きます。

  2. ナビゲーションペインで、[Functions] (関数) を選択します。

  3. [関数の作成] を選択してください。

  4. 関数 ID には、関数の一意の名前 (例: ) を入力しますfetchIdentity。

  5. 関数タイプで、CUSTOM_OUTPUT、HTTP_REQUEST、または を選択しますSEQUENTIAL_EXECUTOR。コンソールには、選択したタイプの設定フィールドが表示されます。

  6. タイプ固有の設定フィールドに入力します。各関数タイプとそのフィールドの説明については、「」を参照してください関数のタイプと構成。

  7. [関数の作成] を選択してください。

関数を再生設定にアタッチする

関数は、関数マッピング (ライフサイクルフックと関数間のリンク) を介して再生設定にアタッチするまで実行されません。関数マッピングは、関数をトリガーするライフサイクルフックを指定します。

  1. MediaTailor コンソールを開きます。

  2. ナビゲーションペインで [Configurations] (設定) をクリックします。

  3. 更新する再生設定を選択します。

  4. 関数マッピングセクションで、編集 を選択します。

  5. ライフサイクルフックごとに、アタッチする関数を選択します。

    • セッション初期化フック — セッション開始時に 1 回実行する関数を選択します。

    • 広告リクエストフック — 各 ADS リクエストの前に実行する関数を選択します。

  6. [保存] を選択します。

関数の管理

関数の表示

Functions に移動して、アカウント内のすべての関数を表示します。設定を表示するには、関数名を選択します。

既存の 関数の更新

関数を更新するには、関数に移動し、関数を選択して、設定を変更します。更新により、関数定義全体が置き換えられます。

ヒント

変更を行う前に、関数設定のコピーを保存します。関数には組み込みのバージョニングやロールバックはありません。

関数の削除

再生設定から関数をデタッチする

関数を削除する前に、それを参照するすべての再生設定から削除します。

  1. MediaTailor コンソールを開きます。

  2. ナビゲーションペインで [Configurations] (設定) をクリックします。

  3. 再生設定を選択します。

  4. 関数マッピングセクションで、編集 を選択します。

  5. ライフサイクルフックから 関数を削除します。

  6. [保存] を選択します。

関数の削除

関数に移動し、関数を選択し、削除を選択します。

削除ブロックルール

MediaTailor では、まだ使用中の関数を削除することはできません。

Condition 結果
関数は、関数マッピングを介して再生設定にアタッチされます。 削除はブロックされます。最初に関数をデタッチします。
関数は で参照されます SEQUENTIAL_EXECUTOR 削除はブロックされます。最初に親関数から参照を削除します。
関数はどこにも参照されません 削除は成功しました。

検証ルール

MediaTailor は、関数を作成または更新するときに関数を検証します。次のチェックが実行されます。

  • 式構文 — すべての式は有効な JSONata である必要があります。

  • 制限された関数 — 式は制限された JSONata 関数を呼び出すことはできません。完全なリストJSONata 式リファレンスについては、「」を参照してください。

  • 出力キープレフィックス — すべての出力キーは、認識された名前空間プレフィックスで始まる必要があります。使用できるプレフィックスのリストについては、「」を参照してくださいライフサイクルフック。

  • 関数参照 — 内のすべての関数 IDs既存の関数を参照FunctionListする必要があります。

  • 循環参照 — 関数は、直接または間接的にそれ自体を参照することはできません。

  • ネスト深度 — は他の関数を呼び出すSEQUENTIAL_EXECUTORことができますが、それらの関数自体を SEQUENTIAL_EXECUTORにすることはできません。

特定の値とサイズ制限については、「」を参照してください制限。

API リファレンス

関数をプログラムで管理するには、 AWS Elemental MediaTailor API リファレンスを参照してください。