Règles d'écoute pour votre service VPC Lattice

Chaque écouteur possède une règle par défaut et des règles supplémentaires que vous pouvez définir. Chaque règle comprend une priorité, une ou plusieurs actions et une ou plusieurs conditions. Vous pouvez ajouter ou modifier des règles à tout moment.

Règles par défaut

Lorsque vous créez un écouteur, vous définissez des actions pour la règle par défaut. Les règles par défaut ne peuvent pas avoir de conditions. Si aucune condition des règles d'un écouteur n'est satisfaite, l'action spécifiée pour la règle par défaut est effectuée.

Priorité de la règle

Chaque règle a une priorité. Les règles sont évaluées par ordre de priorité, de la valeur la plus basse à la valeur la plus haute. La règle par défaut est évaluée en dernier. Vous pouvez modifier la priorité d'une règle autre que celle par défaut à tout moment. Vous ne pouvez pas modifier la priorité de la règle par défaut.

Action de la règle

Les écouteurs des services VPC Lattice prennent en charge les actions avancées et les actions à réponse fixe.

Actions de réacheminement

Vous pouvez utiliser forward des actions pour acheminer les demandes vers un ou plusieurs groupes cibles VPC Lattice. Si vous spécifiez plusieurs groupes cibles pour une action forward, vous devez spécifier une pondération pour chaque groupe cible. Le poids de chaque groupe cible est une valeur comprise entre 0 et 999. Les demandes qui correspondent à une règle d’écouteur avec des groupes cibles pondérés sont distribuées à ces groupes cibles en fonction de leur pondération. Par exemple, si vous spécifiez deux groupes cibles, chacun ayant une pondération de 10, chaque groupe cible reçoit la moitié des demandes. Si vous spécifiez deux groupes cibles, l'un avec une pondération de 10 et l'autre avec une pondération de 20, le groupe cible avec une pondération de 20 reçoit deux fois plus de demandes que l'autre groupe cible.

Actions de réponse fixe

Vous pouvez utiliser des actions fixed-response pour supprimer des demandes clients et renvoyer une réponse HTTP personnalisée. Vous pouvez utiliser cette action pour renvoyer un code de réponse 404.

Exemple d'action de réponse fixe pour le AWS CLI

Vous pouvez spécifier une action lorsque vous créez ou mettez à jour une règle. L'action suivante envoie une réponse fixe avec le code d'état spécifié.

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

Conditions de règle

Chaque condition de règle comporte un type et des informations de configuration. Lorsque les conditions d'une règle sont satisfaites, ses actions sont effectuées.

Les critères de correspondance pris en charge pour une règle sont les suivants :

Correspondance d'en-tête

Le routage est basé sur les en-têtes HTTP de chaque demande. Vous pouvez utiliser des conditions de l’en-tête HTTP pour configurer des règles qui acheminent des demandes, en fonction des en-têtes HTTP de la demande. Vous pouvez spécifier les noms des champs d'en-tête HTTP standard ou personnalisés. Le nom de l'en-tête et l'évaluation de la correspondance ne distinguent pas les majuscules et minuscules. Vous pouvez modifier ce paramètre en activant la distinction majuscules/majuscules. Les caractères génériques ne sont pas pris en charge par le nom de l’en-tête. Les correspondances entre les préfixes, exacts et contenus sont prises en charge lors de la correspondance des en-têtes.

Correspondance des méthodes

Le routage est basé sur la méthode de requête HTTP de chaque demande.

Vous pouvez utiliser des conditions de méthode de demande HTTP pour configurer des règles qui acheminent des demandes, en fonction de la méthode de demande HTTP de la demande. Vous pouvez spécifier des méthodes HTTP standard ou personnalisées. La correspondance des méthodes fait la distinction majuscules/minuscules. Le nom de la méthode doit correspondre exactement. Les caractères génériques ne sont pas pris en charge.

Correspondance de trajectoire

Le routage est basé sur la correspondance des modèles de chemin dans les URL de demande.

Vous pouvez utiliser les conditions de chemin pour définir des règles qui acheminent les demandes en fonction de l'URL contenue dans la demande. Les caractères génériques ne sont pas pris en charge. Le préfixe et la correspondance exacte sur le chemin sont pris en charge.

Ajout d'une règle

Vous pouvez ajouter une règle d'écoute à tout moment.

Pour ajouter une règle d'écoute à l'aide de la console

1. Ouvrez la console Amazon VPC à l’adresse https://console.aws.amazon.com/vpc/.

2. Dans le volet de navigation, sous VPC Lattice, sélectionnez Services.

3. Sélectionnez le nom du service pour ouvrir sa page de détails.

4. Dans l'onglet Routage, choisissez Modifier l'écouteur.

5. Développez les règles du récepteur et choisissez Ajouter une règle.

6. Dans Nom de la règle, entrez le nom de la règle.

7. Pour Priorité, entrez une priorité comprise entre 1 et 100. Les règles sont évaluées par ordre de priorité, de la valeur la plus basse à la valeur la plus haute. La règle par défaut est évaluée en dernier.

8. Pour Condition, entrez un modèle de chemin pour la condition de correspondance du chemin. La taille maximale de chaque chaîne est de 200 caractères. La comparaison ne fait pas la distinction majuscules/minuscules. Les caractères génériques ne sont pas pris en charge.

   Pour ajouter une condition de correspondance d'en-tête ou de règle de correspondance de méthode, utilisez le AWS CLI ou un AWS SDK.

9. Pour Action, choisissez un groupe cible VPC Lattice.

10. Sélectionnez Enregistrer les modifications.

Pour ajouter une règle à l'aide du AWS CLI

Utilisez la commande create-rule.

Mettre à jour une règle

Vous pouvez mettre à jour une règle d'écoute à tout moment. Vous pouvez modifier sa priorité, sa condition, son groupe cible et le poids de chaque groupe cible. Vous ne pouvez pas modifier le nom de la règle.

Pour mettre à jour une règle d'écoute à l'aide de la console

1. Ouvrez la console Amazon VPC à l’adresse https://console.aws.amazon.com/vpc/.

2. Dans le volet de navigation, sous VPC Lattice, sélectionnez Services.

3. Sélectionnez le nom du service pour ouvrir sa page de détails.

4. Dans l'onglet Routage, choisissez Modifier l'écouteur.

5. Modifiez les priorités, les conditions et les actions des règles selon vos besoins.

6. Passez en revue vos mises à jour et choisissez Enregistrer les modifications.

Pour mettre à jour une règle à l'aide du AWS CLI

Utilisez la commande update-rule.

Suppression d'une règle

Vous pouvez supprimer les règles autres que celles par défaut pour un écouteur à tout moment. Vous ne pouvez pas supprimer la règle par défaut pour un écouteur. Lorsque vous supprimez un écouteur, toutes ses règles sont supprimées.

Pour supprimer une règle d'écoute à l'aide de la console

1. Ouvrez la console Amazon VPC à l’adresse https://console.aws.amazon.com/vpc/.

2. Dans le volet de navigation, sous VPC Lattice, sélectionnez Services.

3. Sélectionnez le nom du service pour ouvrir sa page de détails.

4. Dans l'onglet Routage, choisissez Modifier l'écouteur.

5. Trouvez la règle et choisissez Supprimer.

6. Sélectionnez Enregistrer les modifications.

Pour supprimer une règle à l'aide du AWS CLI

Utilisez la commande delete-rule.