# Amazon CloudFront KeyValueStore
<a name="kvs-with-functions"></a>

O KeyValueStore do CloudFront é um datastore de valor de chave seguro, global e de baixa latência que permite acesso de leitura por meio do [CloudFront Functions](cloudfront-functions.md), viabilizando uma lógica personalizada avançada nos locais da borda do CloudFront. 

Com o KeyValueStore do CloudFront, você faz atualizações no código da função e nos dados associados a uma função, de modo independente uns dos outros. Essa separação simplifica o código da função e facilita a atualização dos dados sem a necessidade de implantar alterações no código. 

**nota**  
Para usar o CloudFront KeyValueStore, a função do CloudFront deve usar o [runtime 2.0 do JavaScript.](functions-javascript-runtime-20.md)

Veja a seguir o procedimento geral para usar pares de chave-valor: 
+ Crie armazenamentos de chave-valor e preencha-os com um conjunto de pares de chave-valor. É possível adicionar seus armazenamentos de chave-valor a um bucket do Amazon S3 ou inseri-los manualmente.
+ Associe os armazenamentos de chave-valor ao CloudFront Functions.
+ No código da função, use o nome da chave para recuperar o valor associado a ela ou para avaliar se existe uma chave. Consulte mais informações sobre o uso de pares de chave-valor no código da função e sobre métodos auxiliares em [Métodos auxiliares para armazenamentos de chave-valor](functions-custom-methods.md).

## Casos de uso
<a name="key-value-store-use-cases"></a>

É possível usar pares de chave-valor para os seguintes exemplos:
+ **Regravações ou redirecionamentos de URL**: o par de chave-valor pode conter os URLs regravados ou os URLs de redirecionamento.
+ **Testes A/B e sinalizadores de recursos**: é possível criar uma função para realizar experimentos atribuindo uma porcentagem do tráfego a uma versão específica do site. 
+ **Autorização de acesso**: é possível implementar o controle de acesso para permitir ou negar solicitações com base nos critérios definidos e nos dados armazenados no armazenamento de chave-valor.

## Formatos compatíveis de valores
<a name="key-value-store-supported-formats"></a>

É possível armazenar o valor em um par de chave-valor em qualquer um dos seguintes formatos:
+ String
+ String codificada por bytes
+ JSON 

## Segurança
<a name="key-value-store-security"></a>

O CloudFront Functions e todos os dados de armazenamento de chave-valor são tratados com segurança, da seguinte forma:
+ O CloudFront criptografa cada armazenamento de chave-valor em repouso e em trânsito (ao ler ou gravar no armazenamento de chave-valor) ao chamar as operações da API [KeyValueStore do CloudFront](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_Operations_Amazon_CloudFront_KeyValueStore.html).
+ Quando a função é executada, o CloudFront descriptografa cada par de chave-valor na memória nos locais da borda do CloudFront. 

Para começar a usar o KeyValueStore do CloudFront, consulte os tópicos a seguir. 

**Topics**
+ [Casos de uso](#key-value-store-use-cases)
+ [Formatos compatíveis de valores](#key-value-store-supported-formats)
+ [Segurança](#key-value-store-security)
+ [Trabalhar com o armazenamento de chave-valor](kvs-with-functions-kvs.md)
+ [Trabalhar com dados de chave-valor](kvs-with-functions-kvp.md)
+ Para ter mais informações sobre os conceitos básicos do KeyValueStore do CloudFront, consulte a postagem do blog [Apresentação do KeyValueStore do Amazon CloudFront.](https://aws.amazon.com/blogs/aws/introducing-amazon-cloudfront-keyvaluestore-a-low-latency-datastore-for-cloudfront-functions/)AWS