Arbeiten mit Schlüsselwertdaten - Amazon CloudFront
Arbeiten mit Schlüssel-Wert-Paaren (Konsole)Informationen zum CloudFront KeyValueStoreArbeiten mit Schlüssel-Wert-Paaren (AWS CLI)Arbeiten mit Schlüssel-Wert-Paaren (API)

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Arbeiten mit Schlüsselwertdaten

In diesem Thema wird beschrieben, wie Schlüssel-Wert-Paare zu einem vorhandenen Schlüsselwertspeicher hinzugefügt werden. Informationen zum Einbeziehen von Schlüssel-Wert-Paaren bei der anfänglichen Erstellung des Schlüsselwertspeichers finden Sie unter Erstellen eines Schlüsselwertspeichers.

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

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

So arbeiten Sie mit Schlüssel-Wert-Paaren

  1. Melden Sie sich bei AWS-Managementkonsole an und öffnen Sie die Seite Functions in der CloudFront-Konsole unter https://console.aws.amazon.com/cloudfront/v4/home#/functions.

  2. Wählen Sie die Registerkarte KeyValueStores.

  3. Wählen Sie den Schlüsselwertspeicher aus, den Sie bearbeiten möchten.

  4. Wählen Sie im Abschnitt Schlüssel-Wert-Paare die Option Bearbeiten aus.

  5. Sie können ein Schlüssel-Wert-Paar hinzufügen oder löschen oder den Wert für ein vorhandenes Schlüssel-Wert-Paar ändern.

  6. Wenn Sie fertig sind, wählen Sie Änderungen speichern aus.

Informationen zum CloudFront KeyValueStore

Tipp

Die CloudFront-KeyValueStore-API ist ein globaler Dienst, der Signature Version 4A (SigV4A) für die Authentifizierung verwendet. Für die Verwendung temporärer Anmeldeinformationen mit SigV4A sind Sitzungstoken der Version 2 erforderlich. Weitere Informationen finden Sie unter Verwenden temporärer Anmeldeinformationen mit der CloudFront-KeyValueStore-API.

Wenn Sie die AWS Command Line Interface (AWS CLI) oder Ihren eigenen Code verwenden, um die CloudFront-KeyValueStore-API aufzurufen, lesen Sie die folgenden Abschnitte.

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

  • Verwenden Sie den CloudFront-KeyValueStore-Service, um mit Schlüssel-Wert-Paaren in einem vorhandenen Schlüsselwertspeicher zu arbeiten.

  • Verwenden Sie den CloudFront-Service, um bei der anfänglichen Erstellung des Schlüsselwertspeichers Schlüssel-Wert-Paare in den Schlüsselwertspeicher aufzunehmen.

Sowohl die CloudFront-API als auch die CloudFront-KeyValueStore-API verfügen über eine DescribeKeyValueStore-Operation. Sie werden zu unterschiedlichen Zwecken aufgerufen. Informationen zu den Unterschieden finden Sie in der folgenden Tabelle.

DescribeKeyValueStore der CloudFront-API DescribeKeyValueStore der CloudFront-KeyValueStore-API
Daten über den Schlüsselwertspeicher

Gibt Daten zurück, z. B. den Status und das Datum, an dem der Schlüsselwertspeicher zuletzt geändert wurde.

Gibt Daten über die Inhalte der Speicherressource zurück – die Schlüssel-Wert-Paare im Speicher und die Größe der Inhalte.
Daten, die den Schlüsselwertspeicher identifizieren

Gibt ein ETag, die UUID und den ARN des Schlüsselwertspeichers zurück.

Gibt ein ETag und den ARN des Schlüsselwertspeichers zurück.
Hinweise

  • Jede DescribeKeyValueStore-Operation gibt ein anderes ETag zurück. Die ETags sind nicht austauschbar.

  • Wenn Sie einen API-Vorgang aufrufen, um eine Aktion abzuschließen, müssen Sie das ETag der entsprechenden API angeben. Beispielsweise geben Sie bei der DeleteKey-Operation für CloudFront KeyValueStore das ETag an, das bei der DescribeKeyValueStore-Operation für CloudFront KeyValueStore zurückgegeben wurde.

  • Wenn Sie CloudFront Functions mithilfe von CloudFront KeyValueStore aufrufen, werden die Werte im Schlüsselwertspeicher während des Aufrufs der Funktion nicht aktualisiert oder geändert. Aktualisierungen werden zwischen den Aufrufen einer Funktion verarbeitet.

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

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

Auflisten von Schlüssel-Wert-Paaren

Führen Sie den folgenden Befehl aus, um Schlüssel-Wert-Paare in Ihrem Schlüsselwertspeicher 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"
        }
    ]
}

Abrufen von Schlüssel-Wert-Paaren

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

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 eines Schlüsselwertspeichers

Um einen Schlüsselwertspeicher zu beschreiben, führen Sie den folgenden Befehl aus.

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 eines Schlüssel-Wert-Paares

Um ein Schlüssel-Wert-Paar in Ihrem Schlüsselwertspeicher zu erstellen, führen Sie den folgenden Befehl aus.

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 eines Schlüssel-Wert-Paares

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

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

Output

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

Aktualisieren eines Schlüssel-Wert-Paares

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 mit Schlüssel-Wert-Paaren (API)

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

Abrufen eines Verweises auf einen Schlüsselwertspeicher

Wenn Sie mit der CloudFront-KeyValueStore-API eine Schreiboperation aufrufen, müssen Sie den ARN und das ETag des Schlüsselwertspeichers angeben. Gehen Sie wie folgt vor, um diese Daten abzurufen:

So rufen Sie einen Verweis auf einen Schlüsselwertspeicher ab

  1. Verwenden Sie die API-Operation CloudFront ListKeyValueStores, um eine Liste von Schlüsselwertspeichern abzurufen. Suchen Sie den Schlüsselwertspeicher, den Sie bearbeiten möchten.

  2. Verwenden Sie die API-Operation CloudFrontKeyValueStore DescribeKeyValueStore und geben Sie den Schlüsselwertspeicher aus dem vorherigen Schritt an.

    Die Antwort enthält den ARN und das ETag des Schlüsselwertspeichers.

    • Der ARN umfasst die AWS-Konto-Nummer, die Konstante key-value-store und die UUID, wie im folgenden Beispiel:

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

    • Ein ETag sieht z. B. folgendermaßen aus:

      ETVABCEXAMPLE2

Ändern von Schlüssel-Wert-Paaren in einem Schlüsselwertspeicher

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

Sehen Sie sich die folgenden API-Operationen für CloudFront KeyValueStore an:

  • CloudFrontKeyValueStore DeleteKey – löscht ein Schlüssel-Wert-Paar

  • CloudFrontKeyValueStore GetKey – gibt ein Schlüssel-Wert-Paar zurück

  • CloudFrontKeyValueStore ListKeys – gibt eine Liste von Schlüssel-Wert-Paaren zurück

  • CloudFrontKeyValueStore PutKey – ermöglicht die Ausführung folgender Aufgaben:

    • Erstellen Sie ein Schlüssel-Wert-Paar in einem Schlüsselwertspeicher, indem Sie einen neuen Schlüsselnamen und Wert angeben.

    • Legen Sie einen anderen Wert in einem vorhandenen Schlüssel-Wert-Paar fest, indem Sie einen vorhandenen Schlüsselnamen und einen neuen Schlüsselwert angeben.

  • CloudFrontKeyValueStore UpdateKeys – ermöglicht die Ausführung einer oder mehrerer der folgenden Aktionen in einer Alles-oder-Nichts-Operation:

    • Löschen eines oder mehrerer Schlüssel-Wert-Paare

    • Erstellen eines oder mehrerer neuer Schlüssel-Wert-Paare

    • Festlegen eines anderen Werts in einem oder mehreren vorhandenen Schlüssel-Wert-Paaren

Beispielcode für CloudFront KeyValueStore

Der folgende Code zeigt Ihnen, wie Sie die API-Operation DescribeKeyValueStore für einen Schlüsselwertspeicher aufrufen.

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