Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Actualización más reciente 2022-11-17 GMT+08:00

Adición de una regla de reenvío

Función

Esta API se utiliza para agregar una regla de reenvío. Después de agregar una regla de reenvío, el balanceador de carga coincide con el nombre de dominio y la ruta de acceso en la solicitud y distribuye el tráfico al grupo de servidores backend especificado por el identificador de redirect_pool_id de la política de reenvío asociada.

Restricciones

El tipo de coincidencia de reglas de reenvío en una política de reenvío debe ser único.

URI

POST /v2/{project_id}/elb/l7policies/{l7policy_id}/rules

Tabla 1 Descripción del parámetro

Parámetro

Obligatorio

Tipo

Descripción

project_id

String

Especifica el ID del proyecto.

l7policy_id

String

Especifica el ID de política de reenvío.

Solicitud

Tabla 2 Descripción del parámetro

Parámetro

Obligatorio

Tipo

Descripción

rule

Rule object

Especifica la regla de reenvío. Para más detalles, consulte Tabla 3.

Tabla 3 Descripción del parámetro rule

Parámetro

Obligatorio

Tipo

Descripción

tenant_id

No

String

Especifica el ID del proyecto en el que se utiliza la regla de reenvío.

El valor debe ser el mismo que el valor de project_id en el token.

El valor contiene un máximo de 255 caracteres.

admin_state_up

No

Boolean

Especifica el estado administrativo de la regla de reenvío.

Este parámetro está reservado y el valor predeterminado es true.

type

String

Especifica el tipo de coincidencia de una regla de reenvío.

El rango de valores varía dependiendo del protocolo del grupo de servidores backend:

  • HOST_NAME: coincide con el nombre de dominio en la solicitud.
  • PATH: coincide con la ruta de acceso en la solicitud.

El tipo de coincidencia de reglas de reenvío en una política de reenvío debe ser único.

compare_type

String

Especifica el modo de coincidencia. Las opciones son las siguientes:

Cuando type se establece en HOST_NAME, el valor de este parámetro solo puede ser el siguiente:

  • EQUAL_TO: indica la coincidencia exacta.

Cuando type se establece en PATH, el valor de este parámetro puede ser uno de los siguientes:

  • REGEX: indica coincidencia de expresiones regulares.
  • STARTS_WITH: indica coincidencia de prefijo.
  • EQUAL_TO: indica la coincidencia exacta.

invert

No

Boolean

Especifica si se admite la coincidencia inversa.

El valor puede ser true o false. El valor predeterminado es false.

Este parámetro está reservado.

key

No

String

Especifica la clave del contenido de coincidencia. El valor predeterminado es null.

Este parámetro está reservado.

El valor contiene un máximo de 255 caracteres.

value

String

Especifica el valor del contenido de coincidencia. El valor no puede contener espacios.

El valor contiene un máximo de 128 caracteres.

  • Cuando type se establece en HOST_NAME, el valor puede contener un máximo de 100 caracteres que contienen solo letras, dígitos, guiones (-) y puntos (.), y debe comenzar con una letra o un dígito.
  • Cuando type se establece en PATH, el valor puede contener un máximo de 128 caracteres. Cuando compare_type se establece en STARTS_WITH o EQUAL_TO, el valor debe comenzar con una barra diagonal (/) y solo puede contener letras, dígitos y caracteres especiales _~';@^-%#&$.*+?,=!:| \/()[]{}

Respuesta

Tabla 4 Descripción del parámetro

Parámetro

Tipo

Descripción

rule

Rule object

Especifica la regla de reenvío. Para más detalles, consulte Tabla 5.

Tabla 5 rule parameter description

Parámetro

Tipo

Descripción

id

String

Especifica el ID de regla de reenvío.

tenant_id

String

Especifica el ID del proyecto en el que se utiliza la regla de reenvío.

El valor contiene un máximo de 255 caracteres.

project_id

String

Especifica el ID del proyecto al que pertenece la regla de reenvío. Este parámetro tiene el mismo significado que tenant_id.

admin_state_up

Boolean

Especifica el estado administrativo de la regla de reenvío.

Este parámetro está reservado. El valor puede ser true o false.

  • true: habilitar
  • false: deshabilitar

type

String

Especifica el tipo de coincidencia de una regla de reenvío.

El rango de valores varía dependiendo del protocolo del grupo de servidores backend:

  • HOST_NAME: coincide con el nombre de dominio en la solicitud.
  • PATH: coincide con la ruta de acceso en la solicitud.

compare_type

String

Especifica el modo de coincidencia. Las opciones son las siguientes:

Cuando type se establece en HOST_NAME, el valor de este parámetro solo puede ser el siguiente:

  • EQUAL_TO: indica la coincidencia exacta.

Cuando type se establece en PATH, el valor de este parámetro puede ser uno de los siguientes:

  • REGEX: indica coincidencia de expresiones regulares.
  • STARTS_WITH: indica coincidencia de prefijo.
  • EQUAL_TO: indica la coincidencia exacta.

invert

Boolean

Especifica si se admite la coincidencia inversa.

El valor puede ser true o false. El valor predeterminado es false.

Este parámetro está reservado.

key

String

Especifica la clave del contenido de coincidencia. El valor predeterminado es null.

Este parámetro está reservado.

El valor contiene un máximo de 255 caracteres.

value

String

Especifica el valor del contenido de coincidencia.

El valor contiene un máximo de 128 caracteres.

  • Cuando type se establece en HOST_NAME, el valor puede contener un máximo de 100 caracteres que contienen solo letras, dígitos, guiones (-) y puntos (.), y debe comenzar con una letra o un dígito.
  • Cuando type se establece en PATH, el valor puede contener un máximo de 128 caracteres. Cuando compare_type se establece en STARTS_WITH o EQUAL_TO, el valor debe comenzar con una barra diagonal (/) y solo puede contener letras, dígitos y caracteres especiales _~';@^-%#&$.*+?,=!:| \/()[]{}

provisioning_status

String

Este parámetro está reservado y su valor sólo puede ser ACTIVE.

Especifica el estado de aprovisionamiento de la regla de reenvío.

Ejemplo de la solicitud

  • Ejemplo de solicitud: Agregar una regla de reenvío
    POST https://{endpoint}/v2/a31d2bdcf7604c0faaddb058e1e08819/elb/l7policies/5ae0e1e7-5f0f-47a1-b39f-5d4c428a1586/rules  
    
    {
        "rule": {
            "compare_type": "EQUAL_TO", 
            "type": "PATH", 
            "value": "/bbb.html"
        }
    }

Ejemplo de la respuesta

  • Ejemplo de la respuesta
    {
        "rule": {
            "compare_type": "EQUAL_TO", 
            "admin_state_up": true, 
            "provisioning_status": "ACTIVE",
            "tenant_id": "a31d2bdcf7604c0faaddb058e1e08819", 
            "project_id": "a31d2bdcf7604c0faaddb058e1e08819", 
            "invert": false, 
            "value": "/bbb.html", 
            "key": null, 
            "type": "PATH", 
            "id": "c6f457b8-bf6f-45d7-be5c-a3226945b7b1"
        }
    }

Código de estado

Para más detalles, consulte Códigos de estado.