Tutorial: Creating a simple function with CloudFront Functions

To create a function in the CloudFront console

1. Sign in to the Amazon Web Services Management Console and open the CloudFront console at https://console.amazonaws.cn/cloudfront/v4/home.

2. In the navigation pane, choose Functions and then choose Create function.

3. On the Create function page, for Name, enter a function name such as MyFunctionName.

4. (Optional) For Description, enter a description for the function such as Simple test function.

5. For Runtime, keep the default selected JavaScript version.

6. Choose Create function.

7. Copy the following function code. This function code redirects the viewer to a different URL, and also returns a custom response header.

   function handler(event) {
       // NOTE: This example function is for a viewer request event trigger. 
       // Choose viewer request for event trigger when you associate this function with a distribution. 
       var response = {
           statusCode: 302,
           statusDescription: 'Found',
           headers: {
               'cloudfront-functions': { value: 'generated-by-CloudFront-Functions' },
               'location': { value: 'https://aws.amazon.com/cloudfront/' }
           }
       };
       return response;
   }

8. For Function code, paste the code into the code editor to replace the default code.

9. Choose Save changes.

10. (Optional) You can test the function before you publish it. This tutorial doesn’t describe how to test a function. For more information, see Testing functions.

11. Choose the Publish tab and then choose Publish function. You must publish the function before you can associate it with your CloudFront distribution.

12. Next, you can associate the function with a distribution or cache behavior. On the MyFunctionName page, choose the Publish tab.

    Warning

    In the following steps, choose a distribution or a cache behavior that’s used for testing. Don’t associate this test function with a distribution or cache behavior that’s used in production.

13. Choose Add association.

14. On the Associate dialog box, choose a distribution and/or a cache behavior. For Event type, keep the default value.

15. Choose Add association.

    The Associated distributions table shows the associated distribution.

16. Wait a few minutes for the associated distribution to finish deploying. To check the distribution’s status, select the distribution in the Associated distributions table and then choose View distribution.

    When the distribution’s status is Deployed, you’re ready to verify that the function works.