CreateLoadBalancerUDPListener - ENS - Centro de documentación de Alibaba Cloud

Para crear un listener UDP, llame a CreateLoadBalancerUDPListener.

Descripción de la operación

Tasa de llamadas a la API: 100 llamadas por segundo.
Tasa de llamadas por usuario: 10 llamadas por segundo.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ens:CreateLoadBalancerUDPListener

create

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
LoadBalancerId	string	Sí	El ID de la instancia del load balancer.	lb-5q73cv04zeyh43lh74lp4****
ListenerPort	integer	Sí	El puerto del listener que se utiliza para recibir solicitudes y reenviarlas a los servidores backend. Valores válidos: 1 a 65535. Nota Para los listeners UDP, los puertos 250, 4789 y 4790 están reservados por el sistema y no están disponibles para su uso.	80
Description	string	No	El nombre del listener. El nombre debe tener entre 1 y 80 caracteres. Nota El nombre no puede comenzar con `http://` o `https://`.	example
Scheduler	string	No	El algoritmo de programación. Valores válidos: wrr (predeterminado): Round Robin ponderado. Los servidores backend con mayor peso reciben más solicitudes. wlc: Menos conexiones ponderado. Las solicitudes se distribuyen según el peso y el número de conexiones actuales de cada servidor backend. Si varios servidores backend tienen el mismo peso, el que tenga menos conexiones activas recibe la siguiente solicitud. rr: Round Robin. Las solicitudes se distribuyen a los servidores backend de forma secuencial. sch: Hash de IP de origen. Las solicitudes provenientes de la misma dirección IP de origen se enrutan al mismo servidor backend. tch: Hash de cuádruple. Las solicitudes se enrutan a los servidores backend según un hash de cuatro valores: dirección IP de origen, dirección IP de destino, puerto de origen y puerto de destino. Los flujos con los mismos cuatro valores se enrutan al mismo servidor backend. qch: Hash de ID de conexión QUIC. Las solicitudes con el mismo ID de conexión QUIC se enrutan al mismo servidor backend. iqch: Un algoritmo de hash consistente para IDs de conexión iQUIC. Los flujos con los mismos bytes segundo, tercero y cuarto en el CID de iQUIC se enrutan al mismo servidor backend. Valores válidos: rr : 轮询 wrr : 加权轮询 qch : QUIC 连接 ID 一致性哈希 tch : 四元组一致性哈希 sch : 源 IP 一致性哈希 iqch : iQUIC CID 一致性哈希 wlc : 加权最小连接数	wrr
HealthyThreshold	integer	No	El número de verificaciones de estado exitosas consecutivas necesarias para que un servidor backend se considere saludable. Valores válidos: 2 a 10. Valor predeterminado: 3.	4
UnhealthyThreshold	integer	No	El número de verificaciones de estado fallidas consecutivas necesarias para que un servidor backend se considere no saludable. Valores válidos: 2 a 10. Valor predeterminado: 3.	4
HealthCheckConnectTimeout	integer	No	El tiempo máximo de espera para obtener una respuesta a una verificación de estado. La verificación de estado falla si una instancia ENS backend no responde dentro de este tiempo. Valor predeterminado: 5. Valores válidos: 1 a 300. Unidad: segundos. Nota Si este tiempo de espera es menor que el intervalo de verificación de estado (`HealthCheckInterval`), se utiliza el valor del intervalo como tiempo de espera.	100
HealthCheckInterval	integer	No	El intervalo entre verificaciones de estado, en segundos. Valores válidos: 1 a 50. Valor predeterminado: 2.	3
BackendServerPort	integer	No	El puerto utilizado por los servidores backend. Valores válidos: 1 a 65535.	8080
HealthCheckConnectPort	integer	No	El puerto utilizado para las verificaciones de estado. Valores válidos: 1 a 65535. Si no especifica este parámetro, se utiliza el puerto especificado por `BackendServerPort`.	8080
HealthCheckReq	string	No	La cadena de solicitud para las verificaciones de estado UDP. La cadena debe tener hasta 64 caracteres y contener solo letras y dígitos.	hello
HealthCheckExp	string	No	La cadena de respuesta esperada para las verificaciones de estado UDP. La cadena debe tener hasta 64 caracteres y contener solo letras y dígitos.	ok
EipTransmit	string	No	Especifica si el paso directo de EIP está habilitado. Valores válidos: on: Habilita el paso directo de EIP. off (predeterminado): Deshabilita el paso directo de EIP. Valores válidos: off : 关闭 on : 开启	on
EstablishedTimeout	integer	No	El tiempo de espera para conexiones establecidas. Valores válidos: 10 a 900. Valor predeterminado: 900. Unidad: segundos.	500

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	El objeto de respuesta.
RequestId	string	El ID de la solicitud.	06F00FBB-3D9E-4CCE-9D43-1A6946A75456

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "06F00FBB-3D9E-4CCE-9D43-1A6946A75456"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	Invalid%s	The specified parameter %s is invalid.
400	Missing%s	You must specify the parameter %s.
400	IncorrectInstanceStatus	The current status of the resource does not support this operation.	The current operation is not supported. The disk is being reset.
400	ens.interface.error	Failed to call API.
400	LoadBalancerNotFound	The input parameter LoadBalancerId that is not found.	The load balancing instance does not exist.
400	ListenerAlreadyExists	The listenerPort already exists.	Listener already exists
400	NoPermission	Permission denied.
400	InvalidParameter.%s	The specified field %s invalid. Please check it again.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.