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