Listener-Regeln für Ihren VPC Lattice-Service

Jeder Listener hat eine Standardregel und zusätzliche Regeln, die Sie definieren können. Jede Rolle besteht aus einer Priorität, mindestens einer Aktion und mindestens einer Bedingung. Sie können jederzeit Regel hinzufügen oder bearbeiten.

Standardregeln

Beim Erstellen eines Listeners definieren Sie Aktionen für die Standardregel. Standardregeln können keine Bedingungen aufweisen. Wenn für die Regeln eines Listeners keine Bedingungen erfüllt werden, wird die Aktion für die Standardregel durchgeführt.

Priorität der Regel

Jede Regel hat eine Priorität. Regeln werden in der Reihenfolge ihrer Prioritäten bewertet, ausgehend vom niedrigsten Wert hin zum höchsten Wert. Die Standardregel wird zuletzt ausgewertet. Sie können die Priorität einer nicht standardmäßigen Regel jederzeit ändern. Sie können die Priorität der Standardregel nicht ändern.

Regelaktion

Listener für VPC Lattice-Dienste unterstützen Forward-Aktionen und Fixed-Response-Aktionen.

Weiterleitungsaktionen

Sie können forward Aktionen verwenden, um Anfragen an eine oder mehrere VPC Lattice-Zielgruppen weiterzuleiten. Wenn Sie mehrere Zielgruppen für eine forward-Aktion angeben, müssen Sie für jede Zielgruppe eine Gewichtung angeben. Jede Zielgruppengewichtung ist ein Wert zwischen 0 und 999. Anforderungen, die einer Listener-Regel mit gewichteten Zielgruppen entsprechen, werden basierend auf ihren Gewichtungen an diese Zielgruppen verteilt. Wenn Sie beispielsweise zwei Zielgruppen mit einer Gewichtung von 10 angeben, erhält jede Zielgruppe die Hälfte der Anforderungen. Wenn Sie zwei Zielgruppen angeben, eine mit einer Gewichtung von 10 und die andere mit einer Gewichtung von 20, erhält die Zielgruppe mit der Gewichtung von 20 doppelt so viele Anforderungen wie die andere Zielgruppe.

Aktionen mit feststehender Antwort

Verwenden Sie fixed-response-Aktionen, um Client-Anforderungen zu verwerfen und eine benutzerdefinierte HTTP-Antwort zurückzugeben. Sie können diese Aktion verwenden, um einen 404-Antwortcode zurückzugeben.

Beispiel für eine feste Antwortaktion für AWS CLI

Sie können eine Aktion angeben, wenn Sie eine Regel erstellen oder aktualisieren. Die folgende Aktion sendet eine feste Antwort mit dem angegebenen Statuscode.

"action": { 
    "fixedResponse": { 
        "statusCode": 404
},

Regelbedingungen

Jede Regelbedingung weist einen Typ und Bedingungsinformationen auf. Wenn die Bedingungen für eine Regel erfüllt sind, wird die dazugehörige Aktion durchgeführt.

Im Folgenden sind die unterstützten Übereinstimmungskriterien für eine Regel aufgeführt:

Header-Übereinstimmung

Das Routing basiert auf den HTTP-Headern für jede Anfrage. Mit HTTP-Header-Bedingungen können Sie Regeln konfigurieren, mit denen Anforderungen auf Grundlage der HTTP-Header für die Anforderung weitergeleitet werden. Sie können die Namen der standardmäßigen oder benutzerdefinierten HTTP-Header-Felder angeben. Beim Headernamen und der Übereinstimmungsauswertung wird nicht zwischen Groß- und Kleinschreibung unterschieden. Sie können diese Einstellung ändern, indem Sie die Berücksichtigung von Groß- und Kleinschreibung aktivieren. Platzhalterzeichen werden im Header-Namen nicht unterstützt. Die Übereinstimmungen von Präfix, Exakt und Enthält werden beim Header-Abgleich unterstützt.

Methodenübereinstimmung

Das Routing basiert auf der HTTP-Anforderungsmethode jeder Anfrage.

Mit Bedingungen für HTTP-Anforderungsmethoden können Sie Regeln konfigurieren, mit denen Anforderungen auf Grundlage der HTTP-Anforderungsmethode der Anforderung weitergeleitet werden. Sie können standardmäßige oder benutzerdefinierte HTTP-Methoden angeben. Bei der Methode match wird zwischen Groß- und Kleinschreibung unterschieden. Der Methodenname muss exakt übereinstimmen. Platzhalterzeichen werden nicht unterstützt.

Pfadübereinstimmung

Das Routing basiert auf dem Abgleich der Pfadmuster in den Anforderungs-URLs.

Sie können Pfadbedingungen verwenden, um Regeln zu definieren, die Anfragen auf der Grundlage der URL in der Anfrage weiterleiten. Platzhalterzeichen werden nicht unterstützt. Präfix und exakte Übereinstimmung im Pfad werden unterstützt.

Hinzufügen einer Regel

Sie können jederzeit eine Listener-Regel hinzufügen.

Um eine Listener-Regel mithilfe der Konsole hinzuzufügen

1. Öffnen Sie die Amazon VPC-Konsole unter https://console.aws.amazon.com/vpc/.

2. Wählen Sie im Navigationsbereich unter VPC Lattice die Option Services aus.

3. Wählen Sie den Namen des Dienstes aus, um seine Detailseite zu öffnen.

4. Wählen Sie auf der Registerkarte Routing die Option Listener bearbeiten aus.

5. Erweitern Sie Listener-Regeln und wählen Sie Regel hinzufügen aus.

6. Geben Sie für Rule name (Regelname) einen Namen für die Regel ein.

7. Geben Sie für Priorität eine Priorität zwischen 1 und 100 ein. Regeln werden in der Reihenfolge ihrer Prioritäten bewertet, ausgehend vom niedrigsten Wert hin zum höchsten Wert. Die Standardregel wird zuletzt ausgewertet.

8. Geben Sie unter Bedingung ein Pfadmuster für die Pfadübereinstimmungsbedingung ein. Die maximale Größe jeder Zeichenfolge beträgt 200 Zeichen. Beim Vergleich wird nicht zwischen Groß- und Kleinschreibung unterschieden. Platzhalterzeichen werden nicht unterstützt.

   Verwenden Sie das oder ein AWS SDK, um eine Regelbedingung für den Header AWS CLI - oder Methodenabgleich hinzuzufügen.

9. Wählen Sie für Action eine VPC Lattice-Zielgruppe aus.

10. Wählen Sie Änderungen speichern aus.

Um eine Regel hinzuzufügen, verwenden Sie AWS CLI

Verwenden Sie den Befehl create-rule.

Aktualisieren Sie eine Regel

Sie können eine Listener-Regel jederzeit aktualisieren. Sie können die Priorität, den Zustand, die Zielgruppe und die Gewichtung der einzelnen Zielgruppen ändern. Sie können den Namen der Regel nicht ändern.

Um eine Listener-Regel mithilfe der Konsole zu aktualisieren

1. Öffnen Sie die Amazon VPC-Konsole unter https://console.aws.amazon.com/vpc/.

2. Wählen Sie im Navigationsbereich unter VPC Lattice die Option Services aus.

3. Wählen Sie den Namen des Dienstes aus, um seine Detailseite zu öffnen.

4. Wählen Sie auf der Registerkarte Routing die Option Listener bearbeiten aus.

5. Ändern Sie die Prioritäten, Bedingungen und Aktionen der Regel nach Bedarf.

6. Überprüfen Sie Ihre Aktualisierungen und wählen Sie Änderungen speichern.

Um eine Regel mit dem zu aktualisieren AWS CLI

Verwenden Sie den Befehl update-rule.

Löschen einer Regel

Sie können die nicht standardmäßigen Regeln für einen Listener jederzeit löschen. Sie können die Standardregel für einen Listener nicht löschen. Wenn Sie einen Listener löschen, werden alle seine Regeln gelöscht.

Um eine Listener-Regel mit der Konsole zu löschen

1. Öffnen Sie die Amazon VPC-Konsole unter https://console.aws.amazon.com/vpc/.

2. Wählen Sie im Navigationsbereich unter VPC Lattice die Option Services aus.

3. Wählen Sie den Namen des Dienstes aus, um seine Detailseite zu öffnen.

4. Wählen Sie auf der Registerkarte Routing die Option Listener bearbeiten aus.

5. Suchen Sie die Regel und wählen Sie Entfernen aus.

6. Wählen Sie Änderungen speichern aus.

Um eine Regel mit dem zu löschen AWS CLI

Verwenden Sie den Befehl delete-rule.