Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Modifier une règle d'écoute pour votre Application Load Balancer
Vous pouvez modifier l'action et les conditions d'une règle d'écoute à tout moment. Les mises à jour de règle ne prennent pas effet immédiatement. Les demandes peuvent donc être acheminées à l'aide de la configuration de règle précédente pendant une courte période après la mise à jour d'une règle. Toutes les demandes en cours sont traitées.
**Topics**
+ [Modifier l'action par défaut](#modify-default-action)
+ [Mettre à jour les priorités des règles](#update-rule-priority)
+ [Mettre à jour les actions, les conditions et les transformations](#update-rule-actions-conditions-transforms)
+ [Gérer les balises de règles](#manage-rule-tags)
## Modifier l'action par défaut
L'action par défaut est affectée à une règle nommée **Default**. Vous pouvez conserver le type de règle actuel et modifier les informations requises, ou vous pouvez modifier le type de règle et fournir les nouvelles informations requises.
------
#### [ Console ]
**Pour modifier l'action par défaut**
1. Ouvrez la console Amazon EC2 à l’adresse [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Dans le volet de navigation, choisissez **Load Balancers (Équilibreurs de charge)**.
1. Sélectionnez l'équilibreur de charge.
1. Dans l'onglet **Écouteurs et règles**, sélectionnez le texte dans la colonne **Protocol:Port** pour ouvrir la page détaillée de l'écouteur.
1. Dans l'onglet **Règles**, dans la section **Règles du récepteur**, sélectionnez la règle par défaut. Choisissez **Actions**, puis **Modifier la règle**.
1. Sous **Action par défaut**, mettez à jour les actions selon vos besoins.
------
#### [ AWS CLI ]
**Pour modifier l'action par défaut**
Utilisez la commande [modify-listener](https://docs.aws.amazon.com/cli/latest/reference/elbv2/modify-listener.html). L'exemple suivant met à jour le groupe cible de l'`forward`action.
```
aws elbv2 modify-listener \
--listener-arn listener-arn \
--default-actions Type=forward,TargetGroupArn=new-target-group-arn
```
L'exemple suivant met à jour l'action par défaut pour répartir le trafic de manière égale entre deux groupes cibles.
```
aws elbv2 modify-listener \
--listener-arn listener-arn \
--default-actions '[{
"Type":"forward",
"ForwardConfig":{
"TargetGroups":[
{"TargetGroupArn":"target-group-1-arn","Weight":50},
{"TargetGroupArn":"target-group-2-arn","Weight":50}
]
}
}]'
```
------
#### [ CloudFormation ]
**Pour modifier l'action par défaut**
Mettez à jour la [AWS::ElasticLoadBalancingV2::Listener](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-elasticloadbalancingv2-listener.html)ressource.
```
Resources:
myHTTPlistener:
Type: 'AWS::ElasticLoadBalancingV2::Listener'
Properties:
LoadBalancerArn: !Ref myLoadBalancer
Protocol: HTTP
Port: 80
DefaultActions:
- Type: "forward"
TargetGroupArn: !Ref myNewTargetGroup
```
------
## Mettre à jour les priorités des règles
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 personnalisée à tout moment. Vous ne pouvez pas modifier la priorité de la règle par défaut.
------
#### [ Console ]
**Pour mettre à jour les priorités des règles**
1. Ouvrez la console Amazon EC2 à l’adresse [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Dans le volet de navigation, choisissez **Load Balancers**.
1. Sélectionnez l'équilibreur de charge.
1. Dans l'onglet **Écouteurs et règles**, sélectionnez le texte dans la colonne **Protocol:Port** pour ouvrir la page détaillée de l'écouteur.
1. Dans l'onglet **Règles**, sélectionnez la règle du récepteur, puis choisissez **Actions**, **Rehiérarchiser** les règles.
1. Dans la section **Règles du récepteur**, la colonne **Priorité** affiche les priorités des règles actuelles. Pour mettre à jour la priorité d'une règle, entrez une valeur comprise entre 1 et 50 000.
1. Sélectionnez **Enregistrer les modifications**.
------
#### [ AWS CLI ]
**Pour mettre à jour les priorités des règles**
Utilisez la commande [set-rule-priorities](https://docs.aws.amazon.com/cli/latest/reference/elbv2/set-rule-priorities.html).
```
aws elbv2 set-rule-priorities \
--rule-priorities "RuleArn=listener-rule-arn,Priority=5"
```
------
#### [ CloudFormation ]
**Pour mettre à jour les priorités des règles**
Mettez à jour la [AWS::ElasticLoadBalancingV2::ListenerRule](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-elasticloadbalancingv2-listenerrule.html)ressource.
```
Resources:
myListenerRule:
Type: 'AWS::ElasticLoadBalancingV2::ListenerRule'
Properties:
ListenerArn: !Ref myListener
Priority: 5
Conditions:
- Field: host-header
Values:
- example.com
- www.example.com
Actions:
- Type: forward
TargetGroupArn: !Ref myTargetGroup
```
------
## Mettre à jour les actions, les conditions et les transformations
Vous pouvez mettre à jour les actions, les conditions et les transformations d'une règle.
------
#### [ Console ]
**Pour mettre à jour les actions, les conditions et les transformations des règles**
1. Ouvrez la console Amazon EC2 à l’adresse [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Dans le volet de navigation, choisissez **Load Balancers**.
1. Sélectionnez l'équilibreur de charge.
1. Dans l'onglet **Écouteurs et règles**, sélectionnez le texte dans la colonne **Protocol:Port** pour ouvrir la page détaillée de l'écouteur.
1. Dans l'onglet **Règles**, sélectionnez la règle du récepteur, puis choisissez **Actions**, **Modifier la règle**.
1. Mettez à jour les actions, les conditions et les transformations selon les besoins. Pour obtenir des instructions complètes, consultez [Ajout d'une règle](add-rule.md).
1. Choisissez **Suivant**.
1. (Facultatif) Mettez à jour la priorité.
1. Choisissez **Suivant**.
1. Sélectionnez **Enregistrer les modifications**.
------
#### [ AWS CLI ]
**Pour mettre à jour les actions, les conditions et les transformations des règles**
Utilisez la commande [modify-rule](https://docs.aws.amazon.com/cli/latest/reference/elbv2/modify-rule.html). Incluez au moins l'une des options suivantes : `--actions``--conditions`, et`--transforms`.
Pour des exemples de ces options, voir[Ajout d'une règle](add-rule.md).
------
#### [ CloudFormation ]
**Pour mettre à jour les actions, les conditions et les transformations des règles**
Mettez à jour la [AWS::ElasticLoadBalancingV2::ListenerRule](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-elasticloadbalancingv2-listenerrule.html)ressource.
Pour obtenir des exemples de règles, consultez la section [Ajout d'une règle](add-rule.md).
------
## Gérer les balises de règles
Les balises vous aident à catégoriser vos écouteurs et règles de différentes manières. Par exemple, vous pouvez baliser une ressource par objectif, propriétaire ou environnement. Les clés de balise doivent être uniques pour chaque règle. Si vous ajoutez une balise avec une clé qui est déjà associée à la règle, cela met à jour la valeur de cette balise.
Lorsque vous avez terminé avec une balise, vous pouvez la supprimer.
------
#### [ Console ]
**Pour gérer les balises d'une règle**
1. Ouvrez la console Amazon EC2 à l’adresse [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Dans le volet de navigation, choisissez **Load Balancers**.
1. Choisissez le nom de l'équilibreur de charge pour ouvrir sa page de détails.
1. Dans l'onglet **Écouteurs et règles**, sélectionnez le texte dans la colonne **Protocol:Port** pour ouvrir la page détaillée de l'écouteur.
1. Dans l'onglet **Règles**, sélectionnez le texte dans la colonne **Name tag** pour ouvrir la page détaillée de la règle.
1. Sur la page des détails de la règle, sélectionnez **Gérer les balises**.
1. Sur la page **Gérer les balises**, effectuez une ou plusieurs des opérations suivantes :
1. Pour ajouter une balise, sélectionnez **Ajouter une nouvelle balise** et saisissez des valeurs pour **Clé** et **Valeur**.
1. Pour supprimer une balise, choisissez **Retirer** en regard de la balise.
1. Pour mettre à jour une balise, entrez de nouvelles valeurs pour **Clé** ou **Valeur**.
1. Sélectionnez **Enregistrer les modifications**.
------
#### [ AWS CLI ]
**Pour ajouter des balises à une règle**
Utilisez la commande [add tags](https://docs.aws.amazon.com/cli/latest/reference/elbv2/add-tags.html).
```
aws elbv2 add-tags \
--resource-arns listener-rule-arn \
--tags "Key=project,Value=lima" "Key=department,Value=digital-media"
```
**Pour supprimer des balises d'une règle**
Utilisez la commande [remove-tags](https://docs.aws.amazon.com/cli/latest/reference/elbv2/remove-tags.html).
```
aws elbv2 remove-tags \
--resource-arns listener-rule-arn \
--tag-keys project department
```
------
#### [ CloudFormation ]
**Pour ajouter des balises à une règle**
Mettez à jour la [AWS::ElasticLoadBalancingV2::ListenerRule](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-elasticloadbalancingv2-listenerrule.html)ressource.
```
Resources:
myListenerRule:
Type: 'AWS::ElasticLoadBalancingV2::ListenerRule'
Properties:
ListenerArn: !Ref myListener
Priority: 10
Conditions:
- Field: host-header
Values:
- example.com
- www.example.com
Actions:
- Type: forward
TargetGroupArn: !Ref myTargetGroup
Tags:
- Key: 'project'
Value: 'lima'
- Key: 'department'
Value: 'digital-media'
```
------