Aktualisieren von Funktionen - Amazon CloudFront

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.

Aktualisieren von Funktionen

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-Phase in die LIVE-Phase zu kopieren, 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
So aktualisieren Sie den Funktionscode

  1. Melden Sie sich auf https://console.aws.amazon.com/cloudfront/v4/home#/functions bei der CloudFront-Konsole an und öffnen Sie die Seite Funktionen.

    Wählen Sie die zu aktualisierende Funktion aus.

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

    • Aktualisieren Sie die entsprechenden Felder im Abschnitt Details.

    • Ändern Sie den Funktionscode. Wählen Sie die Registerkarte Erstellen aus, nehmen Sie die entsprechenden Änderungen vor und wählen Sie dann Änderungen speichern aus, 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 Notation fileb:// 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 können die Funktion anhand ihres Namen und ETags (im if-match-Parameter) identifizieren. Stellen Sie sicher, dass Sie das aktuelle ETag verwenden. Sie können diesen Wert anhand der API-Operation DescribeFunction 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üsselwertspeicher-Zuordnung (falls vorhanden) beizubehalten, 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. Andere 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 Phase der Funktion (LIVE oder DEVELOPMENT)

  • Status – der Status der Funktion (PUBLISHED oder UNPUBLISHED)