Regras de receptor para seu serviço VPC Lattice

Cada receptor tem uma regra padrão e regras adicionais que você pode definir. Cada regra consiste em uma prioridade, uma ou mais ações e uma ou mais condições. Você pode adicionar ou editar regras a qualquer momento.

Regras padrão

Ao criar um listener, você define as ações para a regra padrão. As regras padrão não podem ter condições. Se nenhuma das condições das regras do listener for atendida, a ação para a regra padrão será executada.

Prioridade das regras

Cada regra tem uma prioridade. 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.

Ação da regra

Os receptores dos serviços VPC Lattice oferecem suporte a ações de encaminhamento e ações de resposta fixa.

Ações de encaminhamento

É possível usar ações forward a fim de rotear solicitações para um ou mais grupos de destino do VPC Lattice. Se especificar vários grupos de destino para uma ação forward, você deverá especificar um peso para cada grupo de destino. Cada peso de grupo de destino é um valor de 0 a 999. As solicitações que correspondem a uma regra de listener com grupos de destino ponderados são distribuídas para esses grupos de destino com base em seus pesos. Por exemplo, se você especificar dois grupos de destino, cada um com um peso de 10, cada grupo de destino receberá metade das solicitações. Se você especificar dois grupos de destino, um com peso de 10 e o outro com peso de 20, o grupo de destino com peso de 20 receberá duas vezes mais solicitações do que o outro grupo de destino.

Ações de resposta fixa

Você pode usar ações de fixed-response para descartar solicitações do cliente e retornar uma resposta HTTP personalizada. Você pode usar essa ação para retornar um código de resposta 404.

exemplo Exemplo de ação de resposta fixa para o AWS CLI

Você pode especificar uma ação ao criar ou atualizar uma regra. A ação a seguir envia uma resposta fixa com o código de status especificado.

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

Condições de regra

Cada condição de regra possui um tipo e informações de configuração. Quando as condições de uma regra forem atendidas, a ação será executada.

Veja a seguir os critérios de correspondência aceitos para uma regra:

Correspondência de cabeçalho

Roteamento com base nos cabeçalhos HTTP de cada solicitação. Você pode usar condições de cabeçalho HTTP para configurar regras que roteiam solicitações com base nos cabeçalhos HTTP da solicitação. Você pode especificar os nomes dos campos de cabeçalho HTTP padrão ou personalizados. O nome do cabeçalho e a avaliação de correspondência não diferenciam maiúsculas de minúsculas. Você pode alterar essa configuração ativando a diferenciação entre maiúsculas e minúsculas. Caracteres curinga não são compatíveis com o nome do cabeçalho. Há suporte para correspondência dos tipos prefixo, exata e contém na correspondência de cabeçalho.

Correspondência de métodos

Roteamento com base no método de solicitação HTTP de cada solicitação.

Você pode usar condições do método de solicitação HTTP para configurar regras que roteiam solicitações com base no método de solicitação HTTP da solicitação. Você pode especificar métodos HTTP padrão ou personalizados. A correspondência de método diferencia maiúsculas de minúsculas. O nome do método deve ser uma correspondência exata. Caracteres curinga não são compatíveis.

Correspondência de caminho

O roteamento é baseado na correspondência dos padrões de caminho nos URLs da solicitação.

Você pode usar as condições de caminho para definir regras que roteiam solicitações com base no URL da solicitação. Caracteres curinga não são compatíveis. Há suporte para correspondência dos tipos prefixo e exata no caminho.

Adicionar uma regra

Você pode adicionar uma regra de receptor a qualquer momento.

Para adicionar uma regra de receptor usando o console

1. Abra o console do Amazon VPC em https://console.aws.amazon.com/vpc/.

2. No painel de navegação, em VPC Lattice, escolha Serviços.

3. Selecione o nome do serviço para abrir sua página de detalhes.

4. Na guia Roteamento, escolha Editar receptor.

5. Expanda as Regras do receptor e escolha Adicionar regra.

6. Em Nome da regra, insira um nome para a regra.

7. Em Prioridade, insira uma prioridade entre 1 e 100. 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.

8. Em Condição, insira um padrão de caminho para a condição de correspondência de caminho. O tamanho máximo de cada string é de 200 caracteres. A comparação não diferencia maiúsculas de minúsculas. Caracteres curinga não são compatíveis.

   Para adicionar uma condição de correspondência de cabeçalho ou de regra de correspondência de método, use o AWS CLI ou um AWS SDK.

9. Em Ação, escolha um grupo de destino do VPC Lattice.

10. Escolha Salvar alterações.

Para adicionar uma regra usando o AWS CLI

Use o comando create-rule.

Atualizar uma regra

Você pode atualizar uma regra de receptor a qualquer momento. Você pode modificar sua prioridade, condição, grupo de destino e o peso de cada grupo de destino. Não é possível modificar o nome da regra.

Para atualizar uma regra de receptor usando o console

1. Abra o console do Amazon VPC em https://console.aws.amazon.com/vpc/.

2. No painel de navegação, em VPC Lattice, escolha Serviços.

3. Selecione o nome do serviço para abrir sua página de detalhes.

4. Na guia Roteamento, escolha Editar receptor.

5. Modifique as prioridades, condições e ações da regra conforme necessário.

6. Revise as atualizações e escolha Salvar alterações.

Para atualizar uma regra usando o AWS CLI

Use o comando update-rule.

Excluir uma regra

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

Para excluir uma regra de receptor usando o console

1. Abra o console do Amazon VPC em https://console.aws.amazon.com/vpc/.

2. No painel de navegação, em VPC Lattice, escolha Serviços.

3. Selecione o nome do serviço para abrir sua página de detalhes.

4. Na guia Roteamento, escolha Editar receptor.

5. Selecione a regra e escolha Remover.

6. Escolha Salvar alterações.

Para excluir uma regra usando o AWS CLI

Use o comando delete-rule.