Arbeiten Sie mit Schlüsselwertdaten - Amazon CloudFront
Arbeiten Sie mit Schlüssel-Wert-Paaren (Konsole)Über den CloudFront KeyValueStoreArbeiten Sie mit Schlüssel-Wert-Paaren ()AWS CLIArbeiten Sie 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 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.

Um mit Schlüssel-Wert-Paaren zu arbeiten

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

  2. Wählen Sie die Registerkarte KeyValueStores aus.

  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, ein Schlüssel-Wert-Paar 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.

Über den CloudFront KeyValueStore

Tipp

Die CloudFront KeyValueStore API ist ein globaler Dienst, der Signature Version 4A (Sigv4A) zur 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 seinen Schlüssel-Wert-Paaren arbeiten, hängt der Service, den Sie aufrufen, von Ihrem Anwendungsfall ab:

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

  • Verwenden Sie den Dienst, um Schlüsselwertpaare in den Schlüsselwertspeicher aufzunehmen, wenn Sie den Schlüsselwertspeicher zum ersten Mal erstellen. CloudFront

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

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

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

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

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

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

  • Jeder DescribeKeyValueStore Operation gibt einen anderen zurückETag. Sie ETags sind nicht austauschbar.

  • Wenn Sie einen API-Vorgang aufrufen, um eine Aktion abzuschließen, müssen Sie das ETag von der entsprechenden API aus angeben. In dem CloudFront KeyValueStore DeleteKeyVorgang geben Sie beispielsweise den anETag, den Sie von der CloudFront KeyValueStore DescribeKeyValueStoreOperation.

  • Wenn Sie Ihre CloudFront Funktionen mithilfe von aufrufen CloudFront KeyValueStore, 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 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 programmatisch mit Ihren Schlüssel-Wert-Paaren zu arbeiten.

Holen Sie sich einen Verweis auf einen Schlüsselwertspeicher

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

Um einen Verweis auf einen Schlüsselwertspeicher abzurufen

  1. Verwenden der CloudFront ListKeyValueStoresAPI-Operation zum Abrufen einer Liste von Schlüsselwertspeichern. Suchen Sie den Schlüsselwertspeicher, den Sie ändern möchten.

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

    Die Antwort umfasst den ARN und den ETag des Schlüsselwertspeichers.

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

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

    • Und ETag das sieht wie das folgende Beispiel aus:

      ETVABCEXAMPLE2

Ä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 CloudFront KeyValueStore API-Operationen 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— Sie können die folgenden Aufgaben ausführen:

    • Erstellen Sie ein Schlüssel-Wert-Paar in einem Schlüsselwertspeicher, indem Sie einen neuen Schlüsselnamen und einen neuen Schlüsselwert 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— Sie können eine oder mehrere der folgenden Aktionen in einem all-or-nothing Vorgang ausführen:

    • Löschen Sie ein oder mehrere Schlüssel-Wert-Paare

    • Erstellen Sie ein oder mehrere neue Schlüssel-Wert-Paare

    • Legen Sie einen anderen Wert in einem oder mehreren vorhandenen Schlüssel-Wert-Paaren fest

Beispielcode für CloudFront KeyValueStore

Der folgende Code zeigt Ihnen, wie Sie den DescribeKeyValueStore API-Vorgang 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);
  }
})();