

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Pila de Load Balancer (ELB) \$1 Crear regla de escucha
<a name="deployment-advanced-load-balancer-elb-stack-create-listener-rule"></a>

Cree una regla de escucha para el oyente específico. Los únicos tipos de reglas admitidos son Application Load Balancer, listener ÆForwardæ y ÆRedirectedæC.

**Clasificación completa:** Despliegue \$1 Componentes de pila avanzados \$1 Pila de balanceador de carga (ELB) \$1 Creación de una regla de escucha

## Detalles del tipo de cambio
<a name="ct-18weo4vv83ynk-DALc-table"></a>


****  

|  |  | 
| --- |--- |
| ID de tipo de cambio | ct-18weo4vv83ynk | 
| Versión actual | 1.0 | 
| Duración prevista de la ejecución | 60 minutos | 
| Aprobación de AWS | Obligatorio | 
| Aprobación del cliente | No obligatorio | 
| Modo de ejecución | Automatizado | 

## Información adicional
<a name="deployment-advanced-load-balancer-elb-stack-create-listener-rule-info"></a>

### Cree la regla ELB Listener
<a name="ex-load-balancer-create-elb-listener-rule-col"></a>

#### Creación de la regla ELB Listener con la consola
<a name="load-balancer-create-elb-listener-rule-con"></a>

Captura de pantalla de este tipo de cambio en la consola AMS:

![\[Consola AMS Advanced, crea una sección de RFC, cambia el cuadro de detalles del tipo para ct-18weo4vv83ynk: crea la regla ELB Listener.\]](http://docs.aws.amazon.com/es_es/managedservices/latest/ctref/images/guiLoadBalancerCreateELBListenerRule.png)


Funcionamiento:

1. **Vaya a la página **Crear RFC**: en el panel de navegación izquierdo de la consola AMS, haga clic para abrir la página de lista y, a continuación, haga clic en Crear RFC. **RFCs** RFCs **

1. Elija un tipo de cambio (CT) popular en la vista predeterminada **de búsqueda de tipos de cambios** o seleccione un CT en la vista **Elegir por categoría**.
   + **Busque por tipo de cambio**: puede hacer clic en un CT popular en el área de **creación rápida** para abrir inmediatamente la página **Ejecutar RFC**. Tenga en cuenta que no puede elegir una versión antigua de CT con Quick Create.

     Para ordenar CTs, utilice el área **Todos los tipos de cambios** en la vista **de tarjeta** o de **tabla**. En cualquiera de las vistas, seleccione una CT y, a continuación, haga clic en **Crear RFC** para abrir la página **Ejecutar RFC**. Si corresponde, aparece la opción **Crear con una versión anterior** junto al botón **Crear RFC**.
   + **Elegir por categoría**: seleccione una categoría, una subcategoría, un elemento y una operación, y se abrirá el cuadro de detalles del CT con la opción **Crear con una versión anterior, si corresponde**. Haga clic en **Crear RFC** para abrir la página **Ejecutar RFC**.

1. En la página **Ejecutar RFC**, abra el área del nombre del CT para ver el cuadro de detalles del CT. Se requiere un **asunto** (lo rellena automáticamente si elige su CT en la vista **Buscar tipos de cambios**). Abra el área **de configuración adicional** para añadir información sobre la RFC.

   En el área de **configuración de ejecución**, utilice las listas desplegables disponibles o introduzca valores para los parámetros necesarios. Para configurar los parámetros de ejecución opcionales, abra el área **de configuración adicional**.

1. Cuando haya terminado, haga clic en **Ejecutar**. Si no hay errores, aparecerá la página de la **RFC creada correctamente** con los detalles de la RFC enviada y el resultado inicial de la **ejecución**. 

1. Abra el área de **parámetros de ejecución** para ver las configuraciones que envió. Actualice la página para actualizar el estado de ejecución de la RFC. Si lo desea, cancele la RFC o cree una copia de la misma con las opciones de la parte superior de la página.

#### Creación de la regla ELB Listener con la CLI
<a name="load-balancer-create-elb-listener-rule-cli"></a>

Funcionamiento:

1. Utilice la función de creación integrada (se emite un `create-rfc` comando con todos los parámetros de RFC y de ejecución incluidos) o la de plantilla (se crean dos archivos JSON, uno para los parámetros de RFC y otro para los parámetros de ejecución) y ejecute el `create-rfc` comando con los dos archivos como entrada. Ambos métodos se describen aquí.

1. Envíe el `aws amscm submit-rfc --rfc-id ID` comando RFC: con el ID de RFC devuelto.

   Supervise el comando RFC:. `aws amscm get-rfc --rfc-id ID`

Para comprobar la versión del tipo de cambio, utilice este comando:

```
aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CT_ID
```
**nota**  
Puede utilizar cualquier `CreateRfc` parámetro con cualquier RFC, forme o no parte del esquema del tipo de cambio. Por ejemplo, para recibir notificaciones cuando cambie el estado de la RFC, añada esta línea `--notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}"` a la parte de los parámetros de la RFC de la solicitud (no a los parámetros de ejecución). Para ver una lista de todos los CreateRfc parámetros, consulta la referencia de la [API de administración de cambios de AMS](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_CreateRfc.html).

*CREACIÓN EN LÍNEA*:

Ejecute el comando create RFC con los parámetros de ejecución incluidos en línea (comillas de escape al proporcionar los parámetros de ejecución en línea) y, a continuación, envíe el ID de RFC devuelto. Por ejemplo, puedes reemplazar el contenido por algo como esto:

```
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\"}"
```

*CREACIÓN DE PLANTILLA*:

1. Envía los parámetros de ejecución de este tipo de cambio a un archivo JSON denominado validateCreateRule .actions.JSON.

   ```
   aws amscm get-change-type-version --change-type-id "ct-18weo4vv83ynk" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > validateCreateRule.Actions.json
   ```

1. Modifique y guarde el archivo JSON de los parámetros de ejecución. Por ejemplo, puedes reemplazar el contenido por algo como esto:

   Ejemplo de todos los 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. Envía la plantilla JSON a un archivo de tu carpeta actual; en este ejemplo se le asigna el nombre CreateListenerRuleRfc .json:

   ```
   aws amscm create-rfc --generate-cli-skeleton > CreateListenerRuleRfc.json
   ```

1. Modifica y guarda el CreateListenerRuleRfc archivo.json. Por ejemplo, puedes reemplazar el contenido por algo como esto:

   ```
   {
   "ChangeTypeVersion": "1.0",
   "ChangeTypeId": "ct-18weo4vv83ynk",
   "Title": "Create ALB Listener Rule"
   }
   ```

1. Cree el RFC especificando el archivo de parámetros de ejecución y el validateCreateRule archivo:

   ```
   aws amscm create-rfc --cli-input-json file://CreateListenerRuleRfc.json  --execution-parameters file://validateCreateRule.json
   ```

   Recibirá el ID de la nueva RFC en la respuesta y podrá utilizarla para enviar y supervisar la RFC. Hasta que la envíe, la RFC permanece en estado de edición y no se inicia.

#### Consejos
<a name="ex-load-balancer-create-elb-listener-rule-tip"></a>

Para obtener más información sobre los balanceadores de carga de aplicaciones de AWS, consulte [¿Qué es un balanceador de carga de aplicaciones](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/introduction.html)?

## Parámetros de entrada de ejecución
<a name="deployment-advanced-load-balancer-elb-stack-create-listener-rule-input"></a>

Para obtener información detallada sobre los parámetros de entrada de la ejecución, consulte[Esquema para el tipo de cambio ct-18weo4vv83ynk](schemas.md#ct-18weo4vv83ynk-schema-section).

## Ejemplo: Parámetros necesarios
<a name="deployment-advanced-load-balancer-elb-stack-create-listener-rule-ex-min"></a>

```
{
  "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"]
  }
}
```

## Ejemplo: todos los parámetros
<a name="deployment-advanced-load-balancer-elb-stack-create-listener-rule-ex-max"></a>

```
{
  "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": [""]
  }
}
```