Create a key value store

To create a key value store

1. Sign in to the AWS Management Console and open the Functions page in the CloudFront console at https://console.aws.amazon.com/cloudfront/v4/home#/functions.

2. Choose the KeyValueStores tab, and then choose Create KeyValueStore.

3. Enter a name and optional description for the key value store.

4. Complete S3 URI:

   • If you have a file of key-value pairs, enter the path to the Amazon S3 bucket where you stored the file.

   • Leave this field blank if you plan to enter the key-value pairs manually.

5. Choose Create. The key value store now exists.

   The details page for the new key value store appears. The information on the page includes the ID and the ARN of the key value store.

   • The ID is a random string of characters that is unique in your AWS account.

   • The ARN has this syntax:

     AWS account:key-value-store/the key value stores ID

6. Look at the Key value pairs section. If you imported a file, this section shows some key-value pairs. You can do the following:

   • If you imported a file, you can also add more values manually.

   • If you didn't import a file from an Amazon S3 bucket, and if you want to add key-value pairs now, you can complete the next step.

   • You can skip this step and add the key-value pairs later.

7. To add the pairs now:

   1. Choose Add key-value pairs.

   2. Choose Add pair and enter a name and value. Repeat this step to add more pairs.

   3. When you're finished, choose Save changes to save all the key-value pairs in the key value store. On the dialog box that appears, choose Done.

8. To associate the key value store with a function now, complete the Associated functions section. For more information, see Create functions or Update functions.

   You can also associate the function later, either from this key value store details page, or from the function's details page.

To create a key value store

• Run the following command to create a key value store and import the key-value pairs from an Amazon S3 bucket.

  aws cloudfront create-key-value-store \
      --name=keyvaluestore1 \
      --comment="This is my key value store file" \
      --import-source=SourceType=S3,SourceARN=arn:aws:s3:::amzn-s3-demo-bucket1/kvs-input.json

  Response

  {
      "ETag": "ETVABCEXAMPLE",
      "Location": "https://cloudfront.amazonaws.com/2020-05-31/key-value-store/arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example",
      "KeyValueStore": {
          "Name": "keyvaluestore1",
          "Id": "8aa76c93-3198-462c-aaf6-example",
          "Comment": "This is my key value store file",
          "ARN": "arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example",
          "Status": "PROVISIONING",
          "LastModifiedTime": "2024-08-06T22:19:10.813000+00:00"
      }
  }