Erstellen von Ursprungsanforderungsrichtlinien - 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.

Erstellen von Ursprungsanforderungsrichtlinien

Mit einer Ursprungsanforderungsrichtlinie können Sie die Werte (URL-Abfragezeichenfolgen, HTTP-Header und Cookies) steuern, die in Anforderungen enthalten sind, die CloudFront an Ihren Ursprung sendet. Sie können eine Ursprungsanforderungsrichtlinie in der CloudFront-Konsole, über die AWS Command Line Interface (AWS CLI) oder über die CloudFront-API erstellen.

Nach der Erstellung der Ursprungsanforderungsrichtlinie fügen Sie sie einer oder mehreren Zwischenspeicher-Verhaltensweisen in einer CloudFront-Verteilung an.

Ursprungsanforderungsrichtlinien sind nicht erforderlich. Wenn einem Cacheverhalten keine Ursprungsanforderungsrichtlinie angefügt ist, enthält die Ursprungsanforderung alle Werte, die in der Cache-Richtlinie angegeben sind, jedoch keine weiteren Werte.

Anmerkung

Um eine Ursprungsanforderungsrichtlinie verwenden zu können, muss das Cacheverhalten auch eine Cache-Richtlinie verwenden. Sie können eine Ursprungsanforderungsrichtlinie in einem Cacheverhalten nicht ohne eine Cache-Richtlinie verwenden.

Console
So erstellen Sie eine Ursprungsanforderungsrichtlinie (Konsole)

  1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Seite Richtlinien in der CloudFront-Konsole unter https://console.aws.amazon.com/cloudfront/v4/home?#/policies.

  2. Wählen Sie Ursprungsanforderung und anschließend Ursprungsanforderungsrichtlinie erstellen aus.

  3. Wählen Sie die gewünschte Einstellung für diese Ursprungsanforderungsrichtlinie aus. Weitere Informationen finden Sie unter Grundlegendes zu Ursprungsanforderungsrichtlinien.

  4. Wenn Sie fertig sind, wählen Sie Erstellen.

Nach der Erstellung einer Ursprungsanforderungsrichtlinie können Sie diese einem Cacheverhalten anfügen.

So fügen Sie eine Ursprungsanforderungsrichtlinie an eine vorhandene Verteilung an (Konsole)

  1. Öffnen Sie die Seite Verteilungen in der CloudFront-Konsole unter https://console.aws.amazon.com/cloudfront/v4/home#/distributions.

  2. Wählen Sie die Verteilung aus, die Sie aktualisieren möchten, und anschließend die Registerkarte Verhaltensweisen aus.

  3. Wählen Sie das Cacheverhalten, das Sie aktualisieren möchten, und anschließend Bearbeiten aus.

    Um ein neues Cacheverhalten zu erstellen, wählen Sie Verhalten erstellen aus.

  4. Stellen Sie im Abschnitt Cache-Schlüssel- und Ursprungsanforderungen sicher, dass Cache-Richtlinie und Ursprungsanforderungsrichtlinie ausgewählt sind.

  5. Wählen Sie unter Ursprungsanforderungsrichtlinie die Ursprungsanforderungsrichtlinie aus, die diesem Cacheverhalten angefügt werden soll.

  6. Wählen Sie unten auf der Seite die Option Änderungen speichern aus.

So fügen Sie eine Ursprungsanforderungsrichtlinie an eine neue Verteilung an (Konsole)

  1. Öffnen Sie die CloudFront-Konsole unter https://console.aws.amazon.com/cloudfront/v4/home.

  2. Wählen Sie Verteilung erstellen.

  3. Stellen Sie im Abschnitt Cache-Schlüssel- und Ursprungsanforderungen sicher, dass Cache-Richtlinie und Ursprungsanforderungsrichtlinie ausgewählt sind.

  4. Wählen Sie für Origin request policy (Ursprungsanforderungsrichtlinie) die Ursprungsanforderungsrichtlinie aus, die dem Standard-Cacheverhalten dieser Verteilung angefügt werden soll.

  5. Wählen Sie die gewünschten Einstellungen für den Ursprung, das Standard-Cacheverhalten und andere Verteilungseinstellungen aus. Weitere Informationen finden Sie unter Referenz für alle Distributionseinstellungen.

  6. Wenn Sie fertig sind, wählen Sie Verteilung erstellen aus.

CLI

Verwenden Sie den aws cloudfront create-origin-request-policy-Befehl, um eine Ursprungsanforderungsrichtlinie mit der AWS Command Line Interface (AWS CLI) zu erstellen. Sie können die Eingabeparameter des Befehls in einer Eingabedatei bereitstellen, anstatt jeden einzelnen Parameter als Befehlszeileneingabe anzugeben.

So erstellen Sie eine Ursprungsanforderungsrichtlinie (CLI mit Eingabedatei)

  1. Verwenden Sie den folgenden Befehl, um eine Datei mit dem Namen origin-request-policy.yaml zu erstellen, die alle Eingabeparameter für den create-origin-request-policy-Befehl enthält.

    
aws cloudfront create-origin-request-policy --generate-cli-skeleton yaml-input > origin-request-policy.yaml

  2. Öffnen Sie die Datei mit dem Namen origin-request-policy.yaml, die Sie gerade erstellt haben. Bearbeiten Sie die Datei, um die gewünschten Einstellungen für die Ursprungsanforderungsrichtlinie anzugeben, und speichern Sie die Datei. Sie können optionale Felder aus der Datei entfernen, erforderliche Felder dürfen jedoch nicht entfernt werden.

    Weitere Informationen zu den Einstellungen für die Ursprungsanforderungsrichtlinie finden Sie unter Grundlegendes zu Ursprungsanforderungsrichtlinien.

  3. Verwenden Sie den folgenden Befehl, um die Ursprungsanforderungsrichtlinie mit Eingabeparametern aus der Datei origin-request-policy.yaml zu erstellen.

    
aws cloudfront create-origin-request-policy --cli-input-yaml file://origin-request-policy.yaml

    Notieren Sie den Id-Wert in der Ausgabe des Befehls. Dies ist die Ursprungsanforderungsrichtlinien-ID, die Sie benötigen, um die Ursprungsanforderungsrichtlinie an das Cache-Verhalten einer CloudFront-Verteilung anzufügen.

So fügen Sie eine Ursprungsanforderungsrichtlinie an eine vorhandene Verteilung an (CLI mit Eingabedatei)

  1. Verwenden Sie den folgenden Befehl, um die Verteilungskonfiguration für die zu aktualisierende CloudFront-Verteilung zu speichern. Ersetzen Sie distribution_ID durch die ID der Verteilung.

    
aws cloudfront get-distribution-config --id distribution_ID --output yaml > dist-config.yaml

  2. Öffnen Sie die Datei mit dem Namen dist-config.yaml, die Sie gerade erstellt haben. Bearbeiten Sie die Datei und nehmen Sie die folgenden Änderungen an jedem Cacheverhalten vor, das Sie aktualisieren, um eine Ursprungsanforderungsrichtlinie zu verwenden.

    • Fügen Sie in der Cache-Verhaltensweise ein Feld mit dem Namen OriginRequestPolicyId hinzu. Verwenden Sie als Wert des Feldes die Ursprungsanforderungsrichtlinien-ID, die Sie nach dem Erstellen der Richtlinie notiert haben.

    • Benennen Sie das Feld ETag in IfMatch um, ändern Sie jedoch nicht den Wert des Feldes.

    Speichern Sie die Datei, wenn Sie fertig sind.

  3. Verwenden Sie den folgenden Befehl, um die Verteilung zur Verwendung der Ursprungsanforderungsrichtlinie zu aktualisieren. Ersetzen Sie distribution_ID durch die ID der Verteilung.

    
aws cloudfront update-distribution --id distribution_ID --cli-input-yaml file://dist-config.yaml
So fügen Sie eine Ursprungsanforderungsrichtlinie an eine neu Verteilung an (CLI mit Eingabedatei)

  1. Verwenden Sie den folgenden Befehl, um eine Datei mit dem Namen distribution.yaml zu erstellen, die alle Eingabeparameter für den create-distribution-Befehl enthält.

    
aws cloudfront create-distribution --generate-cli-skeleton yaml-input > distribution.yaml

  2. Öffnen Sie die Datei mit dem Namen distribution.yaml, die Sie gerade erstellt haben. Geben Sie im Standard-Cacheverhalten in das Feld OriginRequestPolicyId die Ursprungsanforderungsrichtlinien-ID ein, die Sie nach dem Erstellen der Richtlinie notiert haben. Fahren Sie mit der Bearbeitung der Datei fort, um die gewünschten Verteilungseinstellungen anzugeben, und speichern Sie die Datei, wenn Sie fertig sind.

    Weitere Informationen zu den Verteilungseinstellungen finden Sie unter Referenz für alle Distributionseinstellungen.

  3. Verwenden Sie den folgenden Befehl, um die Verteilung mit Eingabeparametern aus der Datei distribution.yaml zu erstellen.

    
aws cloudfront create-distribution --cli-input-yaml file://distribution.yaml
API

Um eine Ursprungsanforderungsrichtlinie mit der CloudFront-API zu erstellen, verwenden Sie CreateOriginRequestPolicy. Weitere Informationen zu den Feldern, die Sie in diesem API-Aufruf angeben, finden Sie unter Grundlegendes zu Ursprungsanforderungsrichtlinien und in der API-Referenzdokumentation für Ihr AWS-SDK oder einen anderen API-Client.

Nach der Erstellung einer Ursprungsanforderungsrichtlinie können Sie diese mit einem der folgenden API-Aufrufe an ein Cacheverhalten anfügen:

  • Verwenden Sie UpdateDistribution, um sie an eine Cache-Verhaltensweise in einer vorhandenen Verteilung anzufügen.

  • Um sie an ein Cache-Verhaltensweise in einer neuen Verteilung anzufügen, verwenden Sie CreateDistribution.

Geben Sie für beide API-Aufrufe die ID der Ursprungsanforderungsrichtlinie im Feld OriginRequestPolicyId innerhalb eines Cache-Verhaltens an. Weitere Informationen zu den anderen Feldern, die Sie in diesen API-Aufrufen angeben, finden Sie unter Referenz für alle Distributionseinstellungen und in der API-Referenzdokumentation für Ihr AWS SDK oder einen anderen API-Client.