

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Editar uma regra de receptor para seu Application Load Balancer
<a name="edit-rule"></a>

Você pode editar a ação e as condições para uma regra do receptor a qualquer momento. As atualizações de regras não entram em vigor imediatamente, portanto, as solicitações podem ser roteadas usando a configuração de regra anterior por um curto período após a atualização de uma regra. Todas as solicitações em trânsito são concluídas.

**Topics**
+ [Modificar a ação padrão](#modify-default-action)
+ [Atualizar prioridades da regra](#update-rule-priority)
+ [Atualize ações, condições e transformações](#update-rule-actions-conditions-transforms)
+ [Gerenciar as tags de regras](#manage-rule-tags)

## Modificar a ação padrão
<a name="modify-default-action"></a>

A ação padrão é atribuída a uma regra chamada **Padrão**. Você pode manter o tipo de regra atual e alterar as informações necessárias ou pode modificar o tipo de regra e inserir as novas informações obrigatórias.

------
#### [ Console ]

**Para modificar a ação padrão**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. No painel de navegação, selecione **Balanceador de carga**.

1. Selecione o load balancer.

1. Na guia **Receptores e regras**, selecione o texto na coluna **Protocolo:Porta** para abrir a página de detalhes do receptor.

1. Na guia **Regras**, na seção **Regras do receptor**, selecione a regra padrão. Selecione **Ações**, **Editar regra**.

1. Em **Ação padrão**, atualize as ações conforme necessário.

------
#### [ AWS CLI ]

**Para modificar a ação padrão**  
Use o comando [modify-listener](https://docs.aws.amazon.com/cli/latest/reference/elbv2/modify-listener.html). O exemplo mostrado a seguir atualiza o grupo de destino da ação `forward`.

```
aws elbv2 modify-listener \
    --listener-arn listener-arn \
    --default-actions Type=forward,TargetGroupArn=new-target-group-arn
```

O exemplo mostrado a seguir atualiza a ação padrão para distribuir o tráfego igualmente entre dois grupos de destino.

```
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 ]

**Para modificar a ação padrão**  
Atualize o [AWS::ElasticLoadBalancingV2::Listener](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-elasticloadbalancingv2-listener.html)recurso.

```
Resources:
    myHTTPlistener:
      Type: 'AWS::ElasticLoadBalancingV2::Listener'
      Properties:
        LoadBalancerArn: !Ref myLoadBalancer
        Protocol: HTTP
        Port: 80
        DefaultActions:
          - Type: "forward"
            TargetGroupArn: !Ref myNewTargetGroup
```

------

## Atualizar prioridades da regra
<a name="update-rule-priority"></a>

As regras são avaliadas em ordem de prioridade, do valor mais baixo para o valor mais alto. A regra padrão é avaliada por último. Você pode alterar a prioridade de uma regra não padrão a qualquer momento. Você não pode alterar a prioridade da regra padrão.

------
#### [ Console ]

**Para atualizar as prioridades da regra**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. No painel de navegação, selecione **Load Balancers**.

1. Selecione o load balancer.

1. Na guia **Receptores e regras**, selecione o texto na coluna **Protocolo:Porta** para abrir a página de detalhes do receptor.

1. Na guia **Regras**, selecione a regra do receptor e escolha **Ações**, **Repriorizar regras**.

1. Na seção **Regras do receptor**, a coluna **Prioridade** exibe a prioridade da regra atual. Para atualizar uma prioridade de regra, insira um valor de 1 a 50.000.

1. Escolha **Salvar alterações**.

------
#### [ AWS CLI ]

**Para atualizar as prioridades da regra**  
Use o comando [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 ]

**Para atualizar as prioridades da regra**  
Atualize o [AWS::ElasticLoadBalancingV2::ListenerRule](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-elasticloadbalancingv2-listenerrule.html)recurso.

```
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
```

------

## Atualize ações, condições e transformações
<a name="update-rule-actions-conditions-transforms"></a>

Você pode atualizar as ações, condições e transformações de uma regra.

------
#### [ Console ]

**Para atualizar ações, condições e transformações da regra**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. No painel de navegação, selecione **Load Balancers**.

1. Selecione o load balancer.

1. Na guia **Receptores e regras**, selecione o texto na coluna **Protocolo:Porta** para abrir a página de detalhes do receptor.

1. Na guia **Regras**, selecione a regra do receptor e escolha **Ações**, **Editar regra**.

1. Atualizar ações, condições e transformações conforme necessário. Para obter detalhes das etapas, consulte, [Adicionar uma regra](add-rule.md).

1. Escolha **Próximo**.

1. (Opcional) Atualize a prioridade.

1. Escolha **Próximo**.

1. Escolha **Salvar alterações**.

------
#### [ AWS CLI ]

**Para atualizar ações, condições e transformações da regra**  
Use o comando [modify-rule](https://docs.aws.amazon.com/cli/latest/reference/elbv2/modify-rule.html). Inclua pelo menos uma das seguintes opções: `--actions`, `--conditions` e `--transforms`.

Para obter exemplos dessas opções, consulte [Adicionar uma regra](add-rule.md).

------
#### [ CloudFormation ]

**Para atualizar ações, condições e transformações da regra**  
Atualize o [AWS::ElasticLoadBalancingV2::ListenerRule](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-elasticloadbalancingv2-listenerrule.html)recurso.

Para exemplos de regras, consulte [Adicionar uma regra](add-rule.md).

------

## Gerenciar as tags de regras
<a name="manage-rule-tags"></a>

As tags ajudam você a categorizar seus receptores e regras de maneiras diferentes. Por exemplo, você pode marcar um recurso por finalidade, proprietário ou ambiente. As chaves de tag precisam ser únicas para cada regra. Se você adicionar uma tag a uma chave que já está associada a uma regra, o valor da tag será atualizado.

Quando não precisar mais de uma tag, você poderá removê-la.

------
#### [ Console ]

**Para gerenciar as tags de uma regra**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. No painel de navegação, selecione **Load Balancers**.

1. Escolha o nome do balanceador de carga para abrir a página de detalhes.

1. Na guia **Receptores e regras**, selecione o texto na coluna **Protocolo:Porta** para abrir a página de detalhes do receptor.

1. Na guia **Regras**, selecione o texto na coluna **Tag de nome** para abrir a página de detalhes da regra.

1. Na página de detalhes, escolha **Gerenciar tags**.

1. Na página **Gerenciar tags**, é possível realizar uma ou mais das seguintes ações:

   1. Para adicionar uma nova tag, escolha **Adicionar nova tag** e insira valores para **Chave** e **Valor**.

   1. Para excluir uma tag, escolha **Remover** ao lado da tag.

   1. Para atualizar uma tag, insira novos valores para **Chave** ou **Valor**.

1. Escolha **Salvar alterações**.

------
#### [ AWS CLI ]

**Para adicionar tags a uma regra**  
Use o comando [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"
```

**Para remover tags de uma regra**  
Use o comando [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 ]

**Para adicionar tags a uma regra**  
Atualize o [AWS::ElasticLoadBalancingV2::ListenerRule](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-elasticloadbalancingv2-listenerrule.html)recurso.

```
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'
```

------