GetListenerAttribute - Server Load Balancer: Central de Documentação do Alibaba Cloud

Consulta os detalhes de um listener.

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

alb:GetListenerAttribute

get

*LoadBalancer

acs:alb:{#regionId}:{#accountId}:loadbalancer/{#loadbalancerId}

acs:ResourceTag

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ListenerId	string	Sim	O ID do listener.	lsn-o4u54y73wq7b******

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	As informações detalhadas sobre o listener.
AclConfig	object	A configuração de ACL.
AclRelations	array<object>	A lista de IDs de grupos de controle de acesso associados ao listener.
	object	A estrutura do grupo de controle de acesso associado ao listener.
AclId	string	O ID do grupo de controle de acesso associado ao listener.	acl-doc****
Status	string	O status da associação ACL-listener. Valores válidos: Associating: A ACL está sendo associada. Associated: A ACL está associada. Dissociating: A ACL está sendo desassociada.	Associating
AclType	string	O tipo de controle de acesso. Valores válidos: White: Apenas solicitações provenientes dos endereços IP ou blocos CIDR definidos no grupo de políticas de controle de acesso selecionado são encaminhadas. Listas brancas são aplicáveis a cenários em que você deseja permitir que apenas endereços IP específicos acessem sua aplicação. Ativar uma lista branca apresenta alguns riscos. Após a ativação de uma lista branca, apenas os endereços IP nela contidos podem acessar o listener de balanceamento de carga. Se uma lista branca estiver ativada, mas nenhum endereço IP for adicionado ao grupo de políticas de controle de acesso, o listener de balanceamento de carga encaminhará todas as solicitações. Black: Todas as solicitações provenientes dos endereços IP ou blocos CIDR definidos no grupo de políticas de controle de acesso selecionado são bloqueadas. Listas negras são aplicáveis a cenários em que você deseja bloquear o acesso de endereços IP específicos. Se uma lista negra estiver ativada, mas nenhum endereço IP for adicionado ao grupo de políticas de controle de acesso, o listener de balanceamento de carga encaminhará todas as solicitações.	White
Certificates	array<object>	A lista de certificados.
	object	A estrutura do certificado.
CertificateId	string	O ID do certificado. Apenas certificados de servidor são suportados.	123157*******
CaCertificates	array<object>	A lista de certificados CA.
	object
CertificateId	string	O ID do certificado CA.	139a00*****
Status	string	O status do certificado.	Associated
IsDefault	boolean	Indica se o certificado é o certificado padrão. Valores válidos: true: Sim. false: Não.	true
CaEnabled	boolean	Indica se a autenticação mútua está ativada. Valores válidos: true: Sim. false: Não.	false
DefaultActions	array<object>	A lista de ações de regra padrão.
	array<object>	A estrutura da ação de regra padrão.
ForwardGroupConfig	object	A configuração da ação de encaminhamento. Este parâmetro é válido quando o tipo é ForwardGroup.
ServerGroupTuples	array<object>	Os grupos de servidores de destino para os quais as solicitações são encaminhadas.
	object	Os grupos de servidores de destino para os quais as solicitações são encaminhadas.
ServerGroupId	string	O ID do grupo de servidores de destino para o qual as solicitações são encaminhadas.	sgp-i5qt20******
Type	string	O tipo de ação. Valores válidos: ForwardGroup, que indica que as solicitações são encaminhadas para múltiplos grupos de servidores.	ForwardGroup
GzipEnabled	boolean	Indica se a compressão Gzip está ativada para compactar tipos específicos de arquivos. Valores válidos: true: Sim. false: Não.	true
Http2Enabled	boolean	Indica se o HTTP/2 está ativado. Valores válidos: true: Sim. false: Não. Nota Apenas listeners HTTPS suportam este parâmetro.	true
IdleTimeout	integer	O período de tempo limite de conexão ociosa. Unidade: segundos. Se nenhuma solicitação de acesso for recebida dentro do período de tempo limite, a instância de balanceamento de carga interrompe temporariamente a conexão atual e restaura a conexão quando a próxima solicitação chegar.	2
ListenerDescription	string	O nome personalizado do listener.	HTTP_80
ListenerId	string	O ID do listener.	lsn-o4u54y73wq7b******
ListenerPort	integer	A porta de frontend usada pela instância de balanceamento de carga.	80
ListenerProtocol	string	O protocolo do listener. Valores válidos: HTTP, HTTPS e QUIC.	HTTP
ListenerStatus	string	O status do listener. Valores válidos: Provisioning: O listener está sendo criado. Running: O listener está em execução. Configuring: O listener está sendo configurado. Stopped: O listener está parado.	Running
LoadBalancerId	string	O ID da instância de balanceamento de carga.	alb-bd6oylbckp6k9x****
LogConfig	object	As informações de configuração de log.
AccessLogRecordCustomizedHeadersEnabled	boolean	Indica se os logs de acesso contêm campos de cabeçalho personalizados. Valores válidos: true: Sim. false: Não.	true
AccessLogTracingConfig	object	As informações de configuração Xtrace para logs de acesso.
TracingEnabled	boolean	O status do recurso Xtrace. Valores válidos: true: Sim. false: Não. Nota Este parâmetro pode ser definido como true apenas quando a opção de log de acesso da instância (AccessLogEnabled) estiver ativada.	true
TracingSample	integer	A taxa de amostragem do Xtrace. Valores válidos: 1 a 10000. Nota Este parâmetro entra em vigor apenas quando TracingEnabled está definido como true.	100
TracingType	string	O tipo de Xtrace. Valores válidos: Zipkin. Nota Este parâmetro entra em vigor apenas quando TracingEnabled está definido como true.	Zipkin
QuicConfig	object	As informações de configuração quando o listener QUIC associado está ativado.
QuicListenerId	string	O ID do listener QUIC a ser associado. Este parâmetro é obrigatório quando QuicUpgradeEnabled está definido como true. Este parâmetro é válido apenas para listeners HTTPS. Nota O listener original e o listener QUIC associado devem pertencer à mesma instância ALB, e o listener QUIC não deve ter sido associado anteriormente.	lsn-ek6ad66t****
QuicUpgradeEnabled	boolean	Indica se o upgrade QUIC está ativado. Valores válidos: true: Sim. false: Não. Nota Este parâmetro é válido apenas para listeners HTTPS.	true
RequestId	string	O ID da solicitação.	365F4154-92F6-4AE4-92F8-7FF******
RequestTimeout	integer	O período de tempo limite da solicitação. Unidade: segundos. Se o servidor backend não fornecer uma resposta dentro do período de tempo limite, a instância de load balancer para de aguardar e retorna um código de erro `HTTP 504` ao cliente.	34
SecurityPolicyId	string	A política de segurança. Nota Apenas listeners HTTPS suportam este parâmetro.	tls_cipher_policy_1_1
XForwardedForConfig	object	A configuração do campo XForward.
XForwardedForClientCertClientVerifyAlias	string	O nome do cabeçalho personalizado. Este valor entra em vigor apenas quando XForwardedForClientCertClientVerifyEnabled é definido como true. O valor deve ter de 1 a 40 caracteres e pode conter letras minúsculas de a a z, hifens (-), sublinhados (_) e dígitos. Nota Apenas listeners HTTPS suportam este parâmetro.	test_client-verify-alias_123456
XForwardedForClientCertClientVerifyEnabled	boolean	Indica se o campo de cabeçalho `X-Forwarded-Clientcert-clientverify` é usado para obter o resultado da verificação do certificado de cliente que acessa a instância de load balancer. Valores válidos: true: Sim. false: Não. Nota Apenas listeners HTTPS suportam este parâmetro.	true
XForwardedForClientCertFingerprintAlias	string	O nome do cabeçalho personalizado. Este valor entra em vigor apenas quando XForwardedForClientCertFingerprintEnabled é definido como true. O valor deve ter de 1 a 40 caracteres e pode conter letras minúsculas de a a z, hifens (-), sublinhados (_) e dígitos. Nota Apenas listeners HTTPS suportam este parâmetro.	test_finger-print-alias_123456
XForwardedForClientCertFingerprintEnabled	boolean	Indica se o campo de cabeçalho `X-Forwarded-Clientcert-fingerprint` é usado para obter a impressão digital do certificado de cliente que acessa a instância de load balancer. Valores válidos: true: Sim. false: Não. Nota Apenas listeners HTTPS suportam este parâmetro.	true
XForwardedForClientCertIssuerDNAlias	string	O nome do cabeçalho personalizado. Este valor entra em vigor apenas quando XForwardedForClientCertIssuerDNEnabled é definido como true. O valor deve ter de 1 a 40 caracteres e pode conter letras minúsculas de a a z, hifens (-), sublinhados (_) e dígitos. Nota Apenas listeners HTTPS suportam este parâmetro.	test_issue-dn-alias_123456
XForwardedForClientCertIssuerDNEnabled	boolean	Indica se o campo de cabeçalho `X-Forwarded-Clientcert-issuerdn` é usado para obter as informações do emissor do certificado de cliente que acessa a instância de load balancer. Valores válidos: true: Sim. false: Não. Nota Apenas listeners HTTPS suportam este parâmetro.	true
XForwardedForClientCertSubjectDNAlias	string	O nome do cabeçalho personalizado. Este valor entra em vigor apenas quando XForwardedForClientCertSubjectDNEnabled é definido como true. O valor deve ter de 1 a 40 caracteres e pode conter letras minúsculas de a a z, hifens (-), sublinhados (_) e dígitos. Nota Apenas listeners HTTPS suportam este parâmetro.	test_subject-dn-alias_123456
XForwardedForClientCertSubjectDNEnabled	boolean	Indica se o campo de cabeçalho `X-Forwarded-Clientcert-subjectdn` é usado para obter as informações do proprietário do certificado de cliente que acessa a instância de load balancer. Valores válidos: true: Sim. false: Não. Nota Apenas listeners HTTPS suportam este parâmetro.	true
XForwardedForClientSrcPortEnabled	boolean	Indica se o campo de cabeçalho `X-Forwarded-Client-Port` é usado para obter a porta do cliente que acessa a instância de load balancer. Valores válidos: true: Sim. false: Não. Nota Listeners HTTP e HTTPS suportam este parâmetro.	true
XForwardedForEnabled	boolean	Indica se o campo de cabeçalho `X-Forwarded-For` é usado para obter o endereço IP de origem do cliente. Valores válidos: true (padrão): Sim. false: Não. Nota Se definido como true, XForwardedForProcessingMode assume o valor padrão append e pode ser alterado para remove. Se definido como false, o campo de cabeçalho `X-Forwarded-For` é preservado sem processamento adicional antes que a solicitação seja enviada ao servidor backend. Listeners HTTP e HTTPS suportam este parâmetro.	true
XForwardedForProcessingMode	string	O modo de processamento do campo de cabeçalho `X-Forwarded-For`. Este valor entra em vigor apenas quando XForwardedForEnabled é definido como true. Valores válidos: append (padrão): Anexar. remove: Remover. Nota Se definido como append, o endereço IP do último salto é anexado ao campo de cabeçalho `X-Forwarded-For` antes que a solicitação seja enviada ao servidor backend. Se definido como remove, o cabeçalho `X-Forwarded-For` é removido antes que a solicitação seja enviada ao servidor backend, independentemente de a solicitação conter ou não o campo de cabeçalho `X-Forwarded-For`. Listeners HTTP e HTTPS suportam este parâmetro.	append
XForwardedForProtoEnabled	boolean	Indica se o campo de cabeçalho `X-Forwarded-Proto` é usado para obter o protocolo do listener da instância de load balancer. Valores válidos: true: Sim. false: Não. Nota Listeners HTTP, HTTPS e QUIC suportam este parâmetro.	true
XForwardedForSLBIdEnabled	boolean	Indica se o campo de cabeçalho `SLB-ID` é usado para obter o ID da instância de load balancer. Valores válidos: true: Sim. false: Não. Nota Listeners HTTP, HTTPS e QUIC suportam este parâmetro.	true
XForwardedForSLBPortEnabled	boolean	Indica se o campo de cabeçalho `X-Forwarded-Port` é usado para obter a porta do listener da instância de load balancer. Valores válidos: true: Sim. false: Não. Nota Listeners HTTP, HTTPS e QUIC suportam este parâmetro.	true
XForwardedForClientSourceIpsEnabled	boolean	Indica se o ALB tem permissão para buscar o endereço IP de origem do cliente no campo de cabeçalho X-Forwarded-For. Valores válidos: true: Sim. false: Não. Nota Listeners HTTP e HTTPS suportam este parâmetro.	false
XForwardedForClientSourceIpsTrusted	string	Os endereços IP de proxy confiáveis. O Application Load Balancer (ALB) percorre o cabeçalho `X-Forwarded-For` da direita para a esquerda e seleciona o primeiro endereço IP que não está na lista de IPs confiáveis como o endereço IP de origem do cliente. Este endereço IP é usado para limitação de taxa baseada em IP de origem.	10.1.1.0/24
XForwardedForHostEnabled	boolean	Indica se o campo de cabeçalho `X-Forwarded-Host` é usado para obter o nome de domínio do cliente que acessa a instância de load balancer. Valores válidos: true: Sim. false (padrão): Não. Nota Listeners HTTP, HTTPS e QUIC suportam este parâmetro.	false
Tags	array<object>	As tags.
	object	A estrutura da tag.
Key	string	A chave da tag. A chave da tag pode ter até 128 caracteres e não pode começar com `aliyun` ou `acs:`. Não pode conter `http://` ou `https://`.	env
Value	string	O valor da tag. O valor da tag pode ter até 128 caracteres e não pode começar com `aliyun` ou `acs:`. Não pode conter `http://` ou `https://`.	product

Exemplos

Resposta de sucesso

JSON formato

{
  "AclConfig": {
    "AclRelations": [
      {
        "AclId": "acl-doc****",
        "Status": "Associating"
      }
    ],
    "AclType": "White"
  },
  "Certificates": [
    {
      "CertificateId": "123157*******"
    }
  ],
  "CaCertificates": [
    {
      "CertificateId": "139a00*****",
      "Status": "Associated",
      "IsDefault": true
    }
  ],
  "CaEnabled": false,
  "DefaultActions": [
    {
      "ForwardGroupConfig": {
        "ServerGroupTuples": [
          {
            "ServerGroupId": "sgp-i5qt20******"
          }
        ]
      },
      "Type": "ForwardGroup"
    }
  ],
  "GzipEnabled": true,
  "Http2Enabled": true,
  "IdleTimeout": 2,
  "ListenerDescription": "HTTP_80",
  "ListenerId": "lsn-o4u54y73wq7b******",
  "ListenerPort": 80,
  "ListenerProtocol": "HTTP",
  "ListenerStatus": "Running",
  "LoadBalancerId": "alb-bd6oylbckp6k9x****",
  "LogConfig": {
    "AccessLogRecordCustomizedHeadersEnabled": true,
    "AccessLogTracingConfig": {
      "TracingEnabled": true,
      "TracingSample": 100,
      "TracingType": "Zipkin"
    }
  },
  "QuicConfig": {
    "QuicListenerId": "lsn-ek6ad66t****",
    "QuicUpgradeEnabled": true
  },
  "RequestId": "365F4154-92F6-4AE4-92F8-7FF******",
  "RequestTimeout": 34,
  "SecurityPolicyId": "tls_cipher_policy_1_1",
  "XForwardedForConfig": {
    "XForwardedForClientCertClientVerifyAlias": "test_client-verify-alias_123456",
    "XForwardedForClientCertClientVerifyEnabled": true,
    "XForwardedForClientCertFingerprintAlias": "test_finger-print-alias_123456",
    "XForwardedForClientCertFingerprintEnabled": true,
    "XForwardedForClientCertIssuerDNAlias": "test_issue-dn-alias_123456",
    "XForwardedForClientCertIssuerDNEnabled": true,
    "XForwardedForClientCertSubjectDNAlias": "test_subject-dn-alias_123456",
    "XForwardedForClientCertSubjectDNEnabled": true,
    "XForwardedForClientSrcPortEnabled": true,
    "XForwardedForEnabled": true,
    "XForwardedForProcessingMode": "append",
    "XForwardedForProtoEnabled": true,
    "XForwardedForSLBIdEnabled": true,
    "XForwardedForSLBPortEnabled": true,
    "XForwardedForClientSourceIpsEnabled": false,
    "XForwardedForClientSourceIpsTrusted": "10.1.1.0/24",
    "XForwardedForHostEnabled": false
  },
  "Tags": [
    {
      "Key": "env",
      "Value": "product"
    }
  ]
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
403	Forbidden.LoadBalancer	Authentication is failed for %s.	Falha na autenticação da operação de balanceamento de carga.
404	ResourceNotFound.Listener	The specified resource %s is not found.	O listener não existe.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.