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.
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.
- Console
-
So erstellen Sie einen Schlüsselwertspeicher
-
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.
-
Wählen Sie die Registerkarte KeyValueStores und dann KeyValueStore erstellen aus.
-
Geben Sie für den Schlüsselwertspeicher einen Namen und optional eine Beschreibung ein.
-
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.
-
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
-
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.
-
So fügen Sie die Paare jetzt hinzu:
-
Wählen Sie Schlüssel-Wert-Paare hinzufügen aus.
-
Wählen Sie Paar hinzufügen und geben Sie einen Namen und einen Wert ein. Wiederholen Sie diesen Schritt, um weitere Paare hinzuzufügen.
-
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.
-
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 oder Aktualisieren von Funktionen.
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
-
Verwenden Sie die Operation CloudFront CreateKeyValueStore. 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.
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.
|