

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

# Regras de receptor para seu serviço VPC Lattice
<a name="listener-rules"></a>

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.

**Topics**
+ [Regras padrão](#listener-default-rule)
+ [Prioridade das regras](#listener-rule-priority)
+ [Ação da regra](#listener-rule-actions)
+ [Condições de regra](#listener-rule-conditions)
+ [Adicionar uma regra](#add-rules)
+ [Atualizar uma regra](#update-rules)
+ [Excluir uma regra](#delete-rules)

## Regras padrão
<a name="listener-default-rule"></a>

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
<a name="listener-rule-priority"></a>

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
<a name="listener-rule-actions"></a>

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

### Ações de encaminhamento
<a name="forward-actions"></a>

É 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
<a name="fixed-response-actions"></a>

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 ou 500.

**Example 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
<a name="listener-rule-conditions"></a>

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 na solicitação URLs.   
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
<a name="add-rules"></a>

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

**Para adicionar uma regra de receptor usando o console**

1. Abra o console da Amazon VPC em [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/).

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

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

1. Na guia **Roteamento**, escolha **Editar receptor**.

1. Expanda as **Regras do receptor** e escolha **Adicionar regra**.

1. Em **Nome da regra**, insira um nome para a regra.

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

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

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

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

**Para adicionar uma regra usando o AWS CLI**  
Use o comando [create-rule](https://docs.aws.amazon.com/cli/latest/reference/vpc-lattice/create-rule.html).

## Atualizar uma regra
<a name="update-rules"></a>

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 da Amazon VPC em [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/).

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

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

1. Na guia **Roteamento**, escolha **Editar receptor**.

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

1. Revise as atualizações e escolha **Salvar alterações**.

**Para atualizar uma regra usando o AWS CLI**  
Use o comando [update-rule](https://docs.aws.amazon.com/cli/latest/reference/vpc-lattice/update-rule.html).

## Excluir uma regra
<a name="delete-rules"></a>

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 da Amazon VPC em [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/).

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

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

1. Na guia **Roteamento**, escolha **Editar receptor**.

1. Selecione a regra e escolha **Remover**.

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

**Para excluir uma regra usando o AWS CLI**  
Use o comando [delete-rule](https://docs.aws.amazon.com/cli/latest/reference/vpc-lattice/delete-rule.html).