Regras do receptor para seu Application Load Balancer

As regras que você definir para seu listener determinam como o load balancer roteará solicitações para destinos em um ou mais grupos de destino.

Cada regra consiste em uma prioridade, uma ou mais ações e uma ou mais condições. Para obter mais informações, consulte Regras do listener.

nota

O console exibe as regras em ordem de prioridade. No entanto, o console exibe um número de sequência para cada regra, que pode ser diferente da prioridade da regra exibida pela AWS CLI ou pela API do Elastic Load Balancing.

Requisitos

• Cada regra deve incluir exatamente uma das seguintes ações: forward, redirect ou fixed-response e deve ser a última ação a ser executada.

• Cada regra pode incluir zero ou uma das seguintes condições: host-header, http-request-method, path-pattern e source-ip, além de zero ou mais das seguintes condições: http-header e query-string.

• Você pode especificar até três strings de comparação por condição e até cinco por regra.

• Uma ação de forward faz o roteamento das solicitações para seu grupo de destino. Antes de adicionar uma ação forward, crie o grupo de destino e adicione destinos a ele. Para obter mais informações, consulte Criar um grupo de destino.

Adicionar uma regra

Você define uma regra padrão ao criar um listener e pode definir regras não padrão adicionais a qualquer momento.

New EC2 experience

Para adicionar uma regra usando o console

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

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

3. Selecione o balanceador de carga para visualizar seus detalhes.

4. Na guia Receptores e regras, execute uma das seguintes ações:

   1. Selecione o texto na coluna Protocolo:Porta para abrir a página de detalhes do receptor.

      Na guia Regras, selecione Adicionar regra.

   2. Selecione o receptor ao qual deseja adicionar uma regra.

      Escolha Gerenciar regras e, em seguida, Adicionar regra.

5. Embora isso não seja obrigatório, você pode especificar um nome para sua regra em Nome e tags.

   Para adicionar mais tags, selecione Adicionar tags adicionais.

6. Escolha Next (Próximo).

7. Escolha Add condition (Adicionar condição).

8. Adicione uma ou mais das seguintes condições:

   • Cabeçalho do host: defina o cabeçalho do host. Por exemplo: *.example.com. Para salvar a condição, escolha Confirmar.

     Máximo de 128 caracteres. Não diferencia maiúsculas de minúsculas. Os caracteres permitidos são a-z, A-Z, 0-9 e os seguintes caracteres especiais: -_.; e curingas (* e ?).

   • Caminho: defina o caminho. Por exemplo: /item/* . Para salvar a condição, escolha Confirmar.

     Máximo de 128 caracteres. Diferencia maiúsculas e minúsculas. Os caracteres permitidos são a-z, A-Z, 0-9 e os seguintes caracteres especiais: _-.$/~"'@:+; &; e curingas (* e ?).

   • Método de solicitação HTTP: defina o método de solicitação HTTP. Para salvar a condição, escolha Confirmar.

     Máximo de 40 caracteres. Diferencia maiúsculas e minúsculas. Os caracteres permitidos são A-Z e os seguintes caracteres especiais: -_. Curingas não são compatíveis.

   • IP de origem: defina o endereço IP de origem no formato CIDR. Para salvar a condição, escolha Confirmar.

     É permitido usar CIDRs IPv4 ou IPv6. Curingas não são compatíveis.

   • Cabeçalho HTTP: digite o nome do cabeçalho e adicione uma ou mais strings de comparação. Para salvar a condição, escolha Confirmar.

     • Nome do cabeçalho HTTP: a regra avaliará as solicitações que contêm esse cabeçalho para confirmar os valores correspondentes.

       Máximo de 40 caracteres. Não diferencia maiúsculas de minúsculas. Os caracteres permitidos são a-z, A-Z, 0-9 e os seguintes caracteres especiais: *?-!#$%&'+.^_`|~. Curingas não são compatíveis.

     • Valor do cabeçalho HTTP: insira cadeias de caracteres para comparação com o valor do cabeçalho HTTP.

       Máximo de 128 caracteres. Não diferencia maiúsculas de minúsculas. Os caracteres permitidos são a-z, A-Z, 0-9, espaços e os seguintes caracteres especiais: !"#$%&'()+,./:;⩽=>@[]^_`{|}~-; e curingas (* e ?).

   • String de consulta: roteia as solicitações com base em pares de chave/valor ou em valores na string de consulta. Para salvar a condição, escolha Confirmar.

     Máximo de 128 caracteres. Não diferencia maiúsculas de minúsculas. Os caracteres permitidos são a-z, A-Z, 0-9 e os seguintes caracteres especiais: _-.$/~"'@:+&()!,;=; e curingas (* e ?).

9. Escolha Next (Próximo).

10. Defina uma das seguintes ações para sua regra:

    • Encaminhar para grupos de destino: escolha um ou mais grupos de destino para os quais deseja encaminhar o tráfego. Para adicionar grupos de destino, escolha Adicionar grupo de destino. Se estiver usando mais de um grupo de destino, selecione um peso para cada grupo de destino e revise o percentual associado. Se tiver habilitado a persistência em um ou mais dos grupos de destino, você deverá ativar a persistência no nível de grupo em uma regra.

    • Redirecionar para URL: especifique o URL para o qual as solicitações do cliente serão redirecionadas. É possível fazer isso 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, você pode configurar redirecionamentos como temporários (HTTP 302) ou permanentes (HTTP 301) com base em suas necessidades.

    • Retornar resposta fixa: especifique o código de resposta que será retornado às solicitações descartadas do cliente. Além disso, você pode especificar o tipo de conteúdo e o corpo da resposta, mas eles não são obrigatórios.

11. Escolha Next (Próximo).

12. Na seção Regra, especifique a prioridade da sua regra de 1 a 50.000. Recomenda-se deixar lacunas entre os números de prioridade das regras do receptor. Veja a seção de Regras do receptor para obter um resumo em tempo real das regras existentes e das que estão sendo criadas na ocasião.

13. Escolha Next (Próximo).

14. Revise todos os detalhes e configurações atualmente definidos para sua nova regra. Quando estiver satisfeito com suas seleções, escolha Criar.

Old EC2 experience

Para adicionar uma regra usando o console

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

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

3. Selecione o load balancer.

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

5. Na guia Regras, selecione Gerenciar regras.

6. Selecione o ícone Adicionar regras (o sinal de adição) na barra de menus, que adiciona os ícones Inserir regra aos locais onde é possível inserir uma regra na ordem de prioridade.

   

7. Escolha um dos ícones Insert Rule (Inserir regra) adicionados na etapa anterior.

8. Adicione uma ou mais condições da seguinte maneira:

   1. Para adicionar uma condição de cabeçalho de host, escolha Adicionar condição, Cabeçalho de host e insira o nome do host (p. ex., *.example.com). Para salvar a condição, escolha o ícone de marca de seleção.

      O tamanho máximo de cada string é de 128 caracteres. A comparação não diferencia maiúsculas de minúsculas. Os seguintes caracteres curinga são compatíveis: * e ?.

   2. Para adicionar uma condição de caminho, escolha Adicionar condição, Caminho e insira o padrão de caminho (p. ex., /img/*). Para salvar a condição, escolha o ícone de marca de seleção.

      O tamanho máximo de cada string é de 128 caracteres. A comparação diferencia maiúsculas de minúsculas. Os seguintes caracteres curinga são compatíveis: * e ?.

   3. Para adicionar uma condição de cabeçalho HTTP, escolha Add condition (Adicionar condição), Http header (Cabeçalho http). Insira o nome do cabeçalho e adicione uma ou mais strings de comparação. Para salvar a condição, escolha o ícone de marca de seleção.

      O tamanho máximo de cada nome de cabeçalho é de 40 caracteres, o nome do cabeçalho não diferencia maiúsculas de minúsculas e os curingas não são compatíveis. O tamanho máximo de cada string de comparação é de 128 caracteres e os seguintes caracteres curinga são compatíveis: * e ?. A comparação não diferencia maiúsculas de minúsculas.

   4. Para adicionar uma condição de método de solicitação HTTP, escolha Add condition (Adicionar condição), Http request method (Método de solicitação http) e adicione um ou mais nomes de método. Para salvar a condição, escolha o ícone de marca de seleção.

      O tamanho máximo de cada nome é de 40 caracteres. Os caracteres permitidos incluem A-Z, hífen (-) e sublinhado (_). A comparação diferencia maiúsculas de minúsculas. Curingas não são compatíveis.

   5. Para adicionar uma condição de string de consulta, escolha Add condition (Adicionar condição), Query string (String de consulta) e adicione um ou mais pares de chave/valor. Para cada par de chave/valor, você pode omitir a chave e especificar apenas o valor. Para salvar a condição, escolha o ícone de marca de seleção.

      O tamanho máximo de cada string é de 128 caracteres. A comparação não diferencia maiúsculas de minúsculas. Os seguintes caracteres curinga são compatíveis: * e ?.

   6. Para adicionar uma condição de IP de origem, escolha Add condition (Adicionar condição), Source IP (IP de origem) e adicione um ou mais blocos CIDR. Para salvar a condição, escolha o ícone de marca de seleção.

      Você pode usar endereços IPv4 e IPv6. Curingas não são compatíveis.

9. (Opcional, listener HTTPS) Para autenticar usuários, selecione Add action (Adicionar ação), Authenticate (Autenticar) e forneça as informações solicitadas. Para salvar a ação, escolha o ícone de marca de seleção. Para obter mais informações, consulte Autenticar usuários usando um Application Load Balancer.

10. Adicione uma das seguintes ações:

    • Para adicionar uma ação de encaminhamento, escolha Add action (Adicionar ação), Forward to (Encaminhar para) e escolha um ou mais grupos de destino. Se você usar mais de um grupo de destino, selecione um peso para cada grupo de destino e, opcionalmente, habilite a perdurabilidade do grupo de destino. Se habilitar a perdurabilidade do grupo de destino e houver mais de um grupo de destino, você também deverá habilitar sticky sessions nos grupos de destino. Para salvar a ação, escolha o ícone de marca de seleção. Para obter mais informações, consulte Ações de encaminhamento.

    • Para redirecionar uma ação, selecione Add action (Adicionar ação), Redirect to (Redirecionar para) e forneça o URL para o redirecionamento. Para salvar a ação, escolha o ícone de marca de seleção. Para obter mais informações, consulte Ações de redirecionamento.

    • Para adicionar uma ação de resposta fixa, selecione Add action (Adicionar ação), Return fixed response (Retornar resposta fixa) e forneça um código de resposta e o texto da resposta opcional. Para salvar a ação, escolha o ícone de marca de seleção. Para obter mais informações, consulte Ações de resposta fixa.

    

11. Escolha Save (Salvar).

12. (Opcional) Para alterar a ordem da regra, use as setas e escolha Save (Salvar). A regra padrão sempre tem a última prioridade.

13. Para sair dessa tela, selecione o ícone Voltar ao balanceador de carga (o botão Voltar) na barra de menus.

Para adicionar uma regra usando a AWS CLI

Use o comando create-rule para criar a regra. Use o comando describe-rules para visualizar informações sobre a regra.

Editar uma regra

Você pode editar a ação e as condições para uma regra 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.

New EC2 experience

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

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

3. Selecione o load balancer.

4. Na guia Receptores e regras, execute uma das seguintes ações:

   1. 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 o texto na coluna Tag de nome da regra que você deseja editar.

         Selecione Ações e Editar regra.

      2. Na guia Regras, na seção Regras do receptor, selecione a regra que deseja editar.

         Selecione Ações e Editar regra.

   2. Selecione o receptor no qual você deseja editar uma regra.

      Escolha Gerenciar regras e, em seguida, Editar regras.

5. Modifique as condições e ações conforme necessário. Você pode editar uma condição ou ação, adicionar uma condição ou excluir uma condição ou ação.

6. Selecione Save changes (Salvar alterações)

Old EC2 experience

Para editar uma regra usando o console

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

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

3. Selecione o load balancer.

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

5. Na guia Regras, selecione Gerenciar regras.

6. Selecione o ícone Editar regras (o lápis) na barra de menus.

   

7. Para a regra que vai editar, selecione o ícone Editar regra (o lápis).

8. (Opcional) Modifique as condições e ações conforme a necessidade. Por exemplo, você pode editar uma condição ou ação (ícone de lápis), adicionar uma condição, adicionar uma ação de autenticação para uma regra de um listener HTTPS ou excluir uma condição ou ação (ícone de lixeira). Você não pode adicionar condições à regra padrão.

   

9. Escolha Atualizar.

10. Para sair dessa tela, selecione o ícone Voltar ao balanceador de carga (o botão Voltar) na barra de menus.

Para editar uma regra usando a AWS CLI

Use o comando modify-rule.

Atualizar prioridade de regra

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.

New EC2 experience

Para reordenar as regras usando o console

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

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

3. Selecione o load balancer.

4. Na guia Receptores e regras, execute uma das seguintes ações:

   1. Selecione o texto nas colunas Protocolo:Porta ou Regras para abrir a página de detalhes do receptor.

      1. Escolha Ações e, em seguida, Repriorizar regras.

      2. Na guia Regras, na seção Regras do receptor, escolha Ações e depois Repriorizar regras.

   2. Selecione o receptor.

      1. Escolha Gerenciar regras e, em seguida, Repriorizar regras.

5. Na seção Regras do receptor, a coluna Prioridade exibe a prioridade das regras atuais. Selecione um valor de prioridade de regras para abrir um campo de edição no qual você pode ajustar o valor.

6. Quando estiver satisfeito com suas alterações, escolha Salvar alterações.

Old EC2 experience

nota

O console exibe um número de sequência relativo para cada regra, não a prioridade da regra. Quando você reordenar as regras usando o console, ele obterá novas prioridades de regra com base nas prioridades de regra existentes. Para definir a prioridade de uma regra para um valor específico, use a AWS CLI ou a API do Elastic Load Balancing.

Para atualizar as prioridades da regra usando a AWS CLI

Use o comando set-rule-priorities.

Excluir uma regra

Você pode excluir as regras não padrão para um listener a qualquer momento. Você não pode excluir a regra padrão do listener. Quando você exclui um listener, todas as regras são excluídas.

New EC2 experience

Para excluir uma regra usando o console

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

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

3. Selecione o load balancer.

4. Na guia Receptores e regras, execute uma das seguintes ações:

   1. Selecione o texto nas colunas Protocolo:Porta ou Regras para abrir a página de detalhes do receptor.

      1. Selecione a regra que deseja excluir.

      2. Escolha Ações e Excluir regra.

      3. Digite confirm no campo de texto e escolha Excluir.

   2. Selecione o texto na coluna Tag de nome para abrir a página de detalhes da regra.

      1. Escolha Ações e Excluir regra.

      2. Digite confirm no campo de texto e escolha Excluir.

Old EC2 experience

Para excluir uma regra usando o console

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

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

3. Selecione o load balancer.

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

5. Na guia Regras, selecione Gerenciar regras.

6. Selecione o ícone para excluir regras (o sinal de menos) na barra de menus.

7. Marque a caixa de seleção da regra e escolha Delete (Excluir). Você não pode excluir a regra padrão do listener.

8. Para sair dessa tela, selecione o ícone Voltar ao balanceador de carga (o botão Voltar) na barra de menus.

Para excluir uma regra usando a AWS CLI

Use o comando delete-rule.