Funktionen erstellen

Sie erstellen eine Funktion in zwei Schritten:

1. Erstellen Sie den Funktionscode als JavaScript. Sie können das Standardbeispiel von der CloudFront Konsole aus verwenden oder ein eigenes schreiben. Weitere Informationen finden Sie unter den folgenden Themen:

   • Funktionscode schreiben

   • CloudFront Funktionen, Ereignisstruktur

   • Beispielcode für CloudFront Funktionen

2. Verwenden Sie CloudFront es, um die Funktion zu erstellen und Ihren Code einzufügen. Der Code ist innerhalb der Funktion vorhanden (nicht als Referenz).

Console

Eine Funktion erstellen

1. Melden Sie sich bei der CloudFront Konsole unter an https://console.aws.amazon.com/cloudfront/v4/home#/functions und wählen Sie die Seite Funktionen aus.

2. Wählen Sie Funktion erstellen.

3. Geben Sie einen Funktionsnamen ein, der innerhalb von eindeutig ist AWS-Konto, wählen Sie die JavaScript Version aus und klicken Sie dann auf Weiter. Die Seite mit den Details der neuen Funktion wird angezeigt.

   Anmerkung

   Um Schlüssel-Wert-Paare in der Funktion zu verwenden, müssen Sie JavaScript Runtime 2.0 wählen.

4. Wählen Sie im Abschnitt Funktionscode die Registerkarte Build und geben Sie Ihren Funktionscode ein. Der auf der Registerkarte Erstellen angezeigte Beispielcode veranschaulicht die grundlegende Syntax für den Funktionscode.

5. Wählen Sie Änderungen speichern aus.

6. Wenn der Funktionscode Schlüssel-Wert-Paare verwendet, müssen Sie einen Schlüsselwertspeicher zuordnen.

   Sie können den Schlüsselwertspeicher zuordnen, wenn Sie die Funktion zum ersten Mal erstellen. Sie können ihn auch später zuordnen, indem Sie die Funktion aktualisieren.

   Gehen Sie wie folgt vor, um jetzt einen Schlüsselwertspeicher zuzuordnen:

   • Gehen Sie zum KeyValueStore Bereich Assoziieren und wählen Sie Vorhandenes zuordnen aus KeyValueStore.

   • Wählen Sie den Schlüsselwertspeicher aus, der die Schlüssel-Wert-Paare in der Funktion enthält, und wählen Sie dann Assoziieren aus. KeyValueStore

   CloudFront ordnet den Speicher sofort der Funktion zu. Sie müssen die Funktion nicht speichern.

CLI

Wenn Sie die CLI verwenden, erstellen Sie normalerweise zuerst den Funktionscode in einer Datei und dann die Funktion mit der AWS CLI.

Eine Funktion erstellen

1. Erstellen Sie den Funktionscode in einer Datei und speichern Sie ihn in einem Verzeichnis, mit dem Ihr Computer eine Verbindung herstellen kann.

2. Führen Sie den Befehl wie im Beispiel veranschaulicht aus. In diesem Beispiel wird die fileb:// Notation verwendet, um die Datei zu übergeben. Es sind Zeilenumbrüche enthalten, um den Befehl lesbarer zu machen.

   aws cloudfront create-function \
       --name MaxAge \
       --function-config '{"Comment":"Max Age 2 years","Runtime":"cloudfront-js-2.0","KeyValueStoreAssociations":{"Quantity":1,"Items":[{"KeyValueStoreARN":"arn:aws:cloudfront::111122223333:key-value-store/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"}]}}' \
       --function-code fileb://function-max-age-v1.js
   

   Hinweise

   • Runtime— Die Version von JavaScript. Um Schlüssel-Wert-Paare in der Funktion zu verwenden, müssen Sie Version 2.0 angeben.

   • KeyValueStoreAssociations— Wenn Ihre Funktion Schlüssel-Wert-Paare verwendet, können Sie den Schlüsselwertspeicher zuordnen, wenn Sie die Funktion zum ersten Mal erstellen. Oder Sie können ihn später zuordnen, indem Sie. update-function Die Quantity ist immer 1, weil jeder Funktion nur ein Schlüsselwertspeicher zugeordnet werden kann.

   Wenn der Befehl erfolgreich ausgeführt wurde, wird die Ausgabe folgendermaßen angezeigt.

   ETag: ETVABCEXAMPLE
   FunctionSummary:
     FunctionConfig:
       Comment: Max Age 2 years
       Runtime: cloudfront-js-2.0
       KeyValueStoreAssociations= \
         {Quantity=1, \
         Items=[{KeyValueStoreARN='arn:aws:cloudfront::111122223333:key-value-store/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111'}]} \
     FunctionMetadata:
       CreatedTime: '2021-04-18T20:38:56.915000+00:00'
       FunctionARN: arn:aws:cloudfront::111122223333:function/MaxAge
       LastModifiedTime: '2023-11-19T20:38:56.915000+00:00'
       Stage: DEVELOPMENT
     Name: MaxAge
     Status: UNPUBLISHED
   Location: https://cloudfront.amazonaws.com/2020-05-31/function/arn:aws:cloudfront:::function/MaxAge

   Die meisten Informationen werden aus der Anfrage wiederholt. Weitere Informationen werden von hinzugefügt CloudFront.

   Hinweise

   • ETag— Dieser Wert ändert sich jedes Mal, wenn Sie den Schlüsselwertspeicher ändern. Sie verwenden diesen Wert und den Funktionsnamen, um in future auf die Funktion zu verweisen. Stellen Sie sicher, dass Sie immer den aktuellen verwendenETag.

   • FunctionARN— Der ARN für Ihre CloudFront Funktion.

   • 111122223333 — Das. AWS-Konto

   • Stage— Die Phase der Funktion (oder). LIVE DEVELOPMENT

   • Status— Der Status der Funktion (PUBLISHEDoderUNPUBLISHED).

Nachdem Sie die Funktion erstellt haben, wird sie der DEVELOPMENT Bühne hinzugefügt. Wir empfehlen Ihnen, Ihre Funktion zu testen, bevor Sie sie veröffentlichen. Nachdem Sie Ihre Funktion veröffentlicht haben, wechselt sie zur LIVE Phase.