Todos os produtos
Search

Este produto

    Edge Security Acceleration:GetOriginRule

    Central de documentação

    Edge Security Acceleration:GetOriginRule

    Última atualização: Jun 29, 2026

    Consulta as configurações de uma única regra de origem.

    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:GetOriginRule

    get

    *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, que pode ser obtido chamando a operação ListSites.

    3400350********
    ConfigId

    integer

    Sim

    O ID da configuração. Você pode chamar a operação ListSiteRoutes para obter o ID.

    33793140540****

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    Esquema da resposta.

    RequestId

    string

    O ID da solicitação.

    04F0F334-1335-436C-A1D7-6C044FE73368
    ConfigId

    integer

    O ID da configuração.

    352816096987136
    ConfigType

    string

    O tipo de configuração a ser consultado. Valores válidos:

    • global: configurações globais.

    • rule: configurações de regra.

    rule
    SiteVersion

    integer

    O número da versão das configurações. Você pode usar este parâmetro para especificar uma versão do seu site para aplicar as configurações do recurso. Por padrão, a versão 0 é usada.

    1
    Sequence

    integer

    A ordem de execução da regra. Quanto menor o valor, maior a prioridade.

    1
    RuleEnable

    string

    Especifica se a regra deve ser ativada. Você não precisa definir este parâmetro ao adicionar a configuração global. Valores válidos:

    • on

    • off

    on
    Rule

    string

    O conteúdo da regra. Uma expressão condicional é usada para corresponder a uma solicitação do usuário. Você não precisa definir este parâmetro ao adicionar a configuração global. Casos de uso:

    • true: Corresponde a todas as solicitações recebidas.

    • Defina o valor como uma expressão personalizada, por exemplo, (http.host eq "video.example.com"): Corresponde à solicitação especificada.

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

    RuleName

    string

    O nome da regra. Você não precisa definir este parâmetro ao adicionar configurações globais.

    rule_example
    OriginHost

    string

    O cabeçalho Host nas solicitações de origem.

    origin.example.com

    OriginScheme

    string

    O protocolo usado para solicitações de origem. Valores válidos:

    • http: HTTP.

    • https: HTTPS.

    • follow: segue o protocolo usado pelo cliente.

    http
    OriginSni

    string

    O SNI nas solicitações de origem.

    origin.example.com

    DnsRecord

    string

    O nome do host que substitui o nome do host resolvido de uma solicitação recebida.

    test.example.com

    OriginHttpPort

    string

    A porta de origem que é acessada quando o protocolo HTTP é usado para retornar à origem.

    8080
    OriginHttpsPort

    string

    A porta de origem que é acessada quando o protocolo HTTPS é usado para retornar à origem.

    4433
    Range

    string

    Usa solicitações de intervalo para baixar um objeto da origem. Valores válidos:

    • on

    • off

    • force: ativa a busca de origem por intervalo à força.

    on
    OriginMtls

    string

    O switch MTLS. Valores válidos:

    • on

    • off

    on
    OriginVerify

    string

    O switch de verificação de certificado de origem. Valores válidos:

    • on

    • off

    on
    RangeChunkSize

    string

    O tamanho da parte do intervalo. Valores válidos:

    • 512KB

    • 1MB

    • 2MB

    • 4MB

    1MB
    OriginReadTimeout

    string

    O período de tempo limite de leitura (em segundos) na origem.

    10
    Follow302Enable

    string

    O switch de seguimento 302. Valores válidos:

    • on

    • off

    on
    Follow302MaxTries

    string

    O número máximo de tentativas de seguimento 302. Valores válidos: 1 a 5.

    1
    Follow302RetainArgs

    string

    O switch que retém os parâmetros da solicitação original. Valores válidos:

    • on

    • off

    on
    Follow302RetainHeader

    string

    O switch que retém o cabeçalho da solicitação original. Valores válidos:

    • on

    • off

    on
    Follow302TargetHost

    string

    Host de destino.

    test.com

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
  "ConfigId": 352816096987136,
  "ConfigType": "rule",
  "SiteVersion": 1,
  "Sequence": 1,
  "RuleEnable": "on",
  "Rule": "(http.host eq \\\"video.example.com\\\")\n",
  "RuleName": "rule_example",
  "OriginHost": "origin.example.com\n",
  "OriginScheme": "http",
  "OriginSni": "origin.example.com\n",
  "DnsRecord": "test.example.com\n",
  "OriginHttpPort": "8080",
  "OriginHttpsPort": "4433",
  "Range": "on",
  "OriginMtls": "on",
  "OriginVerify": "on",
  "RangeChunkSize": "1MB",
  "OriginReadTimeout": "10",
  "Follow302Enable": "on",
  "Follow302MaxTries": "1",
  "Follow302RetainArgs": "on",
  "Follow302RetainHeader": "on",
  "Follow302TargetHost": "test.com"
}

    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.

    Consulte Códigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de Versão para uma lista completa.