Arbeiten Sie mit Schlüsselwertdaten

In diesem Thema wird beschrieben, wie Schlüssel-Wert-Paare zu einem vorhandenen Schlüssel-Wert-Speicher hinzugefügt werden. Informationen zum Einbeziehen von Schlüssel-Wert-Paaren bei der ersten Erstellung der Schlüssel-Wert-Speicher finden Sie unter. Erstellen Sie einen Schlüsselwertspeicher

Arbeiten Sie mit Schlüssel-Wert-Paaren (Konsole)

Sie können die CloudFront Konsole verwenden, um mit Ihren Schlüssel-Wert-Paaren zu arbeiten.

Über den CloudFront KeyValueStore

Wenn Sie die AWS Command Line Interface (AWS CLI) oder Ihren eigenen Code zum Aufrufen von verwenden CloudFront KeyValueStore API, finden Sie weitere Informationen in den folgenden Abschnitten.

Wenn Sie mit einem Schlüsselwertspeicher und seinen Schlüssel-Wert-Paaren arbeiten, hängt der Service, den Sie aufrufen, von Ihrem Anwendungsfall ab:

Sowohl der als CloudFront API auch der CloudFront KeyValueStore API haben eine DescribeKeyValueStore Operation. Sie rufen sie aus verschiedenen Gründen an. Informationen zu den Unterschieden finden Sie in der folgenden Tabelle.

Arbeiten Sie mit Schlüssel-Wert-Paaren ()AWS CLI

Sie können die folgenden AWS Command Line Interface Befehle für ausführen. CloudFront KeyValueStore

Schlüssel-Wert-Paare auflisten

Führen Sie den folgenden Befehl aus, um Schlüssel-Wert-Paare in Ihrem Schlüssel-Wert-Speicher aufzulisten.

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

Antwort

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

Rufen Sie Schlüssel-Wert-Paare ab

Führen Sie den folgenden Befehl aus, um ein Schlüssel-Wert-Paar in Ihrem Schlüsselwertspeicher abzurufen.

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

Antwort

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

Beschreiben Sie einen Schlüsselwertspeicher

Führen Sie den folgenden Befehl aus, um einen Schlüsselwertspeicher zu beschreiben.

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

Antwort

{
    "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"
}

Erstellen Sie ein Schlüssel-Wert-Paar

Führen Sie den folgenden Befehl aus, um ein Schlüssel-Wert-Paar in Ihrem Schlüssel-Wert-Speicher zu erstellen.

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

Antwort

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

Löschen Sie ein Schlüssel-Wert-Paar

Führen Sie den folgenden Befehl aus, um ein Schlüssel-Wert-Paar zu löschen.

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

Ausgabe

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

Aktualisieren Sie Schlüssel-Wert-Paare

Sie können den update-keys Befehl verwenden, um mehr als ein Schlüssel-Wert-Paar zu aktualisieren. Um beispielsweise ein vorhandenes Schlüssel-Wert-Paar zu löschen und ein anderes zu erstellen, führen Sie den folgenden Befehl aus.

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"}]'

Antwort

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

Arbeiten Sie mit Schlüssel-Wert-Paaren () API

Folgen Sie diesem Abschnitt, um programmgesteuert mit Ihren Schlüssel-Wert-Paaren zu arbeiten.

Holen Sie sich einen Verweis auf einen Schlüsselwertspeicher

Wenn Sie den verwenden, CloudFront KeyValueStore API um einen Schreibvorgang aufzurufen, müssen Sie das ARN und das ETag des Schlüsselwertspeichers angeben. Gehen Sie wie folgt vor, um diese Daten abzurufen:

Ändern Sie Schlüssel-Wert-Paare in einem Schlüsselwertspeicher

Sie können den Schlüsselwertspeicher angeben, der das Schlüssel-Wert-Paar enthält, das Sie aktualisieren möchten.

Sehen Sie sich die folgenden Operationen an: CloudFront KeyValueStore API

Beispielcode für CloudFront KeyValueStore

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);
  }
})();