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 KeyValueStoresRegisterkarte.

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

Der 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 dem CloudFront KeyValueStore API.

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:

• 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 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.

	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 ein ETagUUID, das und das ARN des Schlüsselwertspeichers zurück.	Gibt ein ETag und das ARN des Schlüsselwertspeichers zurück.

Hinweise

• Jede DescribeKeyValueStore Operation gibt eine andere zurückETag. Sie ETags sind nicht austauschbar.

• Wenn Sie einen API Vorgang aufrufen, um eine Aktion abzuschließen, müssen Sie den entsprechenden ETag API Namen angeben. In der CloudFront KeyValueStore DeleteKeyOperation geben Sie beispielsweise den anETag, den Sie von der CloudFront KeyValueStore DescribeKeyValueStoreOperation zurückgegeben haben.

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

Inhalt

• Schlüssel-Wert-Paare auflisten
• Rufen Sie Schlüssel-Wert-Paare ab
• Beschreiben Sie einen Schlüsselwertspeicher
• Erstellen Sie ein Schlüssel-Wert-Paar
• Löschen Sie ein Schlüssel-Wert-Paar
• Aktualisieren Sie Schlüssel-Wert-Paare

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.

Inhalt

• Holen Sie sich einen Verweis auf einen Schlüsselwertspeicher
• Ändern Sie Schlüssel-Wert-Paare in einem Schlüsselwertspeicher
• Beispielcode für CloudFront KeyValueStore

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:

Um einen Verweis auf einen Schlüsselwertspeicher abzurufen

1. Verwenden Sie den CloudFront ListKeyValueStoresAPIVorgang, um eine Liste von Schlüsselwertspeichern abzurufen. Suchen Sie den Schlüsselwertspeicher, den Sie ändern möchten.

2. Verwenden Sie die CloudFrontKeyValueStore DescribeKeyValueStoreAPIOperation und geben Sie den Schlüsselwertspeicher aus dem vorherigen Schritt an.

   Die Antwort beinhaltet das ARN und das ETag des Schlüsselwertspeichers.

   • Die ARN beinhaltet die AWS-Konto Zahl, die Konstante key-value-store und dieUUID, 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 Operationen an: CloudFront KeyValueStore API

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