Création d’un magasin de clés-valeurs
Vous pouvez créer un magasin de clés-valeurs et ses paires clé-valeur en même temps. Vous pouvez également créer un magasin de clés-valeurs vide, puis ajouter des paires clé-valeur ultérieurement.
Si vous spécifiez votre source de données à partir d’un compartiment Amazon S3, vous devez disposer des autorisations s3:GetObject et s3:GetBucketLocation pour ce compartiment. Si vous ne disposez pas de ces autorisations, CloudFront ne pourra pas créer votre magasin de clés-valeurs.
Décidez si vous souhaitez ajouter des paires clé-valeur en même temps que vous créez le magasin de clés-valeurs. Vous pouvez importer vos paires clé-valeur à l’aide de la console CloudFront, de l’API CloudFront ou de kits AWS SDK. Toutefois, vous ne pouvez importer votre fichier de paires clé-valeur que lorsque vous créez initialement le magasin de clés-valeurs.
Pour créer un fichier de paires clé-valeur, consultez Format de fichier pour les paires clé-valeur.
- Console
-
Pour créer un magasin de clés-valeurs
-
Connectez-vous à la AWS Management Console et ouvrez la page Fonctions dans la console CloudFront à l’adresse https://console.aws.amazon.com/cloudfront/v4/home#/functions.
-
Choisissez l’onglet KeyValueStores, puis Create KeyValueStore.
-
Entrez un nom et une description facultative pour le magasin de clés-valeurs.
-
Complétez URI S3 :
-
Si vous disposez d’un fichier de paires clé-valeur, entrez le chemin d’accès au compartiment Amazon S3 où vous avez stocké le fichier.
-
Laissez ce champ vide si vous prévoyez d’entrer manuellement les paires clé-valeur.
-
Choisissez Créer. Le magasin de clés-valeurs existe désormais.
La page de détails du nouveau magasin de clés-valeurs apparaît. Les informations figurant sur cette page incluent l’ID et l’ARN du magasin de clés-valeurs.
-
L’identifiant est une chaîne de caractères aléatoire unique dans votre Compte AWS.
-
La syntaxe de l’ARN est la suivante :
Compte AWS:key-value-store/ID du magasin de clés-valeurs
-
Examinez la section Paires clé-valeur. Si vous avez importé un fichier, cette section présente quelques paires clé-valeur. Vous pouvez effectuer les actions suivantes :
-
Si vous avez importé un fichier, vous pouvez également ajouter d’autres valeurs manuellement.
-
Si vous n’avez pas importé de fichier d’un compartiment Amazon S3 et si vous souhaitez ajouter des paires clé-valeur dès maintenant, vous pouvez passer à l’étape suivante.
-
Vous pouvez ignorer cette étape et ajouter les paires clé-valeur ultérieurement.
-
Pour ajouter les paires dès maintenant :
-
Choisissez Ajouter des paires clé-valeur.
-
Choisissez Ajouter une paire et entrez un nom et une valeur. Répétez cette étape pour ajouter d’autres paires.
-
Lorsque vous avez terminé, choisissez Enregistrer les modifications pour enregistrer toutes les paires clé-valeur dans le magasin de clés-valeurs. Dans la boîte de dialogue qui s’affiche, cliquez sur Terminé.
-
Pour associer le magasin de clés-valeurs à une fonction dès maintenant, complétez la section Fonctions associées. Pour plus d’informations, consultez Création de fonctions ou Mise à jour de fonctions.
Vous pouvez également associer la fonction ultérieurement, soit depuis la page de détails de ce magasin de clés-valeurs, soit depuis la page de détails de la fonction.
- AWS CLI
-
Pour créer un magasin de clés-valeurs
-
Exécutez la commande suivante pour créer un magasin de clés-valeurs et importer les paires clé-valeur depuis un compartiment 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
Réponse
{
"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
-
Pour créer un magasin de clés-valeurs
-
Utilisez l’opération CloudFront CreateKeyValueStore. L’opération prend plusieurs paramètres :
-
Un name du magasin de clés-valeurs.
-
Un paramètre comment qui inclut un commentaire.
-
Un paramètre import-source qui vous permet d’importer des paires clé-valeur à partir d’un fichier stocké dans un compartiment Amazon S3. Vous ne pouvez importer à partir d’un fichier qu’au moment de la création initiale du magasin de clés-valeurs. Pour plus d’informations sur la structure, consultez Format de fichier pour les paires clé-valeur.
La réponse de l’opération inclut les informations suivantes :
-
Les valeurs transmises dans la demande, y compris le nom que vous avez attribué.
-
Des données telles que l’heure de création.
-
Un ETag (par exemple, ETVABCEXAMPLE), l’ARN qui inclut le nom du magasin de clés-valeurs (par exemple, arn:aws:cloudfront::123456789012:key-value-store/keyvaluestore1).
Vous utiliserez une combinaison de l’ETag, de l’ARN et du nom pour travailler avec le magasin de clés-valeurs par programmation.
États des magasins de clés-valeurs
Lorsque vous créez un magasin de clés-valeurs, le magasin de données peut présenter les valeurs d’état suivantes.
| Valeur |
Description |
|
Allouer
|
Le magasin de clés-valeurs a été créé et CloudFront traite la source de données que vous avez spécifiée.
|
|
Prêt
|
Le magasin de clés-valeurs a été créé et CloudFront a bien traité la source de données que vous avez spécifiée.
|
|
Échec de l’importation
|
CloudFront n’a pas pu traiter la source de données que vous avez spécifiée. Cet état peut apparaître si le format de votre fichier n’est pas valide ou s’il dépasse la limite de taille. Pour plus d’informations, consultez Format de fichier pour les paires clé-valeur.
|