Creación de un almacén de clave-valor - Amazon CloudFront

Creación de un almacén de clave-valor

Puede crear un almacén de clave-valor y los pares clave-valor al mismo tiempo. Puede crear también un almacén de clave-valor vacío ahora y luego agregar pares clave-valor.

nota

Si especifica el origen de datos de un bucket de Amazon S3, debe tener los permisos s3:GetObject y s3:GetBucketLocation de ese bucket. Si no tiene estos permisos, CloudFront no podrá crear correctamente el almacén de clave-valor.

Decida si quiere agregar pares clave-valor al mismo tiempo cuando crea el almacén de clave-valor. Puede importar los pares clave-valor mediante la consola de CloudFront, la API de CloudFront o los AWS SDK. Sin embargo, solo puede importar el archivo de pares clave-valor cuando inicialmente crea el almacén de clave-valor.

Para crear un archivo de pares clave-valor, consulte Formato de archivo para pares clave-valor.

Console
Creación de un almacén de clave-valor
  1. Inicie sesión en AWS Management Console y abra la página Funciones en la consola de CloudFront en https://console.aws.amazon.com/cloudfront/v4/home#/functions.

  2. Elija la pestaña KeyValueStores y, a continuación, elija Crear KeyValueStore.

  3. Introduzca un nombre y una descripción opcional para el almacén de clave-valor.

  4. Complete URI de S3:

    • Si tiene un archivo de pares clave-valor, ingrese la ruta al bucket de Amazon S3 donde ha almacenado el archivo.

    • Deje este campo en blanco si piensa ingresar los pares clave-valor manualmente.

  5. Seleccione Crear. El almacén de clave-valor ya existe.

    Aparece la página de detalles del nuevo almacén de clave-valor. La información de la página incluye el ID y el ARN del almacén de clave-valor.

    • El ID es una cadena aleatoria de caracteres que es única en la Cuenta de AWS.

    • El ARN tiene la siguiente sintaxis:

      Cuenta de AWS:key-value-store/el ID del almacén de clave-valor

  6. Consulte la sección de Pares clave-valor. Si ha importado un archivo, en esta sección se muestran algunos pares clave-valor. Puede hacer lo siguiente:

    • Si ha importado un archivo, también puede agregar más valores manualmente.

    • Si no ha importado un archivo desde un bucket de Amazon S3 y desea agregar pares clave-valor ahora, puede completar el siguiente paso.

    • Puede omitir este paso y agregar los pares clave-valor más adelante.

  7. Para agregar los pares ahora:

    1. Elija Agregar pares clave-valor.

    2. Seleccione Agregar par e introduzca un nombre y un valor. Repita este paso para agregar más pares.

    3. Cuando haya terminado, elija Guardar cambios para guardar todos los pares clave-valor del almacén de clave-valor. En el cuadro de diálogo que aparece, elija Listo.

  8. Para asociar ahora el almacén de clave-valor a una función, complete la sección Funciones asociadas. Para obtener más información, consulte Creación de funciones o Actualización de funciones.

    También puede asociar la función más adelante, ya sea desde esta página de detalles del almacén de clave-valor o desde la página de detalles de la función.

AWS CLI
Creación de un almacén de clave-valor
  • Ejecute el siguiente comando para crear un almacén clave-valor e importar los pares clave-valor de un bucket de 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

    Respuesta

    { "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
Creación de un almacén de clave-valor
  1. Utilice la operación CreateKeyValueStore de CloudFront. La operación requiere varios parámetros:

    • Un name del almacén de clave-valor.

    • Un parámetro comment que incluye un comentario.

    • Un parámetro import-source que permite importar pares clave-valor desde un archivo almacenado en un bucket de Amazon S3. Solo podrá importar desde un archivo cuando cree por primera vez el almacén clave-valor. Para obtener información sobre la estructura de archivos, consulte Formato de archivo para pares clave-valor.

La respuesta de la operación incluye la siguiente información:

  • Los valores transferidos en la solicitud, incluido el nombre que asignó.

  • Datos como la hora de creación.

  • Una ETag (por ejemplo, ETVABCEXAMPLE), el ARN que incluye el nombre del almacén de clave-valor (por ejemplo, arn:aws:cloudfront::123456789012:key-value-store/keyvaluestore1).

    Utilizará alguna combinación de la ETag, el ARN y el nombre para trabajar con el almacén de clave-valor mediante programación.

Estados del almacén de clave-valor

Al crear un almacén de clave-valor, el almacén de datos puede tener los siguientes valores de estado.

Valor Descripción

Aprovisionando

Se ha creado el almacén de clave-valor y CloudFront está procesando el origen de datos que usted ha especificado.

Ready

Se ha creado el almacén de clave-valor y CloudFront ha procesado correctamente el origen de datos que usted ha especificado.

Error al importar

CloudFront no ha podido procesar el origen de datos que usted ha especificado. Este estado puede aparecer si el formato de archivo no es válido o si supera el límite de tamaño. Para obtener más información, consulte Formato de archivo para pares clave-valor.