Funktionen aktualisieren

Sie können eine Funktion jederzeit aktualisieren. Die Änderungen werden nur an der Version der Funktion vorgenommen, die sich in der DEVELOPMENT-Phase befindet. Um die Updates von der DEVELOPMENT Stage nach zu kopierenLIVE, müssen Sie die Funktion veröffentlichen.

Sie können den Code einer Funktion in der CloudFront Konsole oder mit der AWS Command Line Interface (AWS CLI) aktualisieren.

Console

Um den Funktionscode zu aktualisieren

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.

   Wählen Sie die zu aktualisierende Funktion aus.

2. Wählen Sie Bearbeiten und nehmen Sie die folgenden Änderungen vor:

   • Aktualisieren Sie alle Felder im Bereich „Details“.

   • Ändern oder entfernen Sie den zugehörigen Schlüsselwertspeicher. Weitere Hinweise zu Schlüsselwertspeichern finden Sie unter Amazon CloudFront KeyValueStore.

   • Ändern Sie den Funktionscode. Wählen Sie die Registerkarte Erstellen, nehmen Sie die Änderungen vor und wählen Sie dann Änderungen speichern, um die Änderungen am Code zu speichern.

CLI

So aktualisieren Sie den Funktionscode:

1. Öffnen Sie ein Befehlszeilenfenster.

2. Führen Sie den folgenden Befehl 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 update-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 \
       --if-match ETVABCEXAMPLE
   

   Hinweise

   • Sie identifizieren die Funktion mit ihrem Namen und ETag (im if-match-Parameter). Stellen Sie sicher, dass Sie das aktuelle ETag verwenden. Sie können es mithilfe eines Beschreibungsvorgangs abrufen.

   • Sie müssen den function-code angeben, auch wenn Sie ihn nicht ändern möchten.

   • Seien Sie vorsichtig mit der function-config. Sie sollten alles übergeben, was Sie in der Konfiguration beibehalten möchten. Gehen Sie insbesondere mit dem Schlüsselwertspeicher folgendermaßen vor:

     • Um die bestehende Schlüsselwertspeicherzuordnung beizubehalten (falls vorhanden), geben Sie den Namen des vorhandenen Speichers an.

     • Um die Zuordnung zu ändern, geben Sie den Namen des neuen Schlüsselwertspeichers an.

     • Um die Zuordnung zu entfernen, lassen Sie den KeyValueStoreAssociations Parameter weg.

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

   ETag: ETVXYZEXAMPLE
   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-12-19T23:41:15.389000+00:00' \
       Stage: DEVELOPMENT \
     Name: MaxAge \
     Status: UNPUBLISHED

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

Hinweise

• ETag— Dieser Wert ändert sich jedes Mal, wenn Sie den Schlüsselwertspeicher ändern.

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

• Stage— Die Bühne für die Funktion (LIVEoderDEVELOPMENT).

• Status— Der Status der Funktion (PUBLISHEDoderUNPUBLISHED).