Travaillez avec des données de valeur clé - Amazon CloudFront
Utilisation de paires clé-valeur (console)À propos de CloudFront KeyValueStoreTravailler avec des paires clé-valeur ()AWS CLITravailler avec des paires clé-valeur (API)

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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. Cliquez sur l'onglet KeyValueStores.

  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

L' CloudFront KeyValueStore API est 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 Utilisation d'informations d'identification temporaires avec l' CloudFront KeyValueStore API.

Si vous utilisez le AWS Command Line Interface (AWS CLI) ou votre propre code pour appeler l' 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.

L' CloudFront API et l' CloudFront KeyValueStore API fonctionnent toutes deux. DescribeKeyValueStore Tu les appelles pour différentes raisons. Pour comprendre les différences, consultez le tableau suivant.

CloudFront DescribeKeyValueStore « Hello, World! » CloudFront KeyValueStore DescribeKeyValueStore « Hello, World! »
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, l'UUID et l'ARN du magasin de valeurs clés.

Renvoie un ETag et l'ARN du magasin de valeurs clés.
Remarques

  • Chaque DescribeKeyValueStore l'opération renvoie une valeur différenteETag. Ils ETags ne sont pas interchangeables.

  • Lorsque vous appelez une opération d'API pour effectuer une action, vous devez la spécifier ETag à partir de l'API appropriée. Par exemple, dans l' CloudFront KeyValueStore DeleteKeyopération, vous spécifiez le ETag que vous avez renvoyé depuis le CloudFront KeyValueStore DescribeKeyValueStoreopération.

  • Lorsque vous appelez vos CloudFront fonctions en utilisant CloudFront KeyValueStore, les valeurs du magasin de valeurs clés ne sont ni mises à jour ni modifiées lors de l'appel de la fonction. Les mises à jour sont traitées entre les appels d'une fonction.

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

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

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 par programmation.

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

Lorsque vous utilisez l' CloudFront KeyValueStore API pour appeler une opération d'écriture, vous devez spécifier l'ARN et le 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. Utilisation de la CloudFront ListKeyValueStoresOpération d'API pour obtenir une liste des magasins de valeurs clés. Trouvez le magasin de valeurs clés que vous souhaitez modifier.

  2. Utilisation de la CloudFrontKeyValueStore DescribeKeyValueStore Fonctionnement de l'API et spécifiez le magasin de valeurs clés de l'étape précédente.

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

    • L'ARN inclut le Compte AWS nombre, la constante key-value-store et l'UUID, 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 opérations CloudFront KeyValueStore d'API 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 explique comment appeler l'opération DescribeKeyValueStore API 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);
  }
})();