Todos os produtos
Search
Central de documentação

ENS:DescribeLoadBalancerAttribute

Última atualização: Aug 11, 2026

Consulta os detalhes de uma instância de balanceamento de carga especificada.

Descrição da operação

  • Taxa de chamadas da 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:DescribeLoadBalancerAttribute

get

*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 balanceamento de carga.

lb-5rcvo1n1t3hykfhhjwjgq****

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O esquema da resposta.

RequestId

string

O ID da solicitação.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

LoadBalancerId

string

O ID da instância de balanceamento de carga.

lb-5rcvo1n1t3hykfhhjwjgqp****

LoadBalancerName

string

O nome da instância de balanceamento de carga.

example

LoadBalancerStatus

string

O status do listener da instância de balanceamento de carga. Valores válidos:

  • Active: Os listeners da instância podem encaminhar o tráfego recebido com base nas regras.

  • InActive: Os listeners da instância não encaminham mais o tráfego recebido.

Active

EnsRegionId

string

O ID do nó ENS.

cn-chengdu-telecom

Address

string

O endereço de serviço da instância de balanceamento de carga.

192.168.XX.XX

NetworkId

string

O ID da rede.

n-5rwbi3g9zvgxcsiufwhw8****

VSwitchId

string

O ID do vSwitch.

vsw-5s78m2pdr9osa0j64bn78****

Bandwidth

integer

A largura de banda máxima da instância de balanceamento de carga. O valor padrão é -1, que indica que a largura de banda não é limitada.

-1

LoadBalancerSpec

string

A especificação da instância de balanceamento de carga.

elb.s2.medium

CreateTime

string

A hora de criação da instância de balanceamento de carga (UTC).

2019-05-21T12:22:00Z

EndTime

string

A hora de término da instância de balanceamento de carga no formato UTC ISO 8601 (AAAA-MM-DDTHH:mm:ssZ).

2020-05-21T12:22:00Z

ListenerPorts

array

As portas de frontend usadas pela instância de balanceamento de carga.

string

As portas de frontend usadas pela instância de balanceamento de carga.

80

BackendServers

array<object>

A lista de servidores backend.

object

A lista de servidores backend.

ServerId

string

O ID da instância do servidor backend.

i-5vb5h5njxiuhn48a****

Ip

string

O endereço IP do servidor backend.

192.168.XX.XX

Port

string

A porta usada pelo servidor backend.

0

Type

string

O tipo de servidor do servidor backend.

ens

Weight

integer

O peso do servidor backend.

100

ListenerPortsAndProtocols

array<object>

As portas e protocolos de frontend usados pela instância de balanceamento de carga.

object

As portas e protocolos de frontend usados pela instância de balanceamento de carga.

ListenerPort

integer

A porta do listener.

8080

ListenerProtocol

string

O protocolo do listener.

tcp

Description

string

A descrição.

test

ListenerForward

string

Indica se o encaminhamento do listener está ativado.

off

ForwardPort

integer

A porta do listener de destino para a qual o tráfego é encaminhado.

0

BackendServerPort

integer

A porta backend usada pela instância de balanceamento de carga. Valores válidos: 1 a 65535.

6000

AddressIPVersion

string

A versão do IP da instância de balanceamento de carga. Valores válidos: ipv4 ou ipv6.

ipv4

PayType

string

O método de cobrança. Valores válidos:

  • PrePaid: assinatura.

  • PostPaid (atualmente o único método de cobrança suportado): pay-as-you-go.

PostPaid

LoadBalancerType

string

O tipo da instância de balanceamento de carga.

CLB

AddressType

string

O tipo de endereço da instância de balanceamento de carga.

internet

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "LoadBalancerId": "lb-5rcvo1n1t3hykfhhjwjgqp****",
  "LoadBalancerName": "example.",
  "LoadBalancerStatus": "Active.",
  "EnsRegionId": "cn-chengdu-telecom.",
  "Address": "192.168.XX.XX",
  "NetworkId": "n-5rwbi3g9zvgxcsiufwhw8****",
  "VSwitchId": "vsw-5s78m2pdr9osa0j64bn78****",
  "Bandwidth": -1,
  "LoadBalancerSpec": "elb.s2.medium.",
  "CreateTime": "2019-05-21T12:22:00Z",
  "EndTime": "2020-05-21T12:22:00Z",
  "ListenerPorts": [
    "80"
  ],
  "BackendServers": [
    {
      "ServerId": "i-5vb5h5njxiuhn48a****",
      "Ip": "192.168.XX.XX\n",
      "Port": "0",
      "Type": "ens.",
      "Weight": 100
    }
  ],
  "ListenerPortsAndProtocols": [
    {
      "ListenerPort": 8080,
      "ListenerProtocol": "tcp.",
      "Description": "test.",
      "ListenerForward": "off.",
      "ForwardPort": 0,
      "BackendServerPort": 6000
    }
  ],
  "AddressIPVersion": "ipv4",
  "PayType": "PostPaid.",
  "LoadBalancerType": "CLB",
  "AddressType": "internet"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 ens.interface.error Failed to call API.
400 NoPermission Permission denied.
400 Invalid%s The specified parameter %s is invalid.
400 Missing%s You must specify the parameter %s.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.