Erstellen Sie einen Schlüsselwertspeicher

Sie können einen Schlüsselwertspeicher und seine Schlüssel-Wert-Paare gleichzeitig erstellen. Sie können jetzt auch einen leeren Schlüsselwertspeicher erstellen und die Schlüssel-Wert-Paare später hinzufügen.

Anmerkung

Wenn Sie Ihre Datenquelle aus einem Amazon S3 S3-Bucket angeben, benötigen Sie die s3:GetBucketLocation Berechtigungen s3:GetObject und für diesen Bucket. Wenn Sie nicht über diese Berechtigungen verfügen, CloudFront kann Ihr Key Value Store nicht erfolgreich erstellt werden.

Entscheiden Sie, ob Sie beim Erstellen des Schlüsselwertspeichers gleichzeitig Schlüssel-Wert-Paare hinzufügen möchten. Sie können Ihre Schlüssel-Wert-Paare mithilfe der CloudFront Konsole, oder importieren. CloudFront API AWS SDKs Sie können Ihre Datei mit Schlüssel-Wert-Paaren jedoch nur importieren, wenn Sie den Schlüssel-Wert-Speicher zum ersten Mal 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

1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die Seite Funktionen in der CloudFront Konsole unterhttps://console.aws.amazon.com/cloudfront/v4/home#/functions.

2. Wählen Sie die KeyValueStoresRegisterkarte und dann Erstellen aus KeyValueStore.

3. Geben Sie für den Schlüsselwertspeicher einen Namen und optional eine Beschreibung ein.

4. Schließe S3 abURI:

   • Wenn Sie eine Datei mit Schlüssel-Wert-Paaren haben, geben Sie den Pfad zu dem Amazon S3 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.

5. Wählen Sie Create (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 beinhalten die ID und die ARN des Schlüsselwertspeichers.

   • Die ID ist eine zufällige Zeichenfolge, die für Sie einzigartig ist AWS-Konto.

   • Der ARN hat diese Syntax:

     AWS-Konto:key-value-store/the key value stores ID

6. 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 auch manuell hinzufügen.

   • Wenn Sie keine Datei aus einem Amazon S3 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.

7. So fügen Sie die Paare jetzt hinzu:

   1. Wählen Sie Schlüssel-Wert-Paare hinzufügen aus.

   2. Wählen Sie Paar hinzufügen und geben Sie einen Namen und einen Wert ein. Wiederholen Sie diesen Schritt, um weitere Paare hinzuzufügen.

   3. Wenn Sie fertig sind, wählen Sie Änderungen speichern, um alle Schlüssel-Wert-Paare im Schlüsselwertspeicher zu speichern. Wählen Sie im daraufhin angezeigten Dialogfeld „Fertig“ aus.

8. Um den Schlüsselwertspeicher jetzt mit einer Funktion zu verknüpfen, füllen Sie den Abschnitt Zugeordnete Funktionen aus. Weitere Informationen finden Sie unter Funktionen erstellen oder Funktionen aktualisieren.

   Sie können die Funktion auch später zuordnen, entweder von dieser Detailseite des Schlüsselwertspeichers oder von der Detailseite der Funktion aus.

AWS CLI

Um einen Schlüsselwertspeicher zu erstellen

• Führen Sie den folgenden Befehl aus, um einen Schlüsselwertspeicher zu erstellen und die Schlüssel-Wert-Paare aus einem Amazon S3 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

Um einen Key-Value-Store zu erstellen

1. Verwenden Sie die CloudFrontCreateKeyValueStoreOperation. Für diese Operation sind mehrere Parameter erforderlich:

   • A 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 S3-Bucket gespeichert ist. Sie können nur dann aus einer Datei importieren, wenn Sie den Key-Value-Store zum ersten Mal erstellen. Hinweise zur Dateistruktur finden Sie unterDateiformat 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), ARN das den Namen des Schlüsselwertspeichers enthält (z. B.arn:aws:cloudfront::123456789012:key-value-store/keyvaluestore1).

  Sie werden eine Kombination aus demETag, dem und dem Namen verwendenARN, um programmgesteuert mit dem Schlüsselwertspeicher zu arbeiten.

Status des Speichers von Schlüsselwerten

Wenn Sie einen Schlüsselwertspeicher erstellen, kann der Datenspeicher die folgenden Statuswerte haben.

Wert	Beschreibung
Bereitstellung	Der Schlüsselwertspeicher wurde erstellt und verarbeitet CloudFront derzeit die von Ihnen angegebene Datenquelle.
Bereit	Der Schlüsselwertspeicher wurde erstellt und die von Ihnen angegebene Datenquelle wurde CloudFront erfolgreich verarbeitet.
Der Import ist fehlgeschlagen	CloudFront konnte die von Ihnen angegebene Datenquelle nicht verarbeiten. Dieser Status kann angezeigt werden, wenn Ihr Dateiformat nicht gültig ist oder wenn es die Größenbeschränkung überschreitet. Weitere Informationen finden Sie unter Dateiformat für Schlüssel-Wert-Paare.