関数を作成する
関数は 2 段階で作成します。
-
関数コードを JavaScript として作成します。CloudFront コンソールのデフォルトの例を使用することも、独自に記述することもできます。詳細については、以下の各トピックを参照してください。
-
CloudFront を使用して関数を作成し、コードを含めます。コードは関数内にあります (リファレンスとしてではありません)。
- Console
-
関数を作成するには
-
CloudFront コンソール (https://console.aws.amazon.com/cloudfront/v4/home#/functions
) にサインインし、[関数] ページを選択します。 -
[Create function (関数の作成)] を選択します。
-
AWS アカウント内での一意な関数名を入力し、Java Script バージョンを選択して、[続行] を選択します。新しい関数の詳細ページが表示されます。
注記
関数で [キーと値のペア] を使用する場合は、Java Script ランタイム 2.0 を選択する必要があります。
-
[関数コード] セクションで、[ビルド] タブを選択し、関数コードを入力します。[ビルド] タブに含まれるサンプルコードは、関数コードの基本的な構文を示しています。
-
[Save changes] (変更の保存) をクリックします。
-
関数コードでキーと値のペアを使用する場合は、キー値ストアを関連付ける必要があります。
キー値ストアは、関数の作成時に関連付けることができます。または、後で関数を更新して関連付けることもできます。
キーと値のストアを今すぐ関連付けるには、次の手順に従います。
-
[KeyValueStore を関連付け] セクションに移動して、[既存の KeyValueStore を関連付け] を選択します。
-
関数のキーと値のペアを含むキーバリューストアを選択し、[KeyValueStore を関連付ける] を選択します。
CloudFront はストアを直ちに関数に関連付けます。関数を保存する必要はありません。
-
-
- CLI
-
CLI を使用する場合、通常は最初に関数コードをファイルに作成し、次に AWS CLI を使用して関数を作成します。
関数を作成するには
-
関数コードをファイルに作成し、コンピュータが接続できるディレクトリに保存します。
-
次の例に示すようにコマンドを実行します。この例では、
fileb://
表記を使用してファイルを渡します。コマンドを読みやすくするために改行も含まれています。aws cloudfront create-function \ --name MaxAge \ --function-config '{"Comment":"Max Age 2 years","Runtime":"cloudfront-js-2.0","KeyValueStoreAssociations":{"Quantity":1,"Items":[{"KeyValueStoreARN":"arn:aws:cloudfront::111122223333:key-value-store/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"}]}}' \ --function-code fileb://function-max-age-v1.js
メモ
-
Runtime
– Java Script のバージョン。関数でキーと値のペアを使用するには、バージョン 2.0 を指定する必要があります。 -
KeyValueStoreAssociations
– 関数がキーと値のペアを使用する場合、関数の初回作成時にキー値ストアを関連付けることができます。または、update-function
を使用して後で関連付けることもできます。各関数に関連付けることができるキー値ストアは 1 つだけのため、Quantity
は常に1
です。
コマンドが成功した場合は、以下のような出力が表示されます。
ETag: ETVABCEXAMPLE FunctionSummary: FunctionConfig: Comment: Max Age 2 years Runtime: cloudfront-js-2.0 KeyValueStoreAssociations= \ {Quantity=1, \ Items=[{KeyValueStoreARN='arn:aws:cloudfront::111122223333:key-value-store/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111'}]} \ FunctionMetadata: CreatedTime: '2021-04-18T20:38:56.915000+00:00' FunctionARN: arn:aws:cloudfront::111122223333:function/MaxAge LastModifiedTime: '2023-11-19T20:38:56.915000+00:00' Stage: DEVELOPMENT Name: MaxAge Status: UNPUBLISHED Location: https://cloudfront.amazonaws.com/2020-05-31/function/arn:aws:cloudfront:::function/MaxAge
ほとんどの情報はリクエストから繰り返されます。その他の情報は CloudFront によって追加されます。
メモ
-
ETag
– この値は、キー値ストアを変更するたびに変わります。この値と関数名を使用して、以後、この関数を参照します。必ず現在のETag
を使用してください。 -
FunctionARN
– CloudFront 関数の ARN。 -
111122223333 – AWS アカウント。
-
Stage
– 関数のステージ (LIVE
またはDEVELOPMENT
)。 -
Status
– 関数のステータス (PUBLISHED
またはUNPUBLISHED
)。
-
-
関数を作成すると、DEVELOPMENT
ステージに追加されます。関数は、テストしてから発行することをお勧めします。関数を発行すると、関数のステージは LIVE
に変わります。