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

Puede crear almacenes de clave-valor vacíos y, después, agregar pares clave-valor. O bien, puede crear almacenes de clave-valor y sus pares clave-valor al mismo tiempo.

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.

Console

Creación de almacenes de clave-valor (consola)

1. Decida si quiere agregar pares clave-valor al mismo tiempo que crea los almacenes de clave-valor. Esta característica de importación se admite tanto en la consola de CloudFront como en las API y los SDK de AWS de CloudFront. Sin embargo, solo es compatible cuando crea los almacenes de clave-valor inicialmente.

   Si quiere usar un archivo, créelo ahora.

2. 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.

3. Elija la pestaña KeyValueStores. Elija Crear KeyValueStore.

4. Introduzca un nombre y una descripción opcional para los almacenes de clave-valor.

5. Complete URI de S3:

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

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

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

   Aparece la página de detalles de los nuevos almacenes 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 su cuenta de AWS.

   • El ARN tiene la siguiente sintaxis:

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

7. Consulte la sección de Pares clave-valor. Si ha importado un archivo, en esta sección se muestran algunos pares. En caso contrario, está vacío. Puede hacer lo siguiente:

   • Si no ha importado un archivo desde un bucket de Amazon S3 y desea agregar pares clave-valor ahora, puede completar esta sección.

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

   • Puede dejar esta sección vacía y agregar los pares más adelante mediante la edición de los almacenes de clave-valor.

   Para agregar los pares ahora:

   • Elija el botón Agregar pares clave-valor.

   • Seleccione Agregar par e introduzca un nombre y un valor.

   • Pulse de nuevo el botón Agregar par para agregar más pares.

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

8. Complete la sección Funciones asociadas si desea asociar ahora los almacenes de clave-valor a una función. También puede crear esta asociación más adelante, ya sea desde esta página de detalles de los almacenes de clave-valor o desde la página de detalles de las funciones.

   Para crear la asociación ahora, pulse el botón Ir a las funciones. Para obtener más información, consulte Creación de funciones o Actualización de funciones.

Programmatically

Creación de almacenes de clave-valor

1. Decida si quiere agregar pares clave-valor al mismo tiempo que crea los almacenes de clave-valor. (También puede agregar el par clave-valor más adelante). Esta característica de importación se admite tanto en la consola de CloudFront como en las API y los SDK de CloudFront. Sin embargo, solo es compatible cuando crea los almacenes de clave-valor inicialmente.

   Si quiere usar un archivo, créelo ahora.

2. Utilice la operación de creación de la API de CloudFront o su SDK de AWS preferido. Por ejemplo, para la API de REST, utilice CloudFront.CreateKeyValueStore. La operación requiere varios parámetros:

   • Un nombre.

   • Un parámetro configuration 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. Tenga en cuenta que solo puede importar desde un archivo al crear inicialmente los almacenes de clave-valor. Para obtener más información sobre el formato del archivo, consulte Creación de un archivo de 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, ETVABCEXAMPLE2), el ARN que incluye el nombre de los almacenes de clave-valor (por ejemplo, arn:aws:cloudfront::111122223333:key-value-store/MaxAge).

  Utilizará alguna combinación de la ETag, el ARN y el nombre para trabajar con los almacenes 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 Creación de un archivo de pares clave-valor.