Travaillez avec des données de valeur clé

Cette rubrique explique comment ajouter des paires clé-valeur à un magasin clé-valeur existant. Pour inclure des paires clé-valeur lors de la création initiale des magasins clé-valeur, voir. Créez un magasin de valeur clé

Utilisation de paires clé-valeur (console)

Vous pouvez utiliser la CloudFront console pour travailler avec vos paires clé-valeur.

Pour travailler avec des paires clé-valeur

1. Connectez-vous à la page Fonctions AWS Management Console et ouvrez-la dans la CloudFront console à l'adressehttps://console.aws.amazon.com/cloudfront/v4/home#/functions.

2. Choisissez l'KeyValueStoresonglet.

3. Sélectionnez le magasin de clés-valeurs que vous souhaitez modifier.

4. Dans la section Paires de valeurs clés, choisissez Modifier.

5. Vous pouvez ajouter une paire clé-valeur, supprimer une paire clé-valeur ou modifier la valeur d'une paire clé-valeur existante.

6. Lorsque vous avez terminé, sélectionnez Enregistrer les modifications.

À propos de CloudFront KeyValueStore

Astuce

CloudFront KeyValueStore APIIl s'agit d'un service mondial qui utilise Signature Version 4A (SigV4A) pour l'authentification. L'utilisation d'informations d'identification temporaires avec SIGv4a nécessite des jetons de session de version 2. Pour de plus amples informations, veuillez consulter En utilisant des informations d'identification temporaires avec CloudFront KeyValueStore API.

Si vous utilisez le AWS Command Line Interface (AWS CLI) ou votre propre code pour appeler le CloudFront KeyValueStore API, consultez les sections suivantes.

Lorsque vous travaillez avec un magasin clé-valeur et ses paires clé-valeur, le service que vous appelez dépend de votre cas d'utilisation :

• Pour utiliser des paires clé-valeur dans un magasin clé-valeur existant, utilisez le CloudFront KeyValueStore service.

• Pour inclure des paires clé-valeur dans le magasin clé-valeur lorsque vous créez initialement le magasin clé-valeur, utilisez le CloudFront service.

Le CloudFront API et le CloudFront KeyValueStore API subissent tous deux une DescribeKeyValueStore opération. Tu les appelles pour différentes raisons. Pour comprendre les différences, consultez le tableau suivant.

	CloudFront DescribeKeyValueStore API	CloudFront KeyValueStore DescribeKeyValueStore API
Données relatives au magasin de valeur clé	Renvoie des données, telles que le statut et la date à laquelle le magasin de valeurs clés lui-même a été modifié pour la dernière fois.	Renvoie des données concernant le contenu de la ressource de stockage, à savoir les paires clé-valeur du magasin et la taille du contenu.
Données qui identifient le magasin de valeur clé	Renvoie anETag, leUUID, et le ARN du magasin de valeurs clés.	Renvoie un ETag et le ARN du magasin de valeurs clés.

Remarques

• Chaque DescribeKeyValueStore opération renvoie un résultat différentETag. Ils ETags ne sont pas interchangeables.

• Lorsque vous appelez une API opération pour terminer une action, vous devez spécifier le ETag formulaire appropriéAPI. Par exemple, dans l' CloudFront KeyValueStore DeleteKeyopération, vous spécifiez ETag ce que vous avez renvoyé après l' CloudFront KeyValueStore DescribeKeyValueStoreopération.

Travailler avec des paires clé-valeur ()AWS CLI

Vous pouvez exécuter les AWS Command Line Interface commandes suivantes pour CloudFront KeyValueStore.

Table des matières

• Lister les paires clé-valeur
• Obtenir des paires clé-valeur
• Décrire un magasin de valeurs clés
• Création d'une paire clé-valeur
• Supprimer une paire clé-valeur
• Mettre à jour les paires clé-valeur

Lister les paires clé-valeur

Pour répertorier les paires clé-valeur dans votre magasin de valeurs clés, exécutez la commande suivante.

aws cloudfront-keyvaluestore list-keys \
    --kvs-arn=arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example

Réponse

{
    "Items": [
        {
            "Key": "key1",
            "Value": "value1"
        }
    ]
}

Obtenir des paires clé-valeur

Pour obtenir une paire clé-valeur dans votre magasin clé-valeur, exécutez la commande suivante.

aws cloudfront-keyvaluestore get-key \
    --key=key1 \
    --kvs-arn=arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example

Réponse

{
    "Key": "key1",
    "Value": "value1",
    "ItemCount": 1,
    "TotalSizeInBytes": 11
}

Décrire un magasin de valeurs clés

Pour décrire un magasin de valeurs clés, exécutez la commande suivante.

aws cloudfront-keyvaluestore describe-key-value-store \
    --kvs-arn=arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example

Réponse

{
    "ETag": "KV1F83G8C2ARO7P",
    "ItemCount": 1,
    "TotalSizeInBytes": 11,
    "KvsARN": "arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example",
    "Created": "2024-05-08T07:48:45.381000-07:00",
    "LastModified": "2024-08-05T13:50:58.843000-07:00",
    "Status": "READY"
}

Création d'une paire clé-valeur

Pour créer une paire clé-valeur dans votre magasin clé-valeur, exécutez la commande suivante.

aws cloudfront-keyvaluestore put-key \
    --if-match=KV1PA6795UKMFR9 \
    --key=key2 \
    --value=value2 \
    --kvs-arn=arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example

Réponse

{
    "ETag": "KV13V1IB3VIYZZH",
    "ItemCount": 3,
    "TotalSizeInBytes": 31
}

Supprimer une paire clé-valeur

Pour supprimer une paire clé-valeur, exécutez la commande suivante.

aws cloudfront-keyvaluestore delete-key \
    --if-match=KV13V1IB3VIYZZH \
    --key=key1 \
    --kvs-arn=arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example

Sortie

{
    "ETag": "KV1VC38T7YXB528",
    "ItemCount": 2,
    "TotalSizeInBytes": 22
}

Mettre à jour les paires clé-valeur

Vous pouvez utiliser la update-keys commande pour mettre à jour plusieurs paires clé-valeur. Par exemple, pour supprimer une paire clé-valeur existante et en créer une autre, exécutez la commande suivante.

aws cloudfront-keyvaluestore update-keys \
    --if-match=KV2EUQ1WTGCTBG2 \
    --kvs-arn=arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example \
    --deletes '[{"Key":"key2"}]' \
    --puts '[{"Key":"key3","Value":"value3"}]'

Réponse

{
    "ETag": "KV3AEGXETSR30VB",
    "ItemCount": 3,
    "TotalSizeInBytes": 28
}

Travailler avec des paires clé-valeur () API

Suivez cette section pour travailler avec vos paires clé-valeur de manière programmatique.

Table des matières

• Obtenir une référence à un magasin de valeurs clés
• Modifier les paires clé-valeur dans un magasin clé-valeur
• Exemple de code pour CloudFront KeyValueStore

Obtenir une référence à un magasin de valeurs clés

Lorsque vous utilisez le CloudFront KeyValueStore API pour appeler une opération d'écriture, vous devez spécifier le ARN et ETag du magasin de valeurs clés. Pour obtenir ces données, procédez comme suit :

Pour obtenir une référence à un magasin de valeurs clés

1. Utilisez cette CloudFront ListKeyValueStoresAPIopération pour obtenir une liste des magasins de valeurs clés. Trouvez le magasin de valeurs clés que vous souhaitez modifier.

2. Utilisez l'CloudFrontKeyValueStore DescribeKeyValueStoreAPIopération et spécifiez le magasin de valeurs clés de l'étape précédente.

   La réponse inclut le ARN et le ETag du magasin de valeurs clés.

   • ARNCela inclut le Compte AWS nombre, la constante key-value-store et leUUID, comme dans l'exemple suivant :

     arn:aws:cloudfront::123456789012:key-value-store/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

   • Et ETag cela ressemble à l'exemple suivant :

     ETVABCEXAMPLE2

Modifier les paires clé-valeur dans un magasin clé-valeur

Vous pouvez spécifier le magasin clé-valeur qui contient la paire clé-valeur que vous souhaitez mettre à jour.

Consultez les CloudFront KeyValueStore API opérations suivantes :

• CloudFrontKeyValueStore DeleteKey— Supprime une paire clé-valeur

• CloudFrontKeyValueStore GetKey— Renvoie une paire clé-valeur

• CloudFrontKeyValueStore ListKeys— Renvoie une liste de paires clé-valeur

• CloudFrontKeyValueStore PutKey— Vous pouvez effectuer les tâches suivantes :

  • Créez une paire clé-valeur dans un magasin de valeurs clés en spécifiant un nouveau nom et une nouvelle valeur de clé.

  • Définissez une valeur différente dans une paire clé-valeur existante en spécifiant un nom de clé existant et une nouvelle valeur de clé.

• CloudFrontKeyValueStore UpdateKeys— Vous pouvez effectuer une ou plusieurs des actions suivantes en une seule all-or-nothing opération :

  • Supprimer une ou plusieurs paires clé-valeur

  • Créez une ou plusieurs nouvelles paires clé-valeur

  • Définissez une valeur différente dans une ou plusieurs paires clé-valeur existantes

Exemple de code pour CloudFront KeyValueStore

Le code suivant indique comment appeler l'DescribeKeyValueStoreAPIopération pour un magasin de valeurs clés.

const {
  CloudFrontKeyValueStoreClient,
  DescribeKeyValueStoreCommand,
} = require("@aws-sdk/client-cloudfront-keyvaluestore");

require("@aws-sdk/signature-v4-crt");

(async () => {
  try {
    const client = new CloudFrontKeyValueStoreClient({
      region: "us-east-1"
    });
    const input = {
      KvsARN: "arn:aws:cloudfront::123456789012:key-value-store/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    };
    const command = new DescribeKeyValueStoreCommand(input);

    const response = await client.send(command);
  } catch (e) {
    console.log(e);
  }
})();