# Asociación de un almacén de clave-valor a una función
<a name="kvs-with-functions-associate"></a>

Después de crear el almacén de clave-valor, puede actualizar la función para asociarla al almacén de clave-valor. Debe realizar esta asociación para utilizar los pares clave-valor de ese almacén en esa función. Se aplican las siguientes reglas:
+ Una función solo puede tener un almacén de clave-valor
+ Puede asociar el mismo almacén de clave-valor a varias funciones

------
#### [ Console ]

**Asociación de un almacén de clave-valor a una función**

1. Inicie sesión en la consola de CloudFront en [https://console.aws.amazon.com/cloudfront/v4/home#/functions](https://console.aws.amazon.com/cloudfront/v4/home#/functions) y elija la página **Funciones**.

1. Elija el nombre de la función.

1. Vaya a la sección **Asociar KeyValueStore** y elija **Asociar KeyValueStore existente**.

1. Seleccione el almacén de clave-valor que contiene los pares clave-valor de la función y, a continuación, elija **Asociar KeyValueStore**.

   CloudFront asocia inmediatamente el almacén a la función. No necesita guardar la función.

1. Para especificar un almacén de clave-valor diferente, elija **Actualizar KeyValueStore asociado**, seleccione otro nombre de almacén de clave-valor y, a continuación, elija **Asociar KeyValueStore**.

Para obtener más información, consulte [Actualización de funciones](update-function.md).

------
#### [ AWS CLI ]

**Asociación de un almacén de clave-valor a una función**
+ Ejecute el siguiente comando para actualizar la función `MaxAge` y asociar un recurso de almacén de clave-valor.

  ```
  aws cloudfront update-function \
      --name MaxAge \
      --function-config '{"Comment":"Max Age 2 years","Runtime":"cloudfront-js-2.0","KeyValueStoreAssociations":{"Quantity":1,"Items":[{"KeyValueStoreARN":"arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example"}]}}' \
      --function-code fileb://function-max-age-v1.js \
      --if-match ETVABCEXAMPLE
  ```
+ Para asociar un almacén de clave-valor a una función, especifique el parámetro `KeyValueStoreAssociations` y el ARN del almacén de clave-valor. 
+ Para cambiar la asociación, especifique otro ARN de almacén de clave-valor. 
+ Para eliminar la asociación, quite el parámetro `KeyValueStoreAssociations`. 

Para obtener más información, consulte [Actualización de funciones](update-function.md).

------
#### [ API ]

**Asociación de un almacén de clave-valor a una función**
+ Utilice la operación de la API [UpdateFunction](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateFunction.html). Para obtener más información, consulte [Actualización de funciones](update-function.md).

------

**Notas**  
Si modifica un almacén de clave-valor sin cambiar los pares clave-valor o si solo modifica los pares clave-valor sin cambiar el almacén de clave-valor, no necesita volver a asociarlo. Tampoco necesita volver a publicar la función.  
Sin embargo, le recomendamos que pruebe la función para comprobar que funciona según lo previsto. Para obtener más información, consulte [Prueba de funciones](test-function.md).
Puede ver todas las funciones que utilizan determinados almacenes de clave-valor. En la consola de CloudFront, elija la página de detalles del almacén de clave-valor.