Todos os produtos
Search
Central de documentação

ENS:CreateLoadBalancerUDPListener

Última atualização: Jun 29, 2026

Para criar um listener UDP, chame CreateLoadBalancerUDPListener.

Descrição da operação

  • Taxa de chamadas de API: 100 chamadas por segundo.

  • Taxa de chamadas por usuário: 10 chamadas por segundo.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ens:CreateLoadBalancerUDPListener

create

*All Resource

*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

LoadBalancerId

string

Sim

O ID da instância do load balancer.

lb-5q73cv04zeyh43lh74lp4****

ListenerPort

integer

Sim

A porta do listener usada para receber solicitações e encaminhá-las aos servidores de back-end. Valores válidos: 1 a 65535.

Nota

Para listeners UDP, as portas 250, 4789 e 4790 são reservadas pelo sistema e não estão disponíveis para uso.

80

Description

string

Não

O nome do listener. O nome deve ter de 1 a 80 caracteres.

Nota

O nome não pode começar com http:// ou https://.

example

Scheduler

string

Não

O algoritmo de agendamento. Valores válidos:

  • wrr (padrão): Weighted Round Robin. Servidores de back-end com maior peso recebem mais solicitações.

  • wlc: Weighted Least Connections. As solicitações são distribuídas com base no peso e no número de conexões atuais de cada servidor de back-end. Se vários servidores de back-end tiverem o mesmo peso, aquele com o menor número de conexões ativas receberá a próxima solicitação.

  • rr: Round Robin. As solicitações são distribuídas aos servidores de back-end sequencialmente.

  • sch: Source IP Hash. As solicitações do mesmo endereço IP de origem são roteadas para o mesmo servidor de back-end.

  • tch: Four-tuple Hash. As solicitações são roteadas para servidores de back-end com base em um hash de quatro valores: endereço IP de origem, endereço IP de destino, porta de origem e porta de destino. Fluxos com os mesmos quatro valores são roteados para o mesmo servidor de back-end.

  • qch: QUIC Connection ID Hash. As solicitações com o mesmo QUIC Connection ID são roteadas para o mesmo servidor de back-end.

  • iqch: Um algoritmo de hash consistente para iQUIC Connection IDs. Fluxos com os mesmos segundo, terceiro e quarto bytes no iQUIC CID são roteados para o mesmo servidor de back-end.

wrr

HealthyThreshold

integer

Não

O número de verificações de integridade bem-sucedidas consecutivas necessárias para que um servidor de back-end seja considerado íntegro. Valores válidos: 2 a 10. Valor padrão: 3.

4

UnhealthyThreshold

integer

Não

O número de verificações de integridade com falha consecutivas necessárias para que um servidor de back-end seja considerado não íntegro. Valores válidos: 2 a 10. Valor padrão: 3.

4

HealthCheckConnectTimeout

integer

Não

O tempo máximo de espera por uma resposta a uma verificação de integridade. Uma verificação de integridade falha se uma instância ENS de back-end não responder dentro desse tempo.

  • Valor padrão: 5.

  • Valores válidos: 1 a 300.

  • Unidade: segundos.

Nota

Se este tempo limite for menor que o intervalo de verificação de integridade (HealthCheckInterval), o valor do intervalo será usado para o tempo limite.

100

HealthCheckInterval

integer

Não

O intervalo entre as verificações de integridade, em segundos. Valores válidos: 1 a 50. Valor padrão: 2.

3

BackendServerPort

integer

Não

A porta usada pelos servidores de back-end. Valores válidos: 1 a 65535.

8080

HealthCheckConnectPort

integer

Não

A porta usada para verificações de integridade. Valores válidos: 1 a 65535. Se você não especificar este parâmetro, a porta especificada por BackendServerPort será usada.

8080

HealthCheckReq

string

Não

A string de solicitação para verificações de integridade UDP. A string deve ter até 64 caracteres e conter apenas letras e dígitos.

hello

HealthCheckExp

string

Não

A string de resposta esperada para verificações de integridade UDP. A string deve ter até 64 caracteres e conter apenas letras e dígitos.

ok

EipTransmit

string

Não

Especifica se o pass-through de EIP está ativado. Valores válidos:

  • on: Ativa o pass-through de EIP.

  • off (padrão): Desativa o pass-through de EIP.

on

EstablishedTimeout

integer

Não

O tempo limite para conexões estabelecidas. Valores válidos: 10 a 900. Valor padrão: 900. Unidade: segundos.

500

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O objeto de resposta.

RequestId

string

O ID da solicitação.

06F00FBB-3D9E-4CCE-9D43-1A6946A75456

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

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 Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.