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.
# Amazon CloudFront Schlüsselwertspeicher
Bei CloudFront KeyValueStore handelt es sich um einen sicheren, globalen Schlüsselwertdatenspeicher mit niedriger Latenz, der Lesezugriff von [CloudFront Functions](cloudfront-functions.md) aus ermöglicht und so eine erweiterte, anpassbare Logik an den CloudFront-Edge-Standorten ermöglicht.
Mit CloudFront KeyValueStore aktualisieren Sie unabhängig voneinander Funktionscode und Daten, die mit einer Funktion verknüpft sind. Diese Trennung vereinfacht den Funktionscode und erleichtert die Aktualisierung von Daten, ohne dass Codeänderungen vorgenommen werden müssen.
**Anmerkung**
Um CloudFront KeyValueStore verwenden zu können, muss Ihre CloudFront-Funktion die [JavaScript-Laufzeitumgebung 2.0](functions-javascript-runtime-20.md) verwenden.
Dies ist das allgemeine Verfahren für die Verwendung von Schlüssel-Wert-Paaren:
+ Erstellen Sie Schlüsselwertspeicher und füllen Sie sie mit einer Reihe von Schlüssel-Wert-Paaren. Sie können Ihre Schlüsselwertspeicher zu einem Amazon-S3-Bucket hinzufügen oder sie manuell eingeben.
+ Ordnen Sie die Schlüsselwertspeicher Ihrer CloudFront-Funktion zu.
+ Verwenden Sie in Ihrem Funktionscode den Namen des Schlüssels, um entweder den mit dem Schlüssel verknüpften Wert abzurufen oder um zu bestimmen, ob ein Schlüssel existiert. Weitere Informationen zur Verwendung von Schlüssel-Wert-Paaren im Funktionscode und zu Hilfsmethoden finden Sie unter [Hilfsmethoden für Schlüsselwertspeicher](functions-custom-methods.md).
## Anwendungsfälle
Sie können Schlüssel-Wert-Paare für die folgenden Beispiele verwenden:
+ **URL-Umschreibungen oder -Weiterleitungen** – Das Schlüssel-Wert-Paar kann die umgeschriebenen oder umgeleiteten URLs enthalten.
+ **A/B-Tests und Feature-Flags** – Sie können eine Funktion zur Durchführung von Experimenten erstellen, indem Sie einer bestimmten Version Ihrer Website einen Prozentsatz des Datenverkehrs zuweisen.
+ **Zugriffsberechtigung** – Sie können eine Zugriffskontrolle implementieren, um Anforderungen auf der Grundlage von Kriterien zuzulassen oder abzulehnen, die von Ihnen und den in einem Schlüsselwertspeicher gespeicherten Daten definiert wurden.
## Unterstützte Formate für Werte
Der Wert in einem Schlüssel-Wert-Paar kann in einem der folgenden Formate gespeichert werden:
+ String
+ bytekodierte Zeichenfolge
+ JSON
## Sicherheit
Die Sicherheit der CloudFront-Funktion und der Daten ihrer Schlüsselwertspeicher wird wie folgt sichergestellt:
+ CloudFront verschlüsselt jeden Schlüsselwertspeicher im Ruhezustand und während der Übertragung (beim Lesen oder Schreiben in den Schlüsselwertspeicher), wenn Sie die API-Operationen von [CloudFront KeyValueStore](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_Operations_Amazon_CloudFront_KeyValueStore.html) aufrufen.
+ Wenn die Funktion ausgeführt wird, entschlüsselt CloudFront jedes Schlüssel-Wert-Paar im Speicher an den CloudFront-Edge-Standorten.
Die ersten Schritte mit CloudFront KeyValueStore werden in den folgenden Themen erläutert.
**Topics**
+ [Anwendungsfälle](#key-value-store-use-cases)
+ [Unterstützte Formate für Werte](#key-value-store-supported-formats)
+ [Sicherheit](#key-value-store-security)
+ [Arbeiten mit einem Schlüsselwertspeicher](kvs-with-functions-kvs.md)
+ [Arbeiten mit Schlüsselwertdaten](kvs-with-functions-kvp.md)
+ Weitere Informationen zu den ersten Schritten mit CloudFront KeyValueStore finden Sie im AWS-Blogbeitrag [Introducing Amazon CloudFront KeyValueStore](https://aws.amazon.com/blogs/aws/introducing-amazon-cloudfront-keyvaluestore-a-low-latency-datastore-for-cloudfront-functions/).
# Arbeiten mit einem Schlüsselwertspeicher
Sie müssen einen Schlüsselwertspeicher für die Schlüssel-Wert-Paare erstellen, die Sie in CloudFront Functions verwenden möchten.
Nachdem Sie den Schlüsselwertspeicher erstellt und Schlüssel-Wert-Paare hinzugefügt haben, können Sie die Schlüsselwerte in Ihrem CloudFront-Funktionscode verwenden.
Die ersten Schritte werden in den folgenden Themen behandelt:
**Topics**
+ [Erstellen eines Schlüsselwertspeichers](kvs-with-functions-create.md)
+ [Zuordnen eines Schlüsselwertspeichers zu einer Funktion](kvs-with-functions-associate.md)
+ [Aktualisieren eines Schlüsselwertspeichers](kvs-with-functions-edit.md)
+ [Abrufen eines Verweises auf einen Schlüsselwertspeicher](kvs-with-functions-get-reference.md)
+ [Löschen eines Schlüsselwertspeichers](kvs-with-functions-delete.md)
+ [Dateiformat für Schlüssel-Wert-Paare](kvs-with-functions-create-s3-kvp.md)
**Anmerkung**
Die JavaScript-Runtime 2.0 enthält einige Hilfsmethoden für die Arbeit mit Schlüsselwerten im Funktionscode. Weitere Informationen finden Sie unter [Hilfsmethoden für Schlüsselwertspeicher](functions-custom-methods.md).
# Erstellen eines Schlüsselwertspeichers
Sie können einen Schlüsselwertspeicher und seine Schlüssel-Wert-Paare gleichzeitig erstellen. Sie können auch einen leeren Schlüsselwertspeicher erstellen und später die Schlüssel-Wert-Paare hinzufügen.
**Anmerkung**
Wenn Sie einen Amazon-S3-Bucket als Ihre Datenquelle angeben, benötigen Sie die `s3:GetBucketLocation`- und `s3:GetObject`-Berechtigungen für diesen Bucket. Wenn Sie nicht über diese Berechtigungen verfügen, kann CloudFront Ihren Schlüsselwertspeicher nicht erfolgreich erstellen.
Entscheiden Sie, ob Sie Schlüssel-Wert-Paare zeitgleich zur Erstellung des Schlüsselwertspeichers hinzufügen möchten. Sie können Ihre Schlüssel-Wert-Paare mithilfe der CloudFront-Konsole, der CloudFront-API oder der AWS SDKs importieren. Sie können Ihre Datei mit Schlüssel-Wert-Paaren jedoch nur dann importieren, wenn Sie den Schlüsselwertspeicher *neu* erstellen.
Informationen zum Erstellen einer Datei mit Schlüssel-Wert-Paaren finden Sie unter [Dateiformat für Schlüssel-Wert-Paare](kvs-with-functions-create-s3-kvp.md).
------
#### [ Console ]
**So erstellen Sie einen Schlüsselwertspeicher**
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](https://console.aws.amazon.com/cloudfront/v4/home#/functions).
1. Wählen Sie die Registerkarte **KeyValueStores** und dann **KeyValueStore erstellen** aus.
1. Geben Sie für den Schlüsselwertspeicher einen Namen und optional eine Beschreibung ein.
1. Vollständige **S3-URI**:
+ Wenn Sie über eine Datei mit Schlüssel-Wert-Paaren verfügen, geben Sie den Pfad zum Amazon-S3-Bucket ein, in dem Sie die Datei gespeichert haben.
+ Lassen Sie dieses Feld leer, wenn Sie die Schlüssel-Wert-Paare manuell eingeben möchten.
1. Wählen Sie **Erstellen** aus. Der Schlüsselwertspeicher ist jetzt vorhanden.
Die Seite mit den Details für den neuen Schlüsselwertspeicher wird angezeigt. Die Informationen auf der Seite umfassen die ID und den ARN des Schlüsselwertspeichers.
+ Die ID ist eine zufällige Zeichenfolge, die in Ihrem AWS-Konto einzigartig ist.
+ Der ARN hat folgende Syntax:
*AWS-Konto`:key-value-store/`**ID des Schlüsselwertspeichers*
1. Sehen Sie sich den Abschnitt **Schlüssel-Wert-Paare** an. Wenn Sie eine Datei importiert haben, werden in diesem Abschnitt einige Schlüssel-Wert-Paare angezeigt. Sie haben die folgenden Möglichkeiten:
+ Wenn Sie eine Datei importiert haben, können Sie weitere Werte manuell hinzufügen.
+ Wenn Sie keine Datei aus einem Amazon-S3-Bucket importiert haben und jetzt Schlüssel-Wert-Paare hinzufügen möchten, können Sie den nächsten Schritt ausführen.
+ Sie können diesen Schritt überspringen und die Schlüssel-Wert-Paare später hinzufügen.
1. So fügen Sie die Paare jetzt hinzu:
1. Wählen Sie **Schlüssel-Wert-Paare hinzufügen** aus.
1. Wählen Sie **Paar hinzufügen** und geben Sie einen Namen und einen Wert ein. Wiederholen Sie diesen Schritt, um weitere Paare hinzuzufügen.
1. Wenn Sie fertig sind, wählen Sie **Änderungen speichern**, um alle Schlüssel-Wert-Paare im Schlüsselwertspeicher zu speichern. Wählen Sie im angezeigten Dialogfeld **Ja** aus.
1. Wenn Sie den Schlüsselwertspeicher jetzt einer Funktion zuordnen möchten, füllen Sie den Abschnitt **Zugeordnete Funktionen** aus. Weitere Informationen finden Sie unter [Erstellen von Funktionen](create-function.md) oder [Aktualisieren von Funktionen](update-function.md).
Sie können die Funktion auch später zuordnen und zwar entweder auf der Detailseite des Schlüsselwertspeichers oder auf der Detailseite der Funktionen.
------
#### [ AWS CLI ]
**So erstellen Sie einen Schlüsselwertspeicher**
+ Führen Sie den folgenden Befehl aus, um einen Schlüsselwertspeicher zu erstellen und die Schlüssel-Wert-Paare aus einem Amazon-S3-Bucket zu importieren.
```
aws cloudfront create-key-value-store \
--name=keyvaluestore1 \
--comment="This is my key value store file" \
--import-source=SourceType=S3,SourceARN=arn:aws:s3:::amzn-s3-demo-bucket1/kvs-input.json
```
**Antwort**
```
{
"ETag": "ETVABCEXAMPLE",
"Location": "https://cloudfront.amazonaws.com/2020-05-31/key-value-store/arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example",
"KeyValueStore": {
"Name": "keyvaluestore1",
"Id": "8aa76c93-3198-462c-aaf6-example",
"Comment": "This is my key value store file",
"ARN": "arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example",
"Status": "PROVISIONING",
"LastModifiedTime": "2024-08-06T22:19:10.813000+00:00"
}
}
```
------
#### [ API ]
**So erstellen Sie einen Schlüsselwertspeicher**
1. Verwenden Sie die Operation [CloudFront CreateKeyValueStore](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_CreateKeyValueStore.html). Für diese Operation sind mehrere Parameter erforderlich:
+ ein `name` des Schlüsselwertspeichers.
+ Ein `comment`-Parameter mit einem Kommentar.
+ ein `import-source`-Parameter, mit dem Sie Schlüssel-Wert-Paare aus einer Datei importieren können, die in einem Amazon-S3-Bucket gespeichert ist. Der Import aus einer Datei ist nur beim Erstellen des Schlüsselwertspeichers möglich. Weitere Informationen zur Dateistruktur finden Sie unter [Dateiformat für Schlüssel-Wert-Paare](kvs-with-functions-create-s3-kvp.md).
Die Operationsantwort enthält die folgenden Informationen:
+ Die in der Anforderung übergebenen Werte, einschließlich des von Ihnen zugewiesenen Namens.
+ Daten wie die Erstellungszeit.
+ ein `ETag` (z. B. `ETVABCEXAMPLE`), der ARN mit dem Namen des Schlüsselwertspeichers (z. B. `arn:aws:cloudfront::123456789012:key-value-store/keyvaluestore1`).
Sie verwenden eine Kombination aus `ETag`, ARN und dem Namen, um programmgesteuert mit dem Schlüsselwertspeicher zu arbeiten.
------
## Statuswerte des Schlüsselwertspeichers
Wenn Sie einen Schlüsselwertspeicher erstellen, kann der Datenspeicher die folgenden Statuswerte haben.
****
| Wert | Beschreibung |
| --- | --- |
| **Bereitstellung** | Der Schlüsselwertspeicher wurde erstellt und CloudFront verarbeitet die von Ihnen angegebene Datenquelle. |
| **Bereit** | Der Schlüsselwertspeicher wurde erstellt und CloudFront hat die von Ihnen angegebene Datenquelle erfolgreich verarbeitet. |
| **Import fehlgeschlagen** | CloudFront konnte die von Ihnen angegebene Datenquelle nicht verarbeiten. Dieser Status kann angezeigt werden, wenn Ihr Dateiformat nicht gültig ist oder wenn die Datei die Größenbeschränkung überschreitet. Weitere Informationen finden Sie unter [Dateiformat für Schlüssel-Wert-Paare](kvs-with-functions-create-s3-kvp.md). |
# Zuordnen eines Schlüsselwertspeichers zu einer Funktion
Nachdem Sie Ihren Schlüsselwertspeicher erstellt haben, können Sie Ihre Funktion aktualisieren, um sie Ihrem Schlüsselwertspeicher zuzuordnen. Sie müssen diese Zuordnung vornehmen, um die Schlüssel-Wert-Paare aus diesem Speicher in dieser Funktion verwenden zu können. Die folgenden Regeln gelten:
+ Eine Funktion kann nur einen Schlüsselwertspeicher haben.
+ Ein Schlüsselwertspeicher kann mehreren Funktionen zugeordnet werden.
------
#### [ Console ]
**So ordnen Sie einen Schlüsselwertspeicher einer Funktion zu**
1. Melden Sie sich auf [https://console.aws.amazon.com/cloudfront/v4/home#/functions](https://console.aws.amazon.com/cloudfront/v4/home#/functions) bei der CloudFront-Konsole an und öffnen Sie die Seite **Funktionen**.
1. Wählen Sie den Funktionsnamen aus.
1. Wählen Sie im Abschnitt **KeyValueStore zuordnen** die Option **Vorhandenen KeyValueStore zuordnen** aus.
1. Wählen Sie den Schlüsselwertspeicher, der die Schlüssel-Wert-Paare in der Funktion enthält, und dann **KeyValueStore zuordnen** aus.
CloudFront ordnet den Store sofort der Funktion zu. Sie müssen die Funktion nicht speichern.
1. Um einen anderen Schlüsselwertspeicher anzugeben, wählen Sie **Zugeordneten KeyValueStore aktualisieren**, den Namen eines anderen Schlüsselwertspeichers und anschließend **KeyValueStore zuordnen** aus.
Weitere Informationen finden Sie unter [Aktualisieren von Funktionen](update-function.md).
------
#### [ AWS CLI ]
**So ordnen Sie einen Schlüsselwertspeicher einer Funktion zu**
+ Führen Sie den folgenden Befehl aus, um die `MaxAge`-Funktion zu aktualisieren und eine Schlüsselwertspeicherressource zuzuordnen.
```
aws cloudfront update-function \
--name MaxAge \
--function-config '{"Comment":"Max Age 2 years","Runtime":"cloudfront-js-2.0","KeyValueStoreAssociations":{"Quantity":1,"Items":[{"KeyValueStoreARN":"arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example"}]}}' \
--function-code fileb://function-max-age-v1.js \
--if-match ETVABCEXAMPLE
```
+ Um einen Schlüsselwertspeicher einer Funktion zuzuordnen, geben Sie den Parameter `KeyValueStoreAssociations` und den ARN des Schlüsselwertspeichers an.
+ Um die Zuordnung zu ändern, geben Sie den ARN eines anderen Schlüsselwertspeichers an.
+ Um die Zuordnung zu entfernen, entfernen Sie den Parameter `KeyValueStoreAssociations`.
Weitere Informationen finden Sie unter [Aktualisieren von Funktionen](update-function.md).
------
#### [ API ]
**So ordnen Sie einen Schlüsselwertspeicher einer Funktion zu**
+ Verwenden Sie die API-Operation [UpdateFunction](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateFunction.html). Weitere Informationen finden Sie unter [Aktualisieren von Funktionen](update-function.md).
------
**Hinweise**
Wenn Sie einen Schlüsselwertspeicher bearbeiten, ohne die Schlüssel-Wert-Paare zu ändern, oder wenn Sie nur die Schlüssel-Wert-Paare im Schlüsselwertspeicher bearbeiten, müssen Sie den Schlüsselwertspeicher nicht erneut zuordnen. Sie müssen die Funktion auch nicht erneut veröffentlichen.
Wir empfehlen jedoch, die Funktion zu testen, um zu überprüfen, ob sie erwartungsgemäß funktioniert. Weitere Informationen finden Sie unter [Testfunktionen](test-function.md).
Sie können alle Funktionen anzeigen, die bestimmte Schlüsselwertspeicher verwenden. Öffnen Sie in der CloudFront-Konsole die Detailseite des Schlüsselwertspeichers.
# Aktualisieren eines Schlüsselwertspeichers
Wenn Sie einen Schlüsselwertspeicher aktualisieren, können Sie die Schlüssel-Wert-Paare ändern oder die Zuordnung zwischen dem Schlüsselwertspeicher und der Funktion ändern.
------
#### [ Console ]
**So aktualisieren Sie einen Schlüsselwertspeicher**
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](https://console.aws.amazon.com/cloudfront/v4/home#/functions).
1. Wählen Sie die Registerkarte **KeyValueStores**.
1. Wählen Sie den Schlüsselwertspeicher aus, den Sie aktualisieren möchten.
+ Um die Schlüssel-Wert-Paare zu aktualisieren, wählen Sie **Bearbeiten** im Abschnitt **Schlüssel-Wert-Paare** aus. Sie können beliebige Schlüssel-Wert-Paare hinzufügen oder löschen. Sie können auch den Wert eines vorhandenen Schlüssel-Wert-Paares ändern. Wenn Sie fertig sind, wählen Sie **Änderungen speichern** aus.
+ Um die Zuordnung dieses Schlüsselwertspeichers zu aktualisieren, wählen Sie **Gehe zu Funktionen** aus. Weitere Informationen finden Sie unter [Zuordnen eines Schlüsselwertspeichers zu einer Funktion](kvs-with-functions-associate.md).
------
#### [ AWS CLI ]
**So aktualisieren Sie einen Schlüsselwertspeicher**
1. **Ändern der Schlüssel-Wert-Paare** – Sie können weitere Schlüssel-Wert-Paare hinzufügen, ein oder mehrere Schlüssel-Wert-Paare löschen und den Wert für ein vorhandenes Schlüssel-Wert-Paar ändern. Weitere Informationen finden Sie unter [Arbeiten mit Schlüsselwertdaten](kvs-with-functions-kvp.md).
1. **Ändern der Funktionszuordnung für den Schlüsselwertspeicher** – Informationen zum Aktualisieren der Funktionszuordnung für den Schlüsselwertspeicher finden Sie unter [Zuordnen eines Schlüsselwertspeichers zu einer Funktion](kvs-with-functions-associate.md).
**Tipp**
Sie benötigen den ARN des Schlüsselwertspeichers. Weitere Informationen finden Sie unter [Abrufen eines Verweises auf einen Schlüsselwertspeicher](kvs-with-functions-get-reference.md).
------
#### [ API ]
**So aktualisieren Sie einen Schlüsselwertspeicher**
1. **Ändern der Schlüssel-Wert-Paare** – Sie können weitere Schlüssel-Wert-Paare hinzufügen, ein oder mehrere Schlüssel-Wert-Paare löschen und den Wert für ein vorhandenes Schlüssel-Wert-Paar ändern. Weitere Informationen finden Sie unter [Arbeiten mit Schlüsselwertdaten](kvs-with-functions-kvp.md).
1. **Ändern der Funktionszuordnung für den Schlüsselwertspeicher** – Verwenden Sie zum Aktualisieren der Funktionszuordnung für den Schlüsselwertspeicher die API-Operation [UpdateFunction](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateFunction.html). Weitere Informationen finden Sie unter [Aktualisieren von Funktionen](update-function.md).
**Tipp**
Sie benötigen den ARN des Schlüsselwertspeichers. Weitere Informationen finden Sie unter [Abrufen eines Verweises auf einen Schlüsselwertspeicher](kvs-with-functions-get-reference.md).
------
# Abrufen eines Verweises auf einen Schlüsselwertspeicher
Sie benötigen das `ETag` und den Namen des Schlüsselwertspeichers, um programmgesteuert mit dem Schlüsselwertspeicher arbeiten zu können.
Um beide Werte abzurufen, können Sie die AWS Command Line Interface (AWS CLI) oder die CloudFront-API verwenden.
------
#### [ AWS CLI ]
**So rufen Sie den Verweis auf einen Schlüsselwertspeicher ab**
1. Um eine Liste von Schlüsselwertspeichern abzurufen, führen Sie den folgenden Befehl aus. Suchen Sie den Namen des Schlüsselwertspeichers, den Sie bearbeiten möchten.
```
aws cloudfront list-key-value-stores
```
1. Suchen Sie in der Antwort den Namen des gewünschten Schlüsselwertspeichers.
**Antwort**
```
{
"KeyValueStoreList": {
"Items": [
{
"Name": "keyvaluestore3",
"Id": "37435e19-c205-4271-9e5c-example3",
"ARN": "arn:aws:cloudfront::123456789012:key-value-store/37435e19-c205-4271-9e5c-example3",
"Status": "READY",
"LastModifiedTime": "2024-05-08T14:50:18.876000+00:00"
},
{
"Name": "keyvaluestore2",
"Id": "47970d59-6408-474d-b850-example2",
"ARN": "arn:aws:cloudfront::123456789012:key-value-store/47970d59-6408-474d-b850-example2",
"Status": "READY",
"LastModifiedTime": "2024-05-30T21:06:22.113000+00:00"
},
{
"Name": "keyvaluestore1",
"Id": "8aa76c93-3198-462c-aaf6-example",
"ARN": "arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example",
"Status": "READY",
"LastModifiedTime": "2024-08-06T22:19:30.510000+00:00"
}
]
}
}
```
1. Führen Sie den folgenden Befehl aus, um das `ETag` für den angegebenen Schlüsselwertspeicher abzurufen.
```
aws cloudfront describe-key-value-store \
--name=keyvaluestore1
```
**Antwort**
```
{
"ETag": "E3UN6WX5RRO2AG",
"KeyValueStore": {
"Name": "keyvaluestore1",
"Id": "8aa76c93-3198-462c-aaf6-example",
"Comment": "This is an example KVS",
"ARN": "arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example",
"Status": "READY",
"LastModifiedTime": "2024-08-06T22:19:30.510000+00:00"
}
}
```
------
#### [ API ]
**So rufen Sie den Verweis auf einen Schlüsselwertspeicher ab**
1. Verwenden Sie die API-Operation [https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListKeyValueStores.html](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListKeyValueStores.html), um eine Liste von Schlüsselwertspeichern abzurufen. Suchen Sie den Namen des Schlüsselwertspeichers aus, den Sie ändern möchten.
1. Verwenden Sie die API-Operation [https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_DescribeKeyValueStore.html](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_DescribeKeyValueStore.html) und geben Sie den Namen des im vorherigen Schritt zurückgegebenen Schlüsselwertspeichers an.
------
Die Antwort enthält eine UUID, den ARN des Schlüsselwertspeichers und das `ETag` des Schlüsselwertspeichers.
+ Das `ETag` ähnelt dem im Beispiel angegebenen `E3UN6WX5RRO2AG`.
+ Die UUID ist 128 Bit groß, wie z. B. `8aa76c93-3198-462c-aaf6-example`.
+ 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/8aa76c93-3198-462c-aaf6-example`
Weitere Informationen über die `DescribeKeyValueStore`-Operation finden Sie unter [Informationen zum CloudFront KeyValueStore](kvs-with-functions-kvp.md#kvs-with-functions-api-describe).
# Löschen eines Schlüsselwertspeichers
Sie können Ihren Schlüsselwertspeicher mit der Amazon-CloudFront-Konsole oder der API löschen.
------
#### [ Console ]
**So löschen Sie einen Schlüsselwertspeicher**
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](https://console.aws.amazon.com/cloudfront/v4/home#/functions).
1. Wählen Sie den Funktionsnamen aus.
1. Überprüfen Sie im Abschnitt **Zugeordneter KeyValueStore**, ob der Funktion ein Schlüsselwertspeicher zugeordnet ist. Ist dies der Fall, entfernen Sie die Zuordnung, indem Sie **KeyValueStore trennen** und dann **Zuordnung entfernen** auswählen.
1. Wählen Sie im Navigationsbereich die Seite **Funktionen** und dann die Registerkarte **KeyValueStores** aus.
1. Wählen Sie den zu löschenden Schlüsselwertspeicher und dann **Löschen** aus.
------
#### [ AWS CLI ]
**So löschen Sie einen Schlüsselwertspeicher**
1. Rufen Sie das `ETag` und den Namen des Schlüsselwertspeichers ab. Weitere Informationen finden Sie unter [Abrufen eines Verweises auf einen Schlüsselwertspeicher](kvs-with-functions-get-reference.md).
1. Überprüfen Sie, ob der Schlüsselwertspeicher einer Funktion zugeordnet ist. Wenn dies der Fall ist, entfernen Sie die Zuordnung. Weitere Informationen zu diesen beiden Schritten finden Sie unter [Aktualisieren von Funktionen](update-function.md).
1. Wenn Sie den Namen und das `ETag` des Schlüsselwertspeichers abgerufen haben und dieser nicht mehr mit einer Funktion verknüpft ist, können Sie ihn löschen.
Führen Sie den folgenden Befehl aus, um den angegebenen Schlüsselwertspeicher zu löschen.
```
aws cloudfront delete-key-value-store \
--name=keyvaluestore1 \
--if-match=E3UN6WX5RRO2AG
```
------
#### [ API ]
**So löschen Sie einen Schlüsselwertspeicher**
1. Rufen Sie das `ETag` und den Namen des Schlüsselwertspeichers ab. Weitere Informationen finden Sie unter [Abrufen eines Verweises auf einen Schlüsselwertspeicher](kvs-with-functions-get-reference.md).
1. Überprüfen Sie, ob der Schlüsselwertspeicher einer Funktion zugeordnet ist. Wenn dies der Fall ist, entfernen Sie die Zuordnung. Weitere Informationen zu diesen beiden Schritten finden Sie unter [Aktualisieren von Funktionen](update-function.md).
1. Verwenden Sie die CloudFront-API-Operation [https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_DeleteKeyValueStore.html](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_DeleteKeyValueStore.html), um den Schlüsselwertspeicher zu löschen.
------
# Dateiformat für Schlüssel-Wert-Paare
Verwenden Sie das folgende JSON-Format, wenn Sie eine UTF-8-kodierte Datei erstellen:
```
{
"data":[
{
"key":"key1",
"value":"value"
},
{
"key":"key2",
"value":"value"
}
]
}
```
Ihre Datei darf keine doppelten Schlüssel enthalten. Wenn Sie in Ihrem Amazon-S3-Bucket eine ungültige Datei angegeben haben, können Sie die Datei aktualisieren, um alle Duplikate zu entfernen, und dann erneut versuchen, Ihren Schlüsselwertspeicher zu erstellen.
Weitere Informationen finden Sie unter [Erstellen eines Schlüsselwertspeichers](kvs-with-functions-create.md).
**Anmerkung**
Die Datei für Ihre Datenquelle und ihre Schlüssel-Wert-Paare haben die folgenden Beschränkungen:
Dateigröße – 5 MB
Schlüsselgröße – 512 Zeichen
Wertgröße – 1 024 Zeichen
# 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](kvs-with-functions-create.md).
**Topics**
+ [Arbeiten mit Schlüssel-Wert-Paaren (Konsole)](#kvs-with-functions-kvp-using-console)
+ [Informationen zum CloudFront KeyValueStore](#kvs-with-functions-api-describe)
+ [Arbeiten mit Schlüssel-Wert-Paaren (AWS CLI)](#work-with-kvs-cli-keys)
+ [Arbeiten mit Schlüssel-Wert-Paaren (API)](#kvs-with-functions-kvp-using-api)
## 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](https://console.aws.amazon.com/cloudfront/v4/home#/functions).
1. Wählen Sie die Registerkarte **KeyValueStores**.
1. Wählen Sie den Schlüsselwertspeicher aus, den Sie bearbeiten möchten.
1. Wählen Sie im Abschnitt **Schlüssel-Wert-Paare** die Option **Bearbeiten** aus.
1. 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.
1. 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](cloudfront-function-restrictions.md#regional-endpoint-for-key-value-store).
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](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_DeleteKey.html)-Operation für CloudFront KeyValueStore das `ETag` an, das bei der [https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_DescribeKeyValueStore.html](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_DescribeKeyValueStore.html)-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.
**Contents**
+ [Auflisten von Schlüssel-Wert-Paaren](#kvs-cli-list-keys)
+ [Abrufen von Schlüssel-Wert-Paaren](#kvs-cli-get-keys)
+ [Beschreiben eines Schlüsselwertspeichers](#kvs-cli-describe-keys)
+ [Erstellen eines Schlüssel-Wert-Paares](#kvs-cli-create-keys)
+ [Löschen eines Schlüssel-Wert-Paares](#kvs-cli-delete-keys)
+ [Aktualisieren eines Schlüssel-Wert-Paares](#kvs-cli-update-key)
### 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.
**Contents**
+ [Abrufen eines Verweises auf einen Schlüsselwertspeicher](#kvs-with-functions-api-ref)
+ [Ändern von Schlüssel-Wert-Paaren in einem Schlüsselwertspeicher](#kvs-with-functions-api-actions)
+ [Beispielcode für CloudFront KeyValueStore](#example-code-key-value-store)
### 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 [https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListKeyValueStores.html](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListKeyValueStores.html), um eine Liste von Schlüsselwertspeichern abzurufen. Suchen Sie den Schlüsselwertspeicher, den Sie bearbeiten möchten.
1. Verwenden Sie die [API-Operation CloudFrontKeyValueStore DescribeKeyValueStore](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_DescribeKeyValueStore.html) 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](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_DeleteKey.html) – löscht ein Schlüssel-Wert-Paar
+ [CloudFrontKeyValueStore GetKey](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_GetKey.html) – gibt ein Schlüssel-Wert-Paar zurück
+ [CloudFrontKeyValueStore ListKeys](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_ListKeys.html) – gibt eine Liste von Schlüssel-Wert-Paaren zurück
+ [CloudFrontKeyValueStore PutKey](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_PutKey.html) – 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](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_UpdateKeys.html) – 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
**Example**
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);
}
})();
```