Création de fonctions

Vous créez une fonction en deux étapes :

1. Créez le code de fonction sous la forme JavaScript. Vous pouvez utiliser l'exemple par défaut de la CloudFront console ou écrire le vôtre. Pour plus d’informations, consultez les rubriques suivantes :

   • Écrire le code de la fonction

   • CloudFront Fonctions, structure de l'événement

   • Exemple de code pour CloudFront Functions

2. CloudFront À utiliser pour créer la fonction et inclure votre code. Le code existe à l’intérieur de la fonction (et non en tant que référence).

Console

Pour créer une fonction

1. Connectez-vous à la CloudFront console à l'adresse https://console.aws.amazon.com/cloudfront/v4/home#/functions et sélectionnez la page Fonctions.

2. Choisissez Créer une fonction.

3. Entrez un nom de fonction unique dans le Compte AWS, choisissez la JavaScript version, puis choisissez Continuer. La page de détails s’affiche pour la nouvelle fonction.

   Note

   Pour utiliser des paires clé-valeur dans la fonction, vous devez choisir JavaScript runtime 2.0.

4. Dans la section Code de fonction, choisissez l'onglet Créer et entrez votre code de fonction. L’exemple de code inclus dans l’onglet Création illustre la syntaxe de base du code de fonction.

5. Sélectionnez Enregistrer les modifications.

6. Si le code de fonction utilise des paires clé-valeur, vous devez associer un magasin clé-valeur.

   Vous pouvez associer le magasin de valeurs clés lorsque vous créez la fonction pour la première fois. Vous pouvez également l'associer ultérieurement, en mettant à jour la fonction.

   Pour associer un magasin de clés-valeurs dès maintenant, procédez comme suit :

   • Accédez à la KeyValueStore section Associer et choisissez Associer existant KeyValueStore.

   • Sélectionnez le magasin clé-valeur qui contient les paires clé-valeur de la fonction, puis choisissez Associer. KeyValueStore

   CloudFront associe immédiatement le magasin à la fonction. Vous n’avez pas besoin d’enregistrer la fonction.

CLI

Si vous utilisez la CLI, vous commencez généralement par créer le code de fonction dans un fichier, puis vous créez la fonction avec AWS CLI.

Pour créer une fonction

1. Créez le code de fonction dans un fichier et stockez-le dans un répertoire auquel votre ordinateur peut se connecter.

2. Exécutez la commande, comme illustré dans l’exemple. Cet exemple utilise la fileb:// notation pour transmettre le fichier. Il inclut également des sauts de ligne pour rendre la commande plus lisible.

   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
   

   Remarques

   • Runtime— La version de JavaScript. Pour utiliser des paires clé-valeur dans la fonction, vous devez spécifier la version 2.0.

   • KeyValueStoreAssociations— Si votre fonction utilise des paires clé-valeur, vous pouvez associer le magasin de valeurs clé lorsque vous créez la fonction pour la première fois. Vous pouvez également l'associer ultérieurement, en utilisantupdate-function. Quantity a toujours pour valeur 1, car chaque fonction peut être associée uniquement à un seul magasin de clés-valeurs.

   Lorsque la commande s’exécute correctement, vous obtenez une sortie similaire à ce qui suit.

   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

   La plupart des informations proviennent de la demande. D'autres informations sont ajoutées par CloudFront.

   Remarques

   • ETag— Cette valeur change chaque fois que vous modifiez le magasin de valeurs clés. Vous utilisez cette valeur et le nom de la fonction pour référencer la fonction à l'avenir. Assurez-vous de toujours utiliser le courantETag.

   • FunctionARN— L'ARN de votre CloudFront fonction.

   • 111122223333 — Le. Compte AWS

   • Stage— Le stade de la fonction (LIVEouDEVELOPMENT).

   • Status— Le statut de la fonction (PUBLISHEDouUNPUBLISHED).

Une fois que vous avez créé la fonction, elle est ajoutée à la DEVELOPMENT scène. Nous vous recommandons de tester votre fonction avant de la publier. Une fois que vous avez publié votre fonction, celle-ci passe à l'LIVEétape.