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.
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
-
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.
-
Elija la pestaña KeyValueStores y, a continuación, elija Crear KeyValueStore.
-
Introduzca un nombre y una descripción opcional para el almacén de clave-valor.
-
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.
-
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
-
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.
-
Para agregar los pares ahora:
-
Elija Agregar pares clave-valor.
-
Seleccione Agregar par e introduzca un nombre y un valor. Repita este paso para agregar más pares.
-
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.
-
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
-
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.
|