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)
+ [Über den 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 der an AWS-Managementkonsole und öffnen Sie die Seite **Funktionen** 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** aus.
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.
## Ü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](cloudfront-function-restrictions.md#regional-endpoint-for-key-value-store).
Wenn Sie AWS Command Line Interface (AWS CLI) oder Ihren eigenen Code zum Aufrufen der CloudFront KeyValueStore API verwenden, finden Sie weitere Informationen in den folgenden Abschnitten.
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 Dienst, um mit Schlüssel-Wert-Paaren in einem *vorhandenen* Schlüsselwertspeicher 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 werden zu unterschiedlichen Zwecken aufgerufen. 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 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. In der CloudFront KeyValueStore [ DeleteKey](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_kvs_DeleteKey.html)Operation geben Sie beispielsweise die an, `ETag` die Sie von der CloudFront KeyValueStore [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 zurückgegeben haben.
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 mit Schlüssel-Wert-Paaren (AWS CLI)
Sie können die folgenden AWS Command Line Interface Befehle für ausführen. CloudFront KeyValueStore
**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
```
**Ausgabe**
```
{
"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 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:
**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 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`
+ 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 CloudFront KeyValueStore API-Operationen 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)— 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 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)— Sie können eine oder mehrere der folgenden Aktionen in einem all-or-nothing Vorgang ausführen:
+ 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);
}
})();
```