Todos os produtos
Search
Central de documentação

ENS:SetLoadBalancerTCPListenerAttribute

Última atualização: Aug 14, 2026

Modifica a configuração de um listener TCP.

Descrição da operação

  • Limite de taxa de chamadas da API: 100 chamadas por segundo.

  • Limite de 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:SetLoadBalancerTCPListenerAttribute

update

*Todos os recursos.

*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

LoadBalancerId

string

Sim

O ID da instância de load balancer.

lb-5snthcyu1x10g7tywj7iu****

ListenerPort

integer

Sim

A porta do listener cujos atributos você deseja modificar. Valores válidos: 1 a 65535.

80

Description

string

Não

A descrição do listener. A descrição deve ter de 1 a 80 caracteres.

Nota

A descrição não pode começar com http:// ou https://.

example

Scheduler

string

Não

O algoritmo de agendamento. Valores válidos:

  • wrr: Servidores backend com pesos maiores recebem mais solicitações.

  • wlc: As solicitações são distribuídas com base no peso e na carga real (número de conexões) de cada servidor backend. Quando os pesos são iguais, servidores backend com menos conexões recebem mais solicitações.

  • rr: As solicitações são distribuídas aos servidores backend em sequência.

  • sch: Hash consistente baseado em endereços IP de origem. Solicitações do mesmo endereço IP de origem são distribuídas ao mesmo servidor backend.

  • tch: Hash consistente baseado em quatro fatores: endereço IP de origem, endereço IP de destino, porta de origem e porta de destino. Solicitações do mesmo fluxo são distribuídas ao mesmo servidor backend.

Valores válidos:

  • rr :

    round-robin.

  • wrr :

    weighted round-robin.

  • tch :

    Hash consistente de quatro elementos.

  • sch :

    Hash consistente de IP de origem.

  • wlc :

    weighted least connections.

wrr

PersistenceTimeout

integer

Não

O período de tempo limite de persistência de sessão.

  • Valor padrão: 0, que indica que a persistência de sessão está desativada.

  • Valores válidos: 0 a 3600.

  • Unidade: segundos.

0

EstablishedTimeout

integer

Não

O período de tempo limite de conexão. Valores válidos: 10 a 900. Unidade: segundos.

500

HealthyThreshold

integer

Não

O número de verificações de integridade bem-sucedidas consecutivas necessárias antes que o status de verificação de integridade de um servidor backend mude de falha (inalcançável) para sucesso (alcançável). Valores válidos: 2 a 10.

4

UnhealthyThreshold

integer

Não

O número de verificações de integridade com falha consecutivas necessárias antes que o status de verificação de integridade de um servidor backend mude de sucesso (alcançável) para falha (inalcançável). Valores válidos: 2 a 10.

4

HealthCheckConnectTimeout

integer

Não

A quantidade máxima de tempo para aguardar uma resposta de uma verificação de integridade. Se o ENS backend não responder dentro do tempo especificado, a verificação de integridade falhará.

  • Valor padrão: 5 segundos.

  • Valores válidos: 1 a 300.

  • Unidade: segundos.

Nota

Se o valor de HealthCheckConnectTimeout for menor que o valor de HealthCheckInterval, HealthCheckConnectTimeout se tornará inválido e o período de tempo limite será definido como o valor de HealthCheckInterval.

100

HealthCheckConnectPort

integer

Não

A porta usada para verificações de integridade. Valores válidos: 1 a 65535. Se este parâmetro não for definido, a porta de serviço backend (BackendServerPort) será usada.

8000

HealthCheckInterval

integer

Não

O intervalo entre duas verificações de integridade consecutivas. Valores válidos: 1 a 50. Unidade: segundos.

5

HealthCheckDomain

string

Não

O nome de domínio usado para verificações de integridade.

www.aliyundoc.com

HealthCheckURI

string

Não

A URI usada para verificações de integridade. A URI deve ter de 1 a 80 caracteres.

Nota

A URI não pode ser apenas /, mas deve começar com /.

/aliyundoc/index.html

HealthCheckHttpCode

string

Não

O código de status HTTP para uma verificação de integridade Normal. Valores válidos:

  • http_2xx (padrão).

  • http_3xx.

  • http_4xx.

  • http_5xx.

http_2xx

HealthCheckType

string

Não

O tipo de verificação de integridade. Valores válidos:

  • tcp (padrão).

  • http.

Valores válidos:

  • tcp :

    TCP.

  • http :

    HTTP.

tcp

EipTransmit

string

Não

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

  • on: Ativado.

  • off (padrão): Desativado.

Valores válidos:

  • off :

    Desativado.

  • on :

    Ativado.

on

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Esquema da 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 ens.interface.error An error occurred while call the API.
400 Invalid%s The specified parameter %s is invalid.
400 Missing%s You must specify the parameter %s.
400 LoadBalancerNotFound The input parameter loadBalancerId that is not found.
400 IncorrectInstanceStatus The current status of the resource does not support this operation.
400 ListenerNotFound The input parameter listener that is not found.
400 IncorrectListenerStatus The current status of the resource does not support this operation.
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.