Criar um armazenamento de chave-valor

Você pode criar um armazenamento de chave-valor e os pares de chave-valor ao mesmo tempo. Também é possível criar um armazenamento de chave-valor vazio e adicionar pares de chave-valor posteriormente.

nota

Se você especificar sua fonte de dados a partir de um bucket do Amazon S3, deverá ter as permissões s3:GetObject e s3:GetBucketLocation para esse bucket. Se você não tiver essas permissões, o CloudFront não poderá criar seu armazenamento de chave-valor com êxito.

Decida se deseja adicionar pares de chave-valor ao mesmo tempo em que cria o armazenamento de chave-valor. É possível importar os pares de chave-valor usando o console do CloudFront, a API do CloudFront ou os SDKs da AWS. No entanto, só é possível importar o arquivo de pares de chave-valor ao criar inicialmente o armazenamento de chave-valor.

Para criar um arquivo de pares de chave-valor, consulte Formato de arquivo para pares de chave-valor.

Console

Como criar um armazenamento de chave-valor

1. Faça login no AWS Management Console e abra a página Functions (Funções) no console do CloudFront em https://console.aws.amazon.com/cloudfront/v4/home#/functions.

2. Escolha a guia KeyValueStores e selecione Criar KeyValueStore.

3. Informe um nome e uma descrição opcional para o armazenamento de valores de chave.

4. Preencha o URI do S3:

   • Se você tem um arquivo de pares de chave-valor, insira o caminho para o bucket do Amazon S3 no qual armazenou o arquivo.

   • Deixe esse campo em branco se planeja inserir os pares de chave-valor manualmente.

5. Escolha Criar. O armazenamento de chave-valor existe agora.

   A página de detalhes do novo armazenamento de valores de chave é exibida. As informações na página incluem o ID e o ARN do armazenamento de valores de chave.

   • O ID é uma string de caracteres aleatória exclusiva na Conta da AWS.

   • O ARN tem esta sintaxe:

     Conta da AWS:key-value-store/o ID de armazenamentos de chave-valor

6. Veja a seção Pares de chave-valor. Se você importou um arquivo, essa seção mostrará alguns pares de chave-valor. Você pode fazer o seguinte:

   • Se você importou um arquivo, também poderá adicionar mais valores manualmente.

   • Se você não importou um arquivo de um bucket do Amazon S3 e deseja adicionar pares de chave-valor agora, poderá concluir a próxima etapa.

   • É possível ignorar essa etapa e adicionar os pares de chave-valor posteriormente.

7. Como adicionar os pares agora:

   1. Selecione Adicionar pares de chave-valor.

   2. Selecione Adicionar par e insira um nome e um valor. Repita essa etapa para adicionar mais pares.

   3. Ao terminar, selecione Salvar alterações para salvar todos os pares de chave-valor no armazenamento de valores de chave. Na caixa de diálogo exibida, selecione Concluído.

8. Para associar agora o armazenamento de valores de chave a uma função agora, preencha a seção Funções associadas. Para obter mais informações, consulte Criar funções ou Atualizar funções.

   Também é possível associar a função posteriormente, na página de detalhes do armazenamento de valores de chave ou na página de detalhes da função.

AWS CLI

Como criar um armazenamento de chave-valor

• Execute o comando a seguir para criar um armazenamento de chave-valor e importar os pares de chave-valor de um bucket do Amazon S3.

  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

  Resposta

  {
      "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"
      }
  }

API

Como criar um armazenamento de chave-valor

1. Use a operação CreateKeyValueStore do CloudFront. A operação usa vários parâmetros:

   • Um name do armazenamento de chave-valor.

   • Um parâmetro comment que inclua um comentário.

   • Um parâmetro import-source que permita importar pares de chave-valor de um arquivo armazenado em um bucket do Amazon S3. É possível importar de um arquivo somente durante a criação inicial do armazenamento de chave-valor. Para ter informações sobre a estrutura de arquivos, consulte Formato de arquivo para pares de chave-valor.

A resposta da operação inclui as seguintes informações:

• Os valores transmitidos na solicitação, incluindo o nome atribuído.

• Dados, como o horário de criação.

• Uma ETag (por exemplo, ETVABCEXAMPLE), o ARN que inclui o nome do armazenamento de chave-valor (por exemplo, arn:aws:cloudfront::123456789012:key-value-store/keyvaluestore1).

  Você usará alguma combinação da ETag, do ARN e do nome para trabalhar com o armazenamento de chave-valor de forma programática.

Status do armazenamento de chave-valor

Ao criar um armazenamento de chave-valor, o armazenamento de dados pode apresentar os seguintes valores de status.

Value	Descrição
Provisionamento	O armazenamento de chave-valor foi criado e o CloudFront está processando a fonte de dados especificada.
Ready	O armazenamento de chave-valor foi criado e o CloudFront processou com êxito a fonte de dados especificada.
Falha na importação	O CloudFront não conseguiu processar a fonte de dados especificada. Esse status pode aparecer se o formato do arquivo não for válido ou exceder o limite de tamanho. Para ter mais informações, consulte Formato de arquivo para pares de chave-valor.