Todos os produtos
Search
Central de documentação

Edge Security Acceleration:ListHttpsApplicationConfigurations

Última atualização: Jun 24, 2026

Consulta várias configurações de aplicativo HTTPS.

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

esa:ListHttpsApplicationConfigurations

list

*Site

acs:esa:{#regionId}:{#accountId}:site/{#SiteId}

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

SiteId

integer

Sim

O ID do site. Você pode obtê-lo chamando a API ListSites.

123456****

ConfigId

integer

Não

O ID da configuração.

3528160969****

ConfigType

string

Não

O tipo de configuração. Você pode usar este parâmetro para consultar configurações globais ou configurações de regra. Valores válidos:

  • global: Consulta configurações globais.

  • rule: Consulta configurações de regra.

Este parâmetro é opcional. Se não for especificado, nenhuma distinção é feita entre configurações globais e de regra.

Valores válidos:

  • rule :

    Configuração de regra.

  • global :

    Configuração global.

global

RuleName

string

Não

O nome da regra. Você pode consultar a regra cujo nome corresponde ao valor especificado.

rule_example

PageNumber

integer

Não

O número da página para consultas paginadas. O valor deve ser maior ou igual a 1.

1

PageSize

integer

Não

O número de entradas por página para consultas paginadas. Valores válidos: 1-500.

20

SiteVersion

integer

Não

O número da versão do site. Para sites com o gerenciamento de versão ativado, você pode usar este parâmetro para especificar a versão do site para a qual a configuração entra em vigor. Valor padrão: versão 0.

1

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Esquema da resposta.

RequestId

string

O ID da solicitação.

0AEDAF20-4DDF-4165-8750-47FF9C1929C9

Configs

array<object>

As configurações do corpo da resposta.

object

ConfigId

integer

O ID da configuração.

395386449776640

SiteVersion

integer

O número da versão da configuração do site. Para sites com o gerenciamento de versão de configuração ativado, você pode usar este parâmetro para especificar a versão do site para a qual a configuração entra em vigor. Valor padrão: versão 0.

1

Sequence

integer

A ordem de execução da regra. Um valor menor indica uma prioridade maior.

1

RuleEnable

string

O interruptor da regra. Este parâmetro não precisa ser definido ao adicionar uma configuração global. Valores válidos:

  • on: Ativado.

  • off: Desativado.

on

Rule

string

O conteúdo da regra, usando expressões condicionais para corresponder às solicitações do usuário. Este parâmetro não precisa ser definido ao adicionar uma configuração global. Existem dois cenários de uso:

  • Corresponder a todas as solicitações recebidas: Defina o valor como true.

  • Corresponder a solicitações especificadas: Defina o valor como uma expressão personalizada, por exemplo: (http.host eq "video.example.com").

(http.host eq \"video.example.com\")

RuleName

string

O nome da regra. Este parâmetro não precisa ser definido ao adicionar uma configuração global.

rule_example

ConfigType

string

O tipo de configuração. Você pode usar este parâmetro para consultar configurações globais ou configurações de regra. Valores válidos:

  • global: Consulta configurações globais.

  • rule: Consulta configurações de regra.

global

HttpsForce

string

Especifica se o HTTPS forçado deve ser ativado. Desativado por padrão. Valores válidos:

  • on: Ativado.

  • off: Desativado.

on

HttpsForceCode

string

O código de status de redirecionamento de HTTPS forçado. Valores válidos:

  • 301

  • 302

  • 307

301

AltSvc

string

O interruptor do recurso Alt-Svc. Desativado por padrão. Valores válidos:

  • on: Ativado.

  • off: Desativado.

on

AltSvcClear

string

Especifica se o cabeçalho Alt-Svc inclui o parâmetro clear. Desativado por padrão. Valores válidos:

  • on: Ativado.

  • off: Desativado.

on

AltSvcPersist

string

Especifica se o cabeçalho Alt-Svc inclui o parâmetro persist. Desativado por padrão. Valores válidos:

  • on: Ativado.

  • off: Desativado.

on

AltSvcMa

string

O período de validade do Alt-Svc em segundos. Valor padrão: 86400 segundos.

86400

Hsts

string

Especifica se o HSTS deve ser ativado. Desativado por padrão. Valores válidos:

  • on: Ativado.

  • off: Desativado.

on

HstsMaxAge

string

O tempo de expiração do HSTS em segundos.

3600

HstsIncludeSubdomains

string

Especifica se os subdomínios devem ser incluídos no HSTS. Desativado por padrão. Valores válidos:

  • on: Ativado.

  • off: Desativado.

on

HstsPreload

string

Especifica se o pré-carregamento do HSTS deve ser ativado. Desativado por padrão. Valores válidos:

  • on: Ativado.

  • off: Desativado.

on

HttpsSniVerify

string

Especifica se a verificação de SNI deve ser ativada. Desativada por padrão. Valores válidos:

  • on: Ativado.

  • off: Desativado.

on

HttpsNoSniDeny

string

Especifica se a negação de solicitações de handshake TLS sem SNI deve ser ativada. Desativada por padrão. Valores válidos:

  • on: Ativado.

  • off: Desativado.

on

HttpsSniWhitelist

string

Especifica a lista de entradas permitidas na lista de permissões de SNI, separadas por espaços.

abc edf

PageNumber

integer

O número da página atual, igual ao parâmetro de solicitação PageNumber.

1

PageSize

integer

O tamanho da página.

10

TotalCount

integer

O número total de registros.

16

TotalPage

integer

O número total de páginas.

2

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "0AEDAF20-4DDF-4165-8750-47FF9C1929C9",
  "Configs": [
    {
      "ConfigId": 395386449776640,
      "SiteVersion": 1,
      "Sequence": 1,
      "RuleEnable": "on",
      "Rule": "(http.host eq \\\"video.example.com\\\")\n",
      "RuleName": "rule_example",
      "ConfigType": "global",
      "HttpsForce": "on",
      "HttpsForceCode": "301",
      "AltSvc": "on",
      "AltSvcClear": "on",
      "AltSvcPersist": "on",
      "AltSvcMa": "86400",
      "Hsts": "on",
      "HstsMaxAge": "3600",
      "HstsIncludeSubdomains": "on",
      "HstsPreload": "on",
      "HttpsSniVerify": "on",
      "HttpsNoSniDeny": "on",
      "HttpsSniWhitelist": "abc edf"
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 16,
  "TotalPage": 2
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InternalException Failed to call the service. Try again later or contact technical support. Failed to call the service. Try again later or contact technical support.
400 InvalidParameter.FunctionName The specified feature does not exist. Specify a valid feature name based on the related documentation. The specified feature does not exist. Specify a valid feature name based on the related documentation.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.