Todos los productos
Search
Centro de documentos

ENS:SetLoadBalancerUDPListenerAttribute

Última actualización: Sep 01, 2026

Llama a `SetLoadBalancerUDPListenerAttribute` para modificar un listener UDP.

Descripción de la operación

  • Límite de tasa de llamadas a la API: 100 solicitudes por segundo.

  • Límite de tasa por usuario: 10 solicitudes 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:SetLoadBalancerUDPListenerAttribute

update

*All Resource

*

Ninguna 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-5pzipr2fszqtl2xf64uy5****

ListenerPort

integer

Sí

El puerto del listener que se va a modificar. Valores válidos: 1 a 65535.

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:// ni https://.

example

Scheduler

string

No

El algoritmo de programación. Valores válidos:

  • wrr: Round Robin ponderado. Los servidores backend con pesos más altos reciben una mayor proporción de solicitudes.

  • wlc: Menos conexiones ponderado. Las solicitudes se distribuyen según los pesos y el número de conexiones activas de los servidores backend. Si los servidores tienen el mismo peso, el servidor con menos conexiones activas recibe más solicitudes.

  • rr: Round Robin. Las solicitudes se distribuyen a los servidores backend en secuencia.

  • sch: Hash de IP de origen. Un hash consistente basado en la dirección IP de origen. Las solicitudes provenientes de la misma dirección IP de origen se enrutan al mismo servidor backend.

  • tch: Hash de 4-tupla. Un hash consistente basado en la 4-tupla (IP de origen, IP de destino, puerto de origen y puerto de destino). Los flujos con la misma 4-tupla se enrutan al mismo servidor backend.

  • qch: Hash de ID de conexión QUIC. Un hash consistente basado en el ID de conexión QUIC. Las solicitudes con el mismo ID de conexión QUIC se enrutan al mismo servidor backend.

  • iqch: Hash de CID iQUIC. Un hash consistente basado en tres bytes específicos (del segundo al cuarto byte) del CID iQUIC. Las solicitudes con valores idénticos en estos tres bytes 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 marcar un servidor backend no saludable como saludable. Valores válidos: 2 a 10.

4

UnhealthyThreshold

integer

No

El número de verificaciones de estado fallidas consecutivas necesarias para marcar un servidor backend saludable como no saludable. Valores válidos: 2 a 10.

4

HealthCheckConnectTimeout

integer

No

El tiempo de espera para una respuesta de verificación de estado. Si una instancia ENS backend no responde dentro de este período de tiempo de espera, la verificación de estado falla.

  • Valor predeterminado: 5

  • Valores válidos: 1 a 300

  • Unidad: segundos

Nota

Si el valor de HealthCheckConnectTimeout es menor que el valor de HealthCheckInterval, el sistema ignora HealthCheckConnectTimeout y utiliza el valor de HealthCheckInterval como período de tiempo de espera.

100

HealthCheckInterval

integer

No

El intervalo, en segundos, entre verificaciones de estado consecutivas. Valores válidos: 1 a 50.

5

HealthCheckConnectPort

integer

No

El puerto utilizado para las verificaciones de estado. Valores válidos: 1 a 65535. Si no se especifica, toma de forma predeterminada el puerto del servidor backend (BackendServerPort).

8080

HealthCheckReq

string

No

La cadena de solicitud para una verificación de estado de listener UDP. La cadena solo puede contener letras y dígitos, y debe tener una longitud máxima de 64 caracteres.

hello

HealthCheckExp

string

No

La cadena de respuesta esperada para una verificación de estado de listener UDP. La cadena solo puede contener letras y dígitos, y debe tener una longitud máxima de 64 caracteres.

ok

EipTransmit

string

No

Especifica si se debe habilitar el paso directo de EIP. 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, en segundos. El valor debe ser un número entero de 10 a 900. El valor predeterminado es 900.

500

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

Esquema de la 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 IncorrectListenerStatus The current status of the resource does not support this operation. The listener status is incorrect.
400 ListenerNotFound Listener is not found. Listener does not exist
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.