

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á.

# Criar um receptor HTTP para seu Application Load Balancer
<a name="create-listener"></a>

Um receptor verifica se há solicitações de conexão. Você define um listener ao criar seu load balancer e você pode adicionar listeners ao seu load balancer a qualquer momento.

As informações dessa página ajudam você a criar um listener HTTP para o load balancer. Para adicionar um listener HTTPS ao seu load balancer, consulte [Criar um receptor HTTPS para seu Application Load Balancer](create-https-listener.md).

## Pré-requisitos
<a name="listener-prereqs"></a>
+ Para adicionar uma ação de encaminhamento à regra do listener padrão, você deve especificar um grupo de destino disponível. Para obter mais informações, consulte [Criar um grupo de destino para o Application Load Balancer](create-target-group.md).
+ Você pode especificar o mesmo grupo de destino em vários receptores, mas esses receptores devem pertencer ao mesmo balanceador de carga. Para usar um grupo de destino com um balanceador de carga, você deve verificar se ele não está sendo usado por um receptor para nenhum outro balanceador de carga.

## Adicionar um receptor HTTP
<a name="add-listener"></a>

Você configura um listener com um protocolo e uma porta para as conexões de clientes com o load balancer, e um grupo de destino para a regra do listener padrão. Para obter mais informações, consulte [Configuração do receptor](load-balancer-listeners.md#listener-configuration).

Para adicionar outra regra de receptor, consulte [Regras do listener](listener-rules.md).

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

**Para adicionar um receptor HTTP**

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**, escolha **Adicionar receptor**.

1. Em **Protocolo**, selecione **HTTP**. Mantenha a porta padrão ou insira uma porta diferente.

1. Em **Ação padrão**, selecione uma das seguintes ações de roteamento e indique as informações necessárias:
   + **Encaminhar para um grupo de destino**: selecione um grupo de destino. Para adicionar outro grupo de destino, escolha **Adicionar grupo de destino**, selecione um grupo de destino, revise os pesos relativos e atualize os pesos conforme necessário. Se tiver habilitado a persistência em qualquer dos grupos de destino, você deverá ativar a persistência no nível de grupo.

     Caso você não tenha um grupo de destino que responda às suas necessidades, escolha **Criar grupo de destino** para criar um agora. Para obter mais informações, consulte [Criar um grupo de destino](create-target-group.md).
   + **Redirecionar para URL**: insira o URL inserindo cada parte separadamente na guia de **Partes do URI** ou inserindo o endereço completo na guia **URL completo**. Em **Código de status**, selecione temporário (HTTP 302) ou permanente (HTTP 301) com base em suas necessidades.
   + **Retornar resposta fixa**: insira o **Código de resposta** para retornar às solicitações descartadas do cliente. Como opção, você também pode especificar o **Tipo de conteúdo** e o **Corpo da resposta**.

1. Para adicionar tags, expanda **Tags de receptor** (Opcional). Escolha **Adicionar nova tag** e insira a chave de tag e um valor para a tag.

1. Escolha **Add listener**.

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

**Para criar um grupo de destino**  
Se você não tiver um grupo-alvo que possa usar para a ação padrão, use o [create-target-group](https://docs.aws.amazon.com/cli/latest/reference/elbv2/create-target-group.html)comando para criar um agora. Para obter exemplos, consulte [Criar um grupo de destino](create-target-group.md).

**Para criar um receptor HTTP**  
Use o comando [create-listener](https://docs.aws.amazon.com/cli/latest/reference/elbv2/create-listener.html). O exemplo a seguir cria um receptor HTTP com uma regra padrão que encaminha o tráfego para o grupo de destino especificado.

```
aws elbv2 create-listener \
    --load-balancer-arn load-balancer-arn \
    --protocol HTTP \
    --port 80 \
    --default-actions Type=forward,TargetGroupArn=target-group-arn
```

Para criar uma ação de encaminhamento que distribua o tráfego entre dois grupos de destino, use a opção `--default-actions` mostrada a seguir. Ao especificar vários grupos de destino, você deve fornecer um peso para cada grupo de destino.

```
    --default-actions '[{
          "Type":"forward",
          "ForwardConfig":{
            "TargetGroups":[
              {"TargetGroupArn":"target-group-1-arn","Weight":50},
              {"TargetGroupArn":"target-group-2-arn","Weight":50}
            ]
          }
        }]'
```

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

**Para criar um receptor HTTP**  
Defina um recurso do tipo [AWS::ElasticLoadBalancingV2::Listener](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-elasticloadbalancingv2-listener.html). O exemplo a seguir cria um receptor HTTP com uma regra padrão que encaminha o tráfego para o grupo de destino especificado.

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

Para criar uma ação de encaminhamento que distribua o tráfego entre múltiplos grupos de destino, use a propriedade `ForwardConfig`. Ao especificar vários grupos de destino, você deve fornecer um peso para cada grupo de destino.

```
Resources:
  myHTTPlistener:
  Type: 'AWS::ElasticLoadBalancingV2::Listener'
  Properties:
    LoadBalancerArn: !Ref myLoadBalancer
    Protocol: HTTP
    Port: 80
    DefaultActions:
      - Type: "forward"
        ForwardConfig:
          TargetGroups:
            - TargetGroupArn: !Ref TargetGroup1
              Weight: 50
            - TargetGroupArn: !Ref TargetGroup2
              Weight: 50
```

------