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á.
# Load Balancer (ELB) Stack \$1 Criar regra de ouvinte
Crie uma regra de ouvinte para o ouvinte específico. O ouvinte do Application Load Balancer, æForward𝐵 e æRedirected𝐵, são os únicos tipos de regras compatíveis.
**Classificação completa:** Implantação \$1 Componentes avançados da pilha \$1 Pilha do balanceador de carga (ELB) \$1 Criar regra de ouvinte
## Detalhes do tipo de alteração
****
| | |
| --- |--- |
| ID do tipo de alteração | ct-18weo4vv83ynk |
| Versão atual | 1,0 |
| Duração esperada da execução | 60 minutos |
| Aprovação da AWS | Obrigatório |
| Aprovação do cliente | Não obrigatório |
| Modo de execução | Automatizado |
## Informações adicionais
### Criar regra de ouvinte do ELB
#### Criando a regra de ouvinte do ELB com o console
Captura de tela desse tipo de alteração no console AMS:
![\[Console AMS Advanced, crie a seção RFC, altere a caixa de detalhes do tipo para ct-18weo4vv83ynk: Criar regra de ouvinte do ELB.\]](http://docs.aws.amazon.com/pt_br/managedservices/latest/ctref/images/guiLoadBalancerCreateELBListenerRule.png)
Como funciona:
1. Navegue até a página **Criar RFC**: No painel de navegação esquerdo do console AMS, clique **RFCs**para abrir a página da RFCs lista e, em seguida, clique em **Criar** RFC.
1. Escolha um tipo de alteração popular (CT) na visualização padrão **Procurar tipos de alteração** ou selecione uma CT na visualização **Escolher por categoria**.
+ **Navegar por tipo de alteração**: você pode clicar em um CT popular na área de **criação rápida** para abrir imediatamente a página **Executar RFC**. Observe que você não pode escolher uma versão mais antiga do CT com a criação rápida.
Para classificar CTs, use a área **Todos os tipos de alteração** na exibição **Cartão** ou **Tabela**. Em qualquer exibição, selecione uma CT e clique em **Criar RFC** para abrir a página **Executar RFC**. Se aplicável, a opção **Criar com uma versão mais antiga** aparece ao lado do botão **Criar RFC**.
+ **Escolha por categoria**: selecione uma categoria, subcategoria, item e operação e a caixa de detalhes do CT será aberta com a opção **Criar com uma versão mais antiga**, se aplicável. Clique em **Criar RFC** para abrir a página **Executar RFC**.
1. Na página **Executar RFC**, abra a área do nome do CT para ver a caixa de detalhes do CT. É necessário um **Assunto** (preenchido se você escolher seu CT na visualização **Procurar tipos de alteração**). Abra a área **Configuração adicional** para adicionar informações sobre o RFC.
Na área **Configuração de execução**, use as listas suspensas disponíveis ou insira valores para os parâmetros necessários. Para configurar parâmetros de execução opcionais, abra a área **Configuração adicional**.
1. Ao terminar, clique em **Executar**. Se não houver erros, a página **RFC criada com sucesso** será exibida com os detalhes da RFC enviada e a saída inicial de **execução**.
1. Abra a área **Parâmetros de execução** para ver as configurações que você enviou. Atualize a página para atualizar o status de execução do RFC. Opcionalmente, cancele a RFC ou crie uma cópia dela com as opções na parte superior da página.
#### Criando a regra de ouvinte do ELB com a CLI
Como funciona:
1. Use o Inline Create (você emite um `create-rfc` comando com todos os parâmetros de RFC e execução incluídos) ou o Template Create (você cria dois arquivos JSON, um para os parâmetros RFC e outro para os parâmetros de execução) e emita o `create-rfc` comando com os dois arquivos como entrada. Ambos os métodos são descritos aqui.
1. Envie o `aws amscm submit-rfc --rfc-id ID` comando RFC: com o ID RFC retornado.
Monitore o `aws amscm get-rfc --rfc-id ID` comando RFC:.
Para verificar a versão do tipo de alteração, use este comando:
```
aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CT_ID
```
**nota**
Você pode usar qualquer `CreateRfc` parâmetro com qualquer RFC, independentemente de eles fazerem parte do esquema para o tipo de alteração. Por exemplo, para receber notificações quando o status da RFC mudar, adicione essa linha `--notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}"` à parte dos parâmetros da RFC da solicitação (não aos parâmetros de execução). Para obter uma lista de todos os CreateRfc parâmetros, consulte a [Referência da API de gerenciamento de alterações do AMS](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_CreateRfc.html).
*CRIAÇÃO EM LINHA*:
Execute o comando create RFC com os parâmetros de execução fornecidos em linha (aspas de escape ao fornecer parâmetros de execução em linha) e, em seguida, envie a ID de RFC retornada. Por exemplo, você pode substituir o conteúdo por algo assim:
```
aws amscm create-rfc --change-type-id "ct-18weo4vv83ynk" --change-type-version "1.0" --title "Create ALB Listener Rule" --execution-parameters "{\"DocumentName\":\"AWSManagedServices-CreateListenerRule\",\"Parameters\":{\"ListenerArn\":[\"LISTENER_ARN\"],\"Conditions\":[\"{\\\"Field\\\":\\\"path-pattern\\\",\\\"PathPatternConfig\\\":{\\\"Values\\\":[\\\"/img/*\\\"]}}\"],\"RuleType\":[\"redirect\"],\"Priority\":[\"200\"],\"TargetGroups\":[\"{}\"],\"TargetGroupStickinessConfig\":[\"\"],\"TargetGroupStickinessDuration\":[\"\"],\"RedirectProtocol\":[\"HTTP\"],\"RedirectPort\":[\"85\"],\"RedirectHost\":[\"www.example.com\"],\"RedirectPath\":[\"/new-path\"],\"RedirectQuery\":[\"page1\"],\"RedirectStatusCode\":[\"HTTP_301\"]},\"Region\":\"REGION\""}"
```
```
aws amscm create-rfc --change-type-id "ct-18weo4vv83ynk" --change-type-version "1.0" --title "Create ALB Listener Rule" --execution-parameters "{\"DocumentName\":\"AWSManagedServices-CreateListenerRule\",\"Parameters\":{\"ListenerArn\":[\"LISTENER_ARN\"],\"Conditions\":[\"{\\\"Field\\\":\\\"path-pattern\\\",\\\"PathPatternConfig\\\":{\\\"Values\\\":[\\\"/img/*\\\"]}}\"],\"RuleType\":[\"forward\"],\"Priority\":[\"125\"],\"TargetGroups\":[\"{\\\"TargetGroupArn\\\":\\\"TARGET_GROUP_ARN\\\",\\\"Weight\\\":\\\"20\\\"}\"],\"TargetGroupStickinessConfig\":[\"Enabled\"],\"TargetGroupStickinessDuration\":[\"15\"],\"RedirectProtocol\":[\"\"],\"RedirectPort\":[\"\"],\"RedirectHost\":[\"\"],\"RedirectPath\":[\"\"],\"RedirectQuery\":[\"\"],\"RedirectStatusCode\":[\"\"]},\"Region\":\"REGION\"}"
```
*CRIAÇÃO DE MODELO*:
1. Envie os parâmetros de execução desse tipo de alteração para um arquivo JSON chamado validateCreateRule .actions.JSON.
```
aws amscm get-change-type-version --change-type-id "ct-18weo4vv83ynk" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > validateCreateRule.Actions.json
```
1. Modifique e salve o arquivo JSON dos parâmetros de execução. Por exemplo, você pode substituir o conteúdo por algo assim:
Exemplo de todos os parâmetros:
```
{
"DocumentName": "AWSManagedServices-CreateListenerRule",
"Region": "us-west-2",
"Parameters": {
"ListenerArn": ["LISTENER_ARN"],
"Conditions": ["{\"Field\":\"host-header\",\"HostHeaderConfig\":{\"Values\":[\"example.com\"]}}"],
"RuleType": ["forward"],
"Priority": ["200"],
"TargetGroups": ["{\"TargetGroupArn\":\"TARGET_GROUP_ARN\",\"Weight\":\"100\"}"],
"TargetGroupStickinessConfig": ["Enabled"],
"TargetGroupStickinessDuration": ["86400"],
"RedirectProtocol": [""],
"RedirectPort": [""],
"RedirectHost": [""],
"RedirectPath": [""],
"RedirectQuery": [""],
"RedirectStatusCode": [""],
"Priority": "High"
}
}
```
```
{
"DocumentName": "AWSManagedServices-CreateListenerRule",
"Parameters": {
"ListenerArn": [
"LISTENER_ARN"
],
"Conditions": [
"{\"Field\":\"path-pattern\",\"PathPatternConfig\":{\"Values\":[\"/img/*\"]}}"
],
"RuleType": [
"forward"
],
"Priority": [
"125"
],
"TargetGroups": [
"{\"TargetGroupArn\":\"TARGET_GROUP_ARN\",\"Weight\":\"20\"}"
],
"TargetGroupStickinessConfig": [
"Enabled"
],
"TargetGroupStickinessDuration": [
"15"
],
"RedirectProtocol": [
""
],
"RedirectPort": [
""
],
"RedirectHost": [
""
],
"RedirectPath": [
""
],
"RedirectQuery": [
""
],
"RedirectStatusCode": [
""
]
},
"Region": "REGION",
"Priority": "High"
}
```
1. Envie o modelo JSON para um arquivo na sua pasta atual; este exemplo o chama de CreateListenerRuleRfc .json:
```
aws amscm create-rfc --generate-cli-skeleton > CreateListenerRuleRfc.json
```
1. Modifique e salve o CreateListenerRuleRfc arquivo.json. Por exemplo, você pode substituir o conteúdo por algo assim:
```
{
"ChangeTypeVersion": "1.0",
"ChangeTypeId": "ct-18weo4vv83ynk",
"Title": "Create ALB Listener Rule"
}
```
1. Crie o RFC, especificando o arquivo de parâmetros de execução e o validateCreateRule arquivo:
```
aws amscm create-rfc --cli-input-json file://CreateListenerRuleRfc.json --execution-parameters file://validateCreateRule.json
```
Você recebe a ID da nova RFC na resposta e pode usá-la para enviar e monitorar a RFC. Até que você o envie, o RFC permanece no estado de edição e não inicia.
#### Dicas
Para saber mais sobre o AWS Application Load Balancers, consulte [O que é um Application Load](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/introduction.html) Balancer?
## Parâmetros de entrada de execução
Para obter informações detalhadas sobre os parâmetros de entrada de execução, consulte[Esquema para alteração do tipo ct-18weo4vv83ynk](schemas.md#ct-18weo4vv83ynk-schema-section).
## Exemplo: parâmetros obrigatórios
```
{
"DocumentName": "AWSManagedServices-CreateListenerRule",
"Region": "us-east-1",
"Parameters": {
"ListenerArn": ["arn:aws:elasticloadbalancing:us-east-1:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2"],
"Conditions": ["{\"Field\":\"path-pattern\",\"PathPatternConfig\":{\"Values\":[\"/img/*\"]}}"],
"RuleType": ["forward"],
"Priority": ["100"]
}
}
```
## Exemplo: Todos os parâmetros
```
{
"DocumentName": "AWSManagedServices-CreateListenerRule",
"Region": "us-west-2",
"Parameters": {
"ListenerArn": ["arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2"],
"Conditions": ["{\"Field\":\"host-header\",\"HostHeaderConfig\":{\"Values\":[\"example.com\"]}}"],
"RuleType": ["forward"],
"Priority": ["200"],
"TargetGroups": ["{\"TargetGroupArn\":\"arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067\",\"Weight\":\"100\"}"],
"TargetGroupStickinessConfig": ["Enabled"],
"TargetGroupStickinessDuration": ["86400"],
"RedirectProtocol": [""],
"RedirectPort": [""],
"RedirectHost": [""],
"RedirectPath": [""],
"RedirectQuery": [""],
"RedirectStatusCode": [""]
}
}
```