Todos os produtos
Search
Central de documentação

Edge Security Acceleration:Funções para configuração de nome de domínio

Última atualização: Sep 14, 2026

Chame a operação BatchSetDcdnDomainConfigs para configurar recursos em vários nomes de domínio acelerados simultaneamente. Este tópico lista os recursos configuráveis e seus respectivos parâmetros.

Nota

Informações básicas

dynamic

  • Descrição do recurso: configurações relacionadas ao DCDN. Para mais informações, consulte Rules for static and dynamic content acceleration.

  • ID do recurso (FunctionID/FuncId): 46.

  • Descrição dos parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    enable

    String

    Yes

    Ativar aceleração estática:

    • on: ativa o recurso.

    • off: desativa o recurso.

    on

    static_route_type

    String

    No

    Extensões de arquivo para aceleração de conteúdo estático.

    .txt

    static_route_url

    String

    No

    URI para aceleração de conteúdo estático.

    /domain/detail/log.txt

    static_route_path

    String

    No

    Caminho do arquivo para aceleração de conteúdo estático.

    Nota

    Use caracteres curinga, como asterisco () e ponto de interrogação (?), para correspondência aproximada de caminhos de arquivos estáticos. O asterisco () corresponde a zero ou mais caracteres. O ponto de interrogação (?) corresponde a um único caractere.

    /abc/test/*

    dynamic_route_origin

    String

    No

    Política de protocolo de origem para conteúdo dinâmico. Valores válidos:

    • http: o DCDN usa HTTP para solicitar recursos do servidor de origem.

    • https: o DCDN usa HTTPS para solicitar recursos do servidor de origem.

    • follow: o DCDN usa o mesmo protocolo do cliente para solicitar recursos do servidor de origem.

    • follow-port: o DCDN usa o protocolo correspondente à porta do servidor de origem para solicitar recursos.

    Nota

    Se você não definir dynamic_route_origin, o valor padrão follow será usado.

    https

    dynamic_route_round_robin

    String

    No

    Define se o balanceamento de carga deve ser ativado. Valores válidos:

    • on: ativa o recurso.

    • off (padrão): desativa o recurso.

    off

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "static_route_type",
                "argValue": ".txt"
            }, {
                "argName": "static_route_url",
                "argValue": "/domain/detail/log.txt"
            },{
                "argName": "static_route_path",
                "argValue": "/abc/test/*"
            }, {
                "argName": "dynamic_route_origin",
                "argValue": "https"
            }, {
                "argName": "dynamic_route_round_robin",
                "argValue": "off"
            }],
            "functionName": "dynamic"
        }],
        "DomainNames": "example.com"
    }

ipv6

  • Descrição do recurso: configuração de acesso IPv6. Para mais informações, consulte Enable IPv6.

  • ID do recurso (FunctionID/FuncId): 194.

  • Descrição dos parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    switch

    String

    Yes

    Ativar acesso IPv6:

    • on: ativa o recurso.

    • off: desativa o recurso.

    on

    region

    String

    Yes

    Regiões onde você deseja ativar o IPv6. O caractere curinga (*) é suportado.

    Nota
    • Um asterisco (*) indica que o IPv6 está ativado para todas as regiões. Atualmente, é possível ativar o IPv6 apenas para todas as regiões. Se quiser ativar o IPv6 para uma região específica, abra um ticket para solicitar.

    • Se este parâmetro não for definido, o IPv6 será ativado para todas as regiões por padrão.

    *

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "switch",
                "argValue": "on"
            }, {
                "argName": "region",
                "argValue": "*"
            }],
            "functionName": "ipv6"
        }],
        "DomainNames": "example.com"
    }

Configuração de origem

set_req_host_header

  • Descrição do recurso: configura o host de origem. Para mais informações, consulte Configure the default origin host.

  • ID do recurso (FunctionID/FuncId): 18.

  • Descrição dos parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    domain_name

    String

    Yes

    Conteúdo do cabeçalho de host de origem.

    example.com

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "domain_name",
                "argValue": "example.com"
            }],
            "functionName": "set_req_host_header"
        }],
        "DomainNames": "example.com"
    }

forward_scheme

  • Descrição do recurso: configura a política de protocolo de origem. Para mais informações, consulte Configure static protocol follow-up for origin fetch.

  • ID do recurso (FunctionID/FuncId): 47.

  • Descrição dos parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    enable

    String

    Yes

    Define se a política de protocolo de origem deve ser ativada. Valores válidos:

    • on: ativa o recurso.

    • off: desativa o recurso.

    on

    scheme_origin

    String

    No

    Política de protocolo de origem. Valores válidos:

    • http: o DCDN usa HTTP para busca na origem.

    • https: o DCDN usa HTTPS para busca na origem.

    • follow: o DCDN usa o mesmo protocolo da solicitação do cliente para busca na origem.

    Nota

    Se você não definir scheme_origin, o valor padrão follow será usado.

    follow

    scheme_origin_port

    String

    No

    Porta de origem personalizada. Este parâmetro deve ser usado junto com scheme_origin. Valores válidos:

    • Se scheme_origin for definido como http, configure apenas uma porta de origem HTTP. Exemplo: 80.

    • Se scheme_origin for definido como https, configure apenas uma porta de origem HTTPS. Exemplo: 443.

    • Se scheme_origin for definido como follow, configure ambas as portas de origem HTTP e HTTPS. Separe-as com dois pontos (:). Exemplo: 80:443.

    80:443

  • Exemplo de configuração 1: o DCDN usa o mesmo protocolo da solicitação do cliente para busca na origem. A porta de origem é a porta padrão do protocolo. A porta 80 é usada para HTTP e a porta 443 para HTTPS.

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "scheme_origin",
                "argValue": "follow"
            }],
            "functionName": "forward_scheme"
        }],
        "DomainNames": "example.com"
    }
  • Exemplo de configuração 2: o DCDN usa o mesmo protocolo da solicitação do cliente para busca na origem. A porta de origem é personalizada. A porta 8080 é usada para HTTP e a porta 4433 para HTTPS.

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "scheme_origin",
                "argValue": "follow"
            }, {
                "argName": "scheme_origin_port",
                "argValue": "8080:4433"
            }],
            "functionName": "forward_scheme"
        }],
        "DomainNames": "example.com"
    }

l2_oss_key

  • Descrição do recurso: configura a busca na origem a partir de um bucket privado. Nota: na primeira vez que utilizar este recurso, ative a política de acesso padrão com um único clique. Após ativar a política, o DCDN recebe acesso somente leitura a todos os buckets do OSS pertencentes à sua conta Alibaba Cloud. Para mais informações, consulte Origin fetch from a private OSS bucket.

  • ID do recurso (FunctionID/FuncId): 85.

  • Descrição dos parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    private_oss_auth

    String

    Yes

    Define se a busca na origem a partir de bucket privado deve ser ativada. Valores válidos:

    • on: ativa o recurso.

    • off: desativa o recurso.

    Ao ativar este recurso, o sistema configura automaticamente um token do Security Token Service (STS), simplificando o processo. No entanto, esse método suporta busca na origem apenas em buckets privados do OSS que pertençam à mesma conta Alibaba Cloud do nome de domínio acelerado pelo DCDN. Para mais informações sobre tokens STS, consulte STS overview.

    on

    perm_private_oss_tbl

    String

    No

    Configuração do token de segurança permanente. O formato é access_id=123 access_secret=123abc. Separe os parâmetros com um espaço.

    Após configurar um token de segurança permanente, é possível realizar a busca na origem tanto em buckets privados do OSS pertencentes à mesma conta Alibaba Cloud do domínio acelerado pelo DCDN quanto em buckets de outra conta Alibaba Cloud. Para mais informações sobre tokens de segurança permanentes, consulte Create an AccessKey.

    access_id=123 access_secret=123abc

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "private_oss_auth",
                "argValue": "on"
            },{
                "argName": "perm_private_oss_tbl",
                "argValue": "access_id=123 access_secret=123abc"
            }],
            "functionName": "l2_oss_key"
        }],
        "DomainNames": "example.com"
    }

oss_key_list

  • Descrição do recurso: lista de chaves privadas para busca na origem no OSS. Configure uma ou mais regras para especificar múltiplos buckets privados do OSS e seus respectivos tokens de segurança.

  • ID do recurso (FunctionID/FuncId): 183.

  • Descrição dos parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    host

    String

    Yes

    Endereço completo do bucket do OSS.

    example.oss-cn-hangzhou.aliyuncs.com

    key

    String

    Yes

    Configuração do token de segurança permanente. O formato é access_id=123 access_secret=123abc. Separe os parâmetros com um espaço.

    Após configurar um token de segurança permanente, é possível realizar a busca na origem tanto em buckets privados do OSS pertencentes à mesma conta Alibaba Cloud do domínio acelerado pelo DCDN quanto em buckets de outra conta Alibaba Cloud. Para mais informações sobre tokens de segurança permanentes, consulte Create an AccessKey.

    access_id=123 access_secret=123abc

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "host",
                "argValue": "example.oss-cn-hangzhou.aliyuncs.com"
            },{
                "argName": "key",
                "argValue": "access_id=123 access_secret=123abc"
            }],
            "functionName": "oss_key_list"
        }],
        "DomainNames": "example.com"
    }

https_origin_sni

  • Descrição do recurso: configura o SNI de origem. Defina um SNI de origem específico para um servidor de origem específico. Para mais informações, consulte Configure a specific origin SNI.

  • ID do recurso (FunctionID/FuncId): 114.

  • Descrição dos parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    enabled

    String

    Yes

    Define se o recurso de SNI de origem deve ser ativado. Valores válidos:

    • on: ativa o recurso.

    • off: desativa o recurso.

    on

    https_origin_sni

    String

    Yes

    Informações SNI transportadas na solicitação de origem. Trata-se do endereço do servidor de origem que a solicitação precisa acessar.

    origin.example.com

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "https_origin_sni",
                "argValue": "origin.example.com"
            }, {
                "argName": "enabled",
                "argValue": "on"
            }],
            "functionName": "https_origin_sni"
        }],
        "DomainNames": "example.com"
    }

forward_timeout

  • Descrição do recurso: configura o tempo limite da solicitação de origem. Para mais informações, consulte Origin request timeout.

  • ID do recurso (FunctionID/FuncId): 124.

  • Descrição dos parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    forward_timeout

    Integer

    Yes

    Período de tempo limite da solicitação. Unidade: segundos.

    Nota

    Recomendamos definir o tempo limite como inferior a 100 segundos.

    30

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "forward_timeout",
                "argValue": "30"
            }],
            "functionName": "forward_timeout"
        }],
        "DomainNames": "example.com"
    }

advanced_origin

  • Descrição do recurso: configura a origem avançada. Para mais informações, consulte Advanced origin. Este recurso está disponível apenas para usuários incluídos na lista de permissões. Para utilizá-lo, abra um ticket.

  • Conflito de recursos: o recurso de origem avançada entra em conflito com o recurso de origem condicional (função: origin_dns_host, ID do recurso: 212). Ative apenas um deles. Se um dos recursos já estiver configurado, exclua sua configuração antes de configurar o outro. Um recurso é considerado configurado mesmo que seu parâmetro switch esteja definido como off. Chame a operação DeleteDcdnSpecificConfig para excluir uma configuração específica de um nome de domínio.

  • ID do recurso (FunctionID/FuncId): 235.

  • Descrição dos parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    variable_type

    String

    Yes

    Tipo da variável. Valores válidos:

    • header: cabeçalho de solicitação transportado na solicitação do usuário.

    • arg: parâmetro de string de consulta transportado na URL da solicitação do usuário.

    • uri: caminho transportado na URL da solicitação do usuário.

    • cookie: cookie de solicitação transportado na solicitação do usuário.

    uri

    variable

    String

    Yes

    Nome da variável.

    Nota

    Se variable_type for definido como uri, defina variable como uri.

    uri

    conditions

    String

    Yes

    Condição. Valores válidos:

    • ==: igual a.

    • !=: diferente de.

    ==

    value

    String

    Yes

    Valor da variável.

    /image

    origin

    String

    Yes

    Nome de domínio usado para consulta DNS durante a busca na origem. Corresponde ao valor da variável na solicitação do usuário. Se houver correspondência, a solicitação será redirecionada para a URL de origem especificada.

    origin.example.com

  • Exemplo de configuração:

    {
     "Functions": [{
      "functionArgs": [{
       "argName": "conditions",
       "argValue": "=="
      }, {
       "argName": "variable_type",
       "argValue": "uri"
      }, {
       "argName": "value",
       "argValue": "/image"
      }, {
       "argName": "origin",
       "argValue": "origin.example.com"
      }, {
       "argName": "variable",
       "argValue": "uri"
      }],
      "functionName": "advanced_origin"
     }],
     "DomainNames": "example.com",
    }

follow_302

  • Descrição do recurso: Configura o redirecionamento 302 para requisições de origem. Para mais informações, consulte Configure 301/302 redirects for origin fetch. Este recurso está disponível apenas para usuários incluídos na lista de permissões. Para utilizá-lo, envie um ticket.

  • ID do recurso (FunctionID/FuncId): 219.

  • Descrição dos parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    enable

    String

    Yes

    Define se o redirecionamento 302 para requisições de origem deve ser ativado. Valores válidos:

    • on: ativa o recurso.

    • off: desativa o recurso.

    on

    max_tries

    Integer

    No

    Número máximo de redirecionamentos 302.

    • Valor padrão: 2.

    • Valores válidos: [1,5].

    Nota

    O número de requisições de origem menos 1 equivale ao número de redirecionamentos 302. Isso significa que o número máximo padrão de requisições de origem é 3, e o intervalo válido é [2,6].

    2

    retain_args

    String

    No

    Indica se os parâmetros da requisição original devem ser mantidos ao redirecionar para o servidor de origem de destino. Valores válidos:

    • on: mantém os parâmetros.

    • off (padrão): não mantém os parâmetros.

    off

    retain_header

    String

    No

    Determina se o cabeçalho da requisição original será preservado durante o redirecionamento para o servidor de origem de destino. Valores válidos:

    • On: Preserva.

    • off (padrão): não preserva o cabeçalho.

    off

    response_header

    String

    No

    Cabeçalho de resposta do redirecionamento 302. Refere-se ao nome do cabeçalho de resposta de redirecionamento 302 que o servidor de origem envia para o DCDN. O nome padrão do cabeçalho é Location.

    X-Alicdn-Redirect

    retain_host

    String

    No

    Mantém o nome de domínio de origem para redirecionamentos 302. Quando ativado, o DCDN preserva o nome de domínio de origem durante um redirecionamento 302. Essa configuração só tem efeito ao redirecionar para o nome de domínio de destino. Valores válidos:

    • on: ativa o recurso.

    • off (padrão): desativa o recurso.

    off

    modify_host

    String

    No

    Modifica o nome de domínio de origem para redirecionamentos 302. O DCDN altera o nome de domínio de origem durante um redirecionamento 302. Essa configuração só tem efeito ao redirecionar para o nome de domínio de destino. Por padrão, o nome de domínio de origem não é modificado.

    example.com

    cache

    String

    No

    Armazena em cache o resultado do redirecionamento 302. Quando ativado, o DCDN faz cache do resultado de redirecionamento para a mesma URL durante um redirecionamento 302, melhorando o desempenho de resposta do DCDN. Valores válidos:

    • on: ativa o recurso.

    • off (padrão): desativa o recurso.

    off

    expired_time

    Integer

    No

    Tempo limite para armazenamento em cache do resultado do redirecionamento 302. Define por quanto tempo o DCDN armazena em cache o resultado de redirecionamento para a mesma URL durante um redirecionamento 302. Este parâmetro deve ser usado junto com o recurso de cache. Unidade: segundos. Valor padrão: 3600.

    7200

    follow_origin_host

    String

    No

    Usa o nome de domínio de origem como host de origem para redirecionamentos 302. Quando ativado, o DCDN utiliza o nome de domínio de origem como host de origem. O nome de domínio de origem mais recente é utilizado mesmo após um failover entre servidores primário e secundário. Valores válidos:

    • on: ativa o recurso.

    • off (padrão): desativa o recurso.

    off

    follow_5xx_retry_origin

    String

    No

    Failover entre servidores de origem primário e secundário. Quando ativado, o DCDN muda para o próximo servidor de origem disponível caso receba um código de status 5xx do servidor de origem atual. Valores válidos:

    • on: ativa o recurso.

    • off (padrão): desativa o recurso.

    off

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "max_tries",
                "argValue": 2
            }, {
                "argName": "retain_args",
                "argValue": "off"
            }, {
                "argName": "retain_header",
                "argValue": "off"
            }, {
                "argName": "response_header",
                "argValue": "X-Alicdn-Redirect"
            }, {
                "argName": "retain_host",
                "argValue": "off"
            }, {
                "argName": "modify_host",
                "argValue": "example.com"
            }, {
                "argName": "cache",
                "argValue": "off"
            }, {
                "argName": "expired_time",
                "argValue": "7200"
            }, {
                "argName": "follow_origin_host",
                "argValue": "off"
            }, {
                "argName": "follow_5xx_retry_origin",
                "argValue": "off"
            }],
            "functionName": "follow_302"
        }],
        "DomainNames": "example.com"
    }
    

set_req_header

  • Descrição do recurso: Configura um cabeçalho HTTP de origem personalizado. Para mais informações, consulte Modify inbound request headers.

    Nota

    set_req_header é a versão v1. Recomendamos o uso da versão v2, origin_request_header. A versão v2 oferece suporte a mais recursos para cabeçalhos HTTP de origem personalizados.

  • ID do recurso (FunctionID/FuncId): 39.

  • Descrição dos parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    key

    String

    Yes

    Nome do cabeçalho de origem.

    Accept-Encoding

    value

    String

    Yes

    Valor do cabeçalho de origem. Para excluir um cabeçalho de origem, defina seu valor como null.

    gzip

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "value",
                "argValue": "gzip"
            }, {
                "argName": "key",
                "argValue": "Accept-Encoding"
            }],
            "functionName": "set_req_header"
        }],
        "DomainNames": "example.com"
    }

origin_request_header

  • Descrição do recurso: Configura cabeçalhos de requisição HTTP de origem (novo). Para mais informações, consulte Configure origin HTTP request headers. Este recurso está disponível apenas para usuários incluídos na lista de permissões. Para utilizá-lo, envie um ticket.

  • ID do recurso (FunctionID/FuncId): 228.

  • Descrição dos parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    header_operation_type

    String

    Yes

    Operação a ser realizada no cabeçalho da requisição. Valores válidos:

    • add: Adiciona uma nova entrada.

    • delete: exclui.

    • Modify

    • Use replace em vez de rewrite.

    add

    header_name

    String

    Yes

    Nome do cabeçalho da requisição.

    Accept-Encoding

    header_value

    String

    No

    Valor do cabeçalho da requisição. É possível configurar vários valores para um parâmetro de cabeçalho de requisição. Separe múltiplos valores com vírgulas (,).

    gzip

    duplicate

    String

    No

    Define se é permitido adicionar um cabeçalho de requisição com o mesmo nome. Se você definir header_operation_type como add, deverá especificar se duplicatas são permitidas. Valores válidos:

    • On: Permitir.

    • Off: Desativado.

    off

    header_source

    String

    No

    Valor do parâmetro a ser substituído. Se você definir header_operation_type como rewrite, este parâmetro é obrigatório. Expressões regulares são suportadas.

    value1

    header_destination

    String

    No

    Novo valor do parâmetro. Se você definir header_operation_type como rewrite, este parâmetro é obrigatório.

    value123

    match_all

    String

    No

    Modo de correspondência. Se você definir header_operation_type como rewrite, o modo de correspondência deve ser configurado. Valores válidos:

    • on: corresponde a todos os valores. Todos os valores correspondidos são substituídos.

    • off: corresponde apenas ao primeiro valor. Somente o primeiro valor correspondido é substituído.

    off

  • Exemplo de configuração: Adiciona um cabeçalho de requisição de origem personalizado ao nome de domínio acelerado example.com. O nome do cabeçalho da requisição é definido como Accept-Encoding e o valor do cabeçalho da requisição é definido como gzip.

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "header_operation_type",
                "argValue": "add"
            }, {
                "argName": "header_name",
                "argValue": "Accept-Encoding"
            }, {
                "argName": "header_value",
                "argValue": "gzip"
            }, {
                "argName": "duplicate",
                "argValue": "off"
            }],
            "functionName": "origin_request_header"
        }],
        "DomainNames": "example.com"
    }

origin_response_header

  • Descrição do recurso: Configura cabeçalhos de resposta HTTP de origem. Para mais informações, consulte Modify inbound response headers. Este recurso está disponível apenas para usuários incluídos na lista de permissões. Para utilizá-lo, envie um ticket.

  • ID do recurso (FunctionID/FuncId): 229.

  • Descrição dos parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    header_operation_type

    String

    Yes

    Operação do cabeçalho de resposta. Valores válidos:

    • add: Adiciona um item.

    • Delete: Exclui o item.

    • To modify is to make a change.

    • Replace.

    add

    header_name

    String

    Yes

    Nome do cabeçalho de resposta.

    Cache-Control

    header_value

    String

    No

    Valor do cabeçalho de resposta. É possível configurar vários valores para um parâmetro de cabeçalho de resposta. Separe múltiplos valores com vírgulas (,).

    no-cache

    duplicate

    String

    No

    Define se é permitido adicionar um cabeçalho de resposta com o mesmo nome. Se você definir header_operation_type como add, deverá especificar se duplicatas são permitidas. Valores válidos:

    • on: permite duplicatas.

    • off: não permite duplicatas.

    off

    header_source

    String

    No

    Valor do parâmetro a ser substituído. Se você definir header_operation_type como rewrite, este parâmetro é obrigatório. Expressões regulares são suportadas.

    value1

    header_destination

    String

    No

    Novo valor do parâmetro. Se você definir header_operation_type como rewrite, este parâmetro é obrigatório.

    value123

    match_all

    String

    No

    Modo de correspondência. Se você definir header_operation_type como rewrite, o modo de correspondência deve ser configurado. Valores válidos:

    • on: corresponde a todos os valores. Todos os valores correspondidos são substituídos.

    • off: corresponde apenas ao primeiro valor. Somente o primeiro valor correspondido é substituído.

    off

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "header_operation_type",
                "argValue": "add"
            }, {
                "argName": "header_name",
                "argValue": "Cache-Control"
            }, {
                "argName": "header_value",
                "argValue": "no-cache"
            }, {
                "argName": "duplicate",
                "argValue": "off"
            }],
            "functionName": "origin_response_header"
        }],
        "DomainNames": "example.com"
    }

back_to_origin_url_rewrite

  • Descrição do recurso: Reescreve a URI de origem. Para mais informações, consulte Rewrite the origin URI. Este recurso está disponível apenas para usuários incluídos na lista de permissões. Para utilizá-lo, envie um ticket.

  • ID do recurso (FunctionID/FuncId): 225.

  • Descrição dos parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    source_url

    String

    Yes

    URI a ser reescrita.

    ^/hello$

    target_url

    String

    Yes

    URI de destino.

    /hello/test

    flag

    String

    No

    Regra de execução para a operação de reescrita. Valores válidos:

    • Vazio: Se este parâmetro não for definido, as regras de reescrita subsequentes continuarão a ser executadas após a execução da regra atual.

    • break: Após a execução da regra atual, nenhuma outra regra de reescrita subsequente será executada.

    • enhance_break: Semelhante ao break, mas processa a requisição com parâmetros e também tem efeito para streams ao vivo FLV.

    break

    sequence

    Integer

    No

    Prioridade da configuração. Valores válidos: 1 a 99. Um valor menor indica maior prioridade. Se este parâmetro não for especificado, os valores serão atribuídos automaticamente em ordem crescente a partir de 1.

    1

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "flag",
                "argValue": "break"
            }, {
                "argName": "source_url",
                "argValue": "^/hello$"
            }, {
                "argName": "target_url",
                "argValue": "/hello/test"
            }],
            "functionName": "back_to_origin_url_rewrite"
        }],
        "DomainNames": "example.com",
    }

back_to_origin_argument_rewrite

  • Descrição do recurso: Reescreve parâmetros de origem. Para mais informações, consulte Rewrite origin parameters. Este recurso está disponível apenas para usuários incluídos na lista de permissões. Para utilizá-lo, envie um ticket.

    Nota

    A reescrita de parâmetros de origem modifica os parâmetros de consulta da URL de requisição de origem. É possível configurar várias regras de reescrita. A prioridade das ações de reescrita segue a seguinte ordem: Add > Delete > Reserve Only > Modify. Se diferentes regras de reescrita se aplicarem ao mesmo parâmetro, apenas a regra com a maior prioridade terá efeito.

  • ID do recurso (FunctionID/FuncId): 224.

  • Descrição dos parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    delete_argument

    String

    No

    Lista de parâmetros a serem excluídos. Separe múltiplos parâmetros com espaços.

    code1

    save_argument

    String

    No

    Lista de parâmetros a serem mantidos. Separe múltiplos parâmetros com espaços. Apenas os parâmetros listados serão retidos. As ações de adicionar e excluir parâmetros ainda terão efeito.

    Empty

    ignore_all_argument

    String

    No

    Define se todos os parâmetros devem ser ignorados. Valores válidos:

    • on: ignora todos os parâmetros. Apenas o recurso de adicionar parâmetro permanece efetivo. Os recursos de excluir, manter apenas e modificar parâmetro tornam-se ineficazes.

    • off (padrão): não ignora todos os parâmetros. Os recursos de manter, adicionar e excluir parâmetro permanecem efetivos.

    on

    add_argument

    String

    No

    Parâmetros a serem adicionados. Possui a maior prioridade. Separe múltiplos parâmetros com espaços.

    value=123

    modify_argument

    String

    No

    Parâmetros a serem modificados. Possui a menor prioridade. Se um parâmetro for excluído, ele não será mantido. Separe múltiplos parâmetros com espaços.

    value=321

    enable

    String

    Yes

    Define se a reescrita de parâmetros de origem deve ser ativada. Valores válidos:

    • on: ativa o recurso.

    • off: desativa o recurso.

    on

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "delete_argument",
                "argValue": ""
            }, {
                "argName": "save_argument",
                "argValue": ""
            }, {
                "argName": "add_argument",
                "argValue": ""
            }, {
                "argName": "modify_argument",
                "argValue": ""
            }, {
                "argName": "ignore_all_argument",
                "argValue": "on"
            }, {
                "argName": "enable",
                "argValue": "on"
            }],
            "functionName": "back_to_origin_argument_rewrite"
        }],
        "DomainNames": "example.com"
    }

aws_s3_bucket

  • Descrição do recurso: configura um bucket do Amazon S3 para assinatura. Este recurso está disponível apenas para usuários adicionados à lista de permissões. Para utilizá-lo, envie um ticket.

  • ID do recurso (FunctionID/FuncId): 186.

  • Descrição dos parâmetros:

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo

    enabled

    String

    Sim

    Ativa a autenticação do bucket do Amazon S3:

    • l2: ativa o recurso.

    • off: desativa o recurso.

    l2

    bucketname

    String

    Não

    Nome do bucket do Amazon S3.

    /

    accesskey

    String

    Sim

    AccessKey da AWS.

    123456789

    secretkey

    String

    Sim

    SecretKey da AWS.

    12345678

    region

    String

    Sim

    Região de armazenamento do Amazon S3.

    us-east-2

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enabled",
                "argValue": "l2"
            }, {
                "argName": "accesskey",
                "argValue": "123456789"
            }, {
                "argName": "secretkey",
                "argValue": "123456789"
            }, {
                "argName": "region",
                "argValue": "us-east-2"
            }],
            "functionName": "aws_s3_bucket"
        }],
        "DomainNames": "example.com"
    }

origin_certificate_verification

  • Descrição do recurso: configura a verificação de certificado de origem (lista de permissões de SNI). Para mais informações, consulte Configure a Common Name whitelist. Este recurso está disponível apenas para usuários adicionados à lista de permissões. Para utilizá-lo, envie um ticket.

  • ID do recurso (FunctionID/FuncId): 223.

  • Descrição dos parâmetros:

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo

    enabled

    String

    Sim

    Define se a verificação de certificado de origem deve ser ativada. Valores válidos:

    • on: ativa o recurso.

    • off: desativa o recurso.

    on

    common_name_whitelist

    String

    Não

    Lista de nomes de domínio permitidos para o certificado. É possível configurar vários nomes de domínio separados por vírgulas (,). Certificados correspondentes a esses domínios na lista de permissões serão aprovados na verificação.

    example.com

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "common_name_whitelist",
                "argValue": "example.com"
            }],
            "functionName": "origin_certificate_verification"
        }],
        "DomainNames": "example.com"
    }

origin_dns_host

  • Descrição do recurso: configura uma origem condicional. Utilize este recurso em conjunto com o mecanismo de regras (função: condition, ID do recurso: 250) para redirecionar solicitações a um servidor de origem específico com base em informações como caminho, parâmetros de URL e cabeçalhos de requisição do usuário. Este recurso está disponível apenas para usuários adicionados à lista de permissões. Para utilizá-lo, envie um ticket.

  • Pré-requisitos: antes de configurar uma origem condicional, crie pelo menos uma condição de regra no mecanismo de regras. Ao configurar a origem condicional, associe-a a uma condição de regra. Para mais informações, consulte Rules engine. Caso não associe a configuração da origem condicional a uma condição de regra, todo o tráfego de origem do DCDN será direcionado para essa única URL de origem, anulando o propósito de controlar a URL de origem por meio de condições de regra.

  • Conflito de recursos: o recurso de origem condicional entra em conflito com o recurso de origem avançada (função: advanced_origin, ID do recurso: 235). Ative apenas um deles. Se um dos recursos já estiver configurado, exclua sua configuração antes de configurar o outro. Um recurso é considerado configurado mesmo que seu parâmetro de ativação esteja definido como off. Chame a operação DeleteDcdnSpecificConfig para excluir uma configuração específica de um nome de domínio.

  • ID do recurso (FunctionID/FuncId): 212.

  • Descrição dos parâmetros:

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo

    ali_origin_dns_host

    String

    Sim

    Nome de domínio usado para consulta DNS durante a busca na origem.

    example.com

  • Exemplo de configuração: defina parentid para referenciar uma condição de regra criada previamente com o mecanismo de regras (função: condition, ID do recurso: 250). A referência é feita por meio do configid gerado quando a configuração foi adicionada. Isso garante que, quando uma solicitação de usuário corresponder a essa condição de regra, ela será redirecionada para a URL de origem especificada.

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "ali_origin_dns_host",
                "argValue": "example.com"
            }],
            "functionName": "origin_dns_host",
            "parentId":30119730104****
        }],
        "DomainNames": "example.com"
    }

origin_host

  • Descrição do recurso: configura o host de origem para um servidor de origem específico. Defina um host de origem distinto para cada servidor de origem desejado. Este recurso está disponível apenas para usuários adicionados à lista de permissões. Para utilizá-lo, envie um ticket.

  • ID do recurso (FunctionID/FuncId): 242.

  • Descrição dos parâmetros:

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo

    origin

    String

    Sim

    URL específica da origem. Também é possível deixar esse campo indefinido definindo o parâmetro origin como all, que representa todos os servidores de origem.

    example.com

    host

    String

    Sim

    Host específico. Alternativamente, deixe este campo indefinido definindo o parâmetro host como ali_follow_origin, o que significa que o valor do host segue a URL de origem.

    host.example.com

  • Exemplo de configuração 1: quando uma solicitação de usuário for redirecionada ao servidor de origem example.com, o valor de host utilizado será host.example.com.

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "origin",
                "argValue": "example.com"
            }, {
                "argName": "host",
                "argValue": "host.example.com"
            }],
            "functionName": "origin_host"
        }],
        "DomainNames": "example.com"
    }
  • Exemplo de configuração 2: solicitações de usuário redirecionadas a todos os servidores de origem (representados por all) usam o mesmo valor de host: host.example.com.

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "origin",
                "argValue": "all"
            }, {
                "argName": "host",
                "argValue": "host.example.com"
            }],
            "functionName": "origin_host"
        }],
        "DomainNames": "example.com"
    }
  • Exemplo de configuração 3: para solicitações de usuário redirecionadas a todos os servidores de origem (representados por all), o valor de host segue a URL de origem (representado por ali_follow_origin).

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "origin",
                "argValue": "all"
            }, {
                "argName": "host",
                "argValue": "ali_follow_origin"
            }],
            "functionName": "origin_host"
        }],
        "DomainNames": "example.com"
    }

ali_origin_port_scheme

  • Descrição do recurso: configura a porta e o protocolo de origem. Este recurso está disponível apenas para usuários adicionados à lista de permissões. Para utilizá-lo, envie um ticket.

  • ID do recurso (FunctionID/FuncId): 276.

  • Descrição dos parâmetros:

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo

    port

    String

    Sim

    Porta de origem.

    Nota

    Se você definir scheme como follow, use o formato http:80|https:443.

    80

    scheme

    String

    Sim

    Protocolo de origem. Personalize o protocolo de origem conforme necessário. Valores válidos: http, https, follow, https_sm e follow_sm.

    • http: a busca na origem ocorre via HTTP.

    • https: a busca na origem ocorre via HTTPS com algoritmo internacional.

    • follow: o Alibaba Cloud CDN segue o protocolo (HTTP ou HTTPS) utilizado pelos clientes. Quando o protocolo HTTPS é usado, apenas o algoritmo Rivest-Shamir-Adleman (RSA) é suportado.

      • Se o cliente usar HTTP, a busca na origem também usará HTTP.

      • O cliente se comunica usando o protocolo HTTPS.

        • Se o cliente usar um algoritmo internacional, a busca na origem usará HTTPS com algoritmo internacional.

        • Se o cliente usar um algoritmo criptográfico chinês, a busca na origem usará HTTPS com algoritmo internacional.

    • https_sm: a busca na origem ocorre via HTTPS com algoritmo criptográfico chinês.

    • follow_sm: o serviço segue o protocolo (HTTP ou HTTPS) utilizado pelos clientes. Tanto os algoritmos RSA quanto SM são suportados.

      • O cliente usa o protocolo HTTP para busca na origem.

      • O cliente usa o protocolo HTTPS.

        • Se o cliente usar um algoritmo internacional, a busca na origem usará HTTPS com algoritmo internacional.

        • Se o cliente usar um algoritmo criptográfico chinês, a busca na origem usará HTTPS com algoritmo criptográfico chinês.

    Nota

    Algoritmos internacionais são padrões globais de criptografia. Algoritmos criptográficos chineses são padrões domésticos certificados pela Administração Estatal de Criptografia da China.

    http

  • Exemplo de configuração 1: define o protocolo de origem como http e a porta de origem como 80.

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "port",
                "argValue": "80"
            }, {
                "argName": "scheme",
                "argValue": "http"
            }],
            "functionName": "ali_origin_port_scheme"
        }],
        "DomainNames": "example.com"
    }
  • Exemplo de configuração 2: o protocolo de origem segue o protocolo usado na solicitação do usuário. Quando a busca na origem ocorre via HTTP, a solicitação é redirecionada para a porta 80 do servidor de origem. Quando a busca ocorre via HTTPS, a solicitação é redirecionada para a porta 443 do servidor de origem.

    {
    "Functions":[{
    "functionArgs": [{
    "argName": "port",
    "argValue": "http:80|https:443"
      }, {
    "argName": "scheme",
    "argValue": "follow"
      }],
      "functionName":"ali_origin_port_scheme"
    }],
      "DomainNames":"example.com"
    }

origin_sni

  • Descrição do recurso: configura um SNI de origem específico. É possível definir um SNI de origem para um servidor de origem específico. Para obter mais informações, consulte Configure a specific origin SNI. Este recurso está disponível apenas para usuários incluídos na lista de permissões. Para utilizá-lo, envie um ticket.

  • ID do recurso (FunctionID/FuncId): 262.

  • Descrição dos parâmetros:

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo

    origin

    String

    Sim

    A URL de origem. Também é possível deixar este campo sem especificação definindo o parâmetro origin como all.

    example.com

    sni_host

    String

    Sim

    O valor do host SNI:

    • Defina como um campo estático, como example.org.

    • Para usar a URL de origem como SNI, defina como ali_follow_origin.

    • Para usar o host de origem como SNI, defina como ali_follow_host.

    example.org

    keepalive_sni

    String

    Não

    Especifica se deve ativar a correspondência de SNI para conexões persistentes. Valores válidos:

    • on: ativa o recurso.

    • off: desativa o recurso.

    Nota

    Se você ativar este recurso, diferentes conexões persistentes serão usadas para diferentes SNIs de origem.

    /

  • Exemplo de configuração 1: quando uma solicitação de usuário é redirecionada para o servidor de origem origin.example.com, o valor SNI utilizado é host.example.com.

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "origin",
                "argValue": "origin.example.com"
            }, {
                "argName": "sni_host",
                "argValue": "host.example.com"
            }],
            "functionName": "origin_sni"
        }],
        "DomainNames": "example.com"
    }
  • Exemplo de configuração 2: solicitações de usuário redirecionadas para todos os servidores de origem (representados por all) usam o mesmo valor SNI host.example.com.

    {
    "Functions": [{
    "functionArgs": [{
    "argName": "origin",
    "argValue": "all"
      }, {
    "argName": "sni_host",
    "argValue": "host.example.com"
    }],
    "functionName":"origin_sni"
     }],
     "DomainNames":"example.com"
    }
  • Exemplo de configuração 3: para solicitações de usuário redirecionadas para todos os servidores de origem (representados por all), o valor SNI segue a URL de origem (representada pelo valor do parâmetro ali_follow_origin).

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "origin",
                "argValue": "all"
            }, {
                "argName": "sni_host",
                "argValue": "ali_follow_origin"
            }],
            "functionName": "origin_sni"
        }],
        "DomainNames": "example.com"
    }
  • Exemplo de configuração 4: para solicitações de usuário redirecionadas para todos os servidores de origem (representados por all), o valor SNI segue o host de origem (representado pelo valor do parâmetro ali_follow_host).

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "origin",
                "argValue": "all"
            }, {
                "argName": "sni_host",
                "argValue": "ali_follow_host"
            }],
            "functionName": "origin_sni"
        }],
        "DomainNames": "example.com"
    }

source_group

  • Descrição do recurso: configura as definições do grupo de origens. Este recurso está disponível apenas para usuários incluídos na lista de permissões. Para utilizá-lo, envie um ticket.

  • ID do recurso (FunctionID/FuncId): 294.

  • Descrição dos parâmetros:

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo

    source_group_name

    String

    Sim

    O nome do grupo de origens. Pode conter letras minúsculas, dígitos e sublinhados (_). O comprimento máximo é de 128 bytes.

    example_origin

    source_info

    String

    Sim

    As informações sobre os servidores de origem. Formato: Endereço do Servidor de Origem_Prioridade_Peso_Porta. Use sublinhados (_) para separar os valores de diferentes parâmetros. Use vírgulas (,) para separar vários servidores de origem.

    • Endereço do Servidor de Origem: suporta IPv4, IPv6 e nomes de domínio.

    • Prioridade: valores válidos de 1 a 65535. Um valor menor indica uma prioridade maior.

    • Peso: valores válidos de 1 a 100. O DCDN distribui solicitações para diferentes servidores de origem com base em seus pesos.

    • Porta: valores válidos de 1 a 65535.

    • Origem única: 192.168.0.1_10_33_80

    • Várias origens: 192.168.0.1_10_33_80,192.0.2.1_10_67_80

    retry_times

    Integer

    Não

    O número de tentativas de nova busca na origem.

    3

    retry_status_rule

    Integer

    Não

    Os códigos de status que acionam uma nova tentativa de busca na origem. Atualmente, apenas os cinco valores seguintes são suportados: 4xx, 5xx, 404, 404-or-5xx e 4xx-or-5xx. Configure um deles.

    404-or-5xx

    failback_source

    String

    Não

    Use informações básicas de origem para backup. Valores válidos:

    • on: se todos os servidores de origem no grupo estiverem indisponíveis, as URLs de origem em Basic Information - Origin Information serão utilizadas.

    • off: se todos os servidores de origem no grupo estiverem indisponíveis, um código de status 5xx indicando que o servidor de origem está indisponível será retornado diretamente ao cliente.

    on

    Nota

    Lógica de nova tentativa de busca na origem:

    • Contagem de tentativas: o número de tentativas para uma busca na origem.

      • As novas tentativas ocorrem apenas em endereços IP diferentes dentro do mesmo grupo de origens.

      • O número máximo de tentativas é limitado pela quantidade de endereços IP disponíveis no grupo de origens.

      • Caso nenhuma contagem de tentativas (retry_times) seja configurada, o padrão será o menor valor entre 3 e o número de IPs de origem disponíveis.

      • Se uma contagem de tentativas (retry_times) for configurada, o número real de repetições será o menor valor entre a contagem definida e a quantidade de IPs de origem disponíveis.

    • Códigos de status para nova tentativa: os códigos de status que acionam uma repetição.

      • Se os códigos de status para nova tentativa (retry_status_rule) não forem configurados, por padrão, as repetições serão acionadas quando o servidor de origem retornar um código de status 5xx.

      • Ao configurar os códigos de status para nova tentativa (retry_status_rule), as repetições de failover serão acionadas com base nesses códigos. É possível configurar um dos seguintes códigos de status: 4xx, 5xx, 404, 404-or-5xx ou 4xx-or-5xx.

      • Após configurar o retry_status_rule, a regra padrão para códigos de status 5xx permanece em vigor. Por exemplo, se você configurar 404, o POP fará uma nova tentativa ao receber um código de status 404 ou 5xx.

    • Ordem de tentativas: as novas tentativas são realizadas nos endereços IP do mesmo grupo de origens, em ordem decrescente de prioridade.

    • Cenário de tempo limite de busca na origem: quando o servidor de origem responde proativamente com um código de status de nova tentativa, o POP inicia uma repetição. Se nenhum código de status de nova tentativa for recebido do servidor de origem, o processo de tratamento de tempo limite será seguido. Esse processo faz com que o POP tente novamente após o período de tempo limite ser atingido.

      • Tempo limite de conexão TCP: 10 segundos.

      • Tempo limite de gravação na origem: 30 segundos (o tempo limite para gravar conteúdo após o estabelecimento da conexão).

      • Tempo limite de leitura da origem: 30 segundos (o tempo limite que ocorre se o servidor de origem não retornar uma resposta completa ao POP dentro de um período especificado após o estabelecimento da conexão).

    • Lógica de sondagem de origem:

      • Conexão anormal na Camada 4: se um POP falhar ao se conectar a um endereço IP de origem na Camada 4, ele adicionará o endereço IP a uma tabela de inativos. Isso impede que solicitações subsequentes à origem acessem esse endereço IP. Em seguida, o POP realiza uma verificação de integridade da Camada 4 no endereço IP a cada 5 segundos. Se a conexão for estabelecida com sucesso, o POP restaurará o endereço IP para a lista de ativos.

      • Conexão normal na Camada 4: se a conexão da Camada 4 entre um POP e um endereço IP de origem estiver normal, mas o POP receber um código de status de nova tentativa (como 5xx) da resposta de origem, a lógica de nova tentativa será acionada. No entanto, o endereço IP de origem permanece na lista de ativos e as solicitações subsequentes ainda são enviadas ao servidor de origem com base em seu peso. (Isso significa que um erro da Camada 7 não bloqueia automaticamente o endereço IP de origem se a conexão da Camada 4 estiver normal. Para bloquear automaticamente o endereço IP de origem, configure separadamente o recurso "Verificações de integridade da Camada 7 para busca na origem".)

  • Exemplo de configuração:

    {
    "Functions":[{
     "functionArgs":[{
     "argName":"source_group_name",
     "argValue":"test_yidong"
    },{
     "argName":"source_info",
      "argValue":"192.168.0.1_10_33_80,192.0.2.1_10_67_80"
    },{
    "argName":"retry_times",
    "argValue":"3"
     },{
    "argName":"retry_status_rule",
    "argValue":"404,502"
    },{
    "argName":"failback_source",
      "argValue":"on"
    }],
    "functionName":"source_group"
    }],
     "DomainNames":"example.com"
    }

ipv6_origin

  • Descrição do recurso: configura a busca na origem via IPv6. Para obter mais informações, consulte ConfigureIPv6IPv6 origin fetch. Este recurso está disponível apenas para usuários incluídos na lista de permissões. Para utilizá-lo, envie um ticket.

  • ID do recurso (FunctionID/FuncId): 265

  • Descrição dos parâmetros:

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo

    enable

    String

    Sim

    Especifica se deve ativar a busca na origem via IPv6.

    • on: ativa o recurso.

    • off: desativa o recurso.

    Nota

    Se este recurso estiver ativado, o DCDN fornece serviços IPv6 para busca na origem.

    • Se tanto o ponto de presença (PoP) do DCDN quanto o servidor de origem tiverem endereços IPv6 ativos, o DCDN estabelecerá conexões via IPv6.

    • O DCDN estabelece conexões via IPv4 nos seguintes cenários:

      • O PoP do DCDN não possui um endereço IPv6 ativo.

      • O servidor de origem não possui um endereço IPv6 ativo.

      • Nem o PoP do DCDN nem o servidor de origem possuem um endereço IPv6 ativo.

    on

    follow

    String

    Sim

    Especifica se as solicitações de volta à origem seguem a versão do protocolo IP das solicitações do cliente.

    • on: o recurso está ativado.

    • off: o recurso está desativado.

    Nota

    Quando este recurso está ativado, as solicitações de volta à origem do DCDN seguem a versão do protocolo IP da solicitação do cliente.

    • Se uma solicitação do cliente usar IPv6, o DCDN priorizará servidores de origem IPv6 para a solicitação de volta à origem. Se nenhum servidor de origem IPv6 estiver disponível, o DCDN usará um servidor de origem IPv4.

    • Se uma solicitação do cliente usar IPv4, o DCDN priorizará servidores de origem IPv4 para a solicitação de volta à origem. Se nenhum servidor de origem IPv4 estiver disponível, o DCDN usará um servidor de origem IPv6.

    on

    ipv6_v4_mix_used

    String

    Não

    Especifica se deve ativar o recurso de Rodízio de Endereços IPv4/IPv6 de Origem.

    • on: ativado.

    • off: desativado.

    Nota
    • O recurso de Rodízio de Endereços IPv4/IPv6 de Origem é mutuamente exclusivo com os recursos de Busca na Origem via IPv6 e Seguir Protocolo IP do Cliente para Busca na Origem. Se o Rodízio de Endereços IPv4/IPv6 de Origem estiver ativado, os outros dois recursos serão desativados.

    • Este recurso usa o método de rodízio para enviar solicitações de busca na origem para todos os endereços de servidores de origem IPv4 e IPv6 configurados. Esse processo se aplica a todas as solicitações de cliente, independentemente de o cliente usar IPv4 ou IPv6.

    • Se pesos forem configurados para os endereços IPv4 e IPv6, as solicitações de busca na origem serão distribuídas de acordo com esses pesos.

    Off

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            },{
                "argName": "follow",
                "argValue": "on"
            }],
            "functionName": "ipv6_origin"
        }],
        "DomainNames": "example.com"
    }

cos_auth

  • Descrição: configura o bucket de autenticação para o Tencent Cloud Object Storage (COS). Este recurso está disponível apenas para usuários incluídos na lista de permissões. Para solicitar acesso, envie um ticket.

  • ID da função (FunctionID/FuncId): 288.

  • Parâmetros:

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Valor de exemplo

    enable

    String

    Sim

    Especifica se deve ativar o bucket de autenticação para o Tencent Cloud COS.

    • on: ativar.

    • off: desativar.

    on

    cos_valid_period

    String

    Não

    O período de validade da assinatura de autenticação em segundos. O valor padrão é 3600 segundos.

    /

    cos_secret_id

    String

    Sim

    O ID de autenticação do Tencent Cloud.

    123456789

    cos_secret_key

    String

    Sim

    A chave de autenticação do Tencent Cloud.

    12345678

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "cos_secret_id",
                "argValue": "123456789"
            }, {
                "argName": "cos_secret_key",
                "argValue": "123456789"
            }],
            "functionName": "cos_auth"
        }],
        "DomainNames": "example.com"
    }

oss_auth

  • Descrição do recurso: configura as informações de autenticação para o bucket do Object Storage Service (OSS) usado na busca de origem do DCDN.

  • ID da função (FunctionID/FuncId): 10.

  • Nota: a plataforma adiciona automaticamente a configuração oss_auth quando você define um bucket OSS como origem para um nome de domínio acelerado. Não adicione nem exclua esta configuração manualmente. Se esta configuração for excluída, as isenções de faturamento para tráfego de origem do DCDN não poderão ser aplicadas. Além disso, se a autenticação de bucket privado estiver ativada, a busca de origem do DCDN para o bucket OSS privado falhará.

  • Parâmetros:

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Valor de exemplo

    oss_bucket_id

    String

    Sim

    O nome de domínio público do bucket OSS.

    dcdn-test.oss-cn-hongkong.aliyuncs.com

    oss_pri_buckets

    String

    Sim

    O nome de domínio público do bucket OSS e seu nome de bucket correspondente.

    dcdn-test.oss-cn-hongkong.aliyuncs.com

    dcdn-test

  • Exemplo de configuração:

    {
        "Functions": [
                {
                  "ArgValue": "dcdn-test.oss-cn-hongkong.aliyuncs.com",
                  "ArgName": "oss_bucket_id"
                },
                {
                  "ArgValue": "dcdn-test.oss-cn-hongkong.aliyuncs.com|dcdn-test",
                  "ArgName": "oss_pri_buckets"
                }
              ],
            "functionName": "oss_auth"
        }],
        "DomainNames": "example.com"
    }

Configuração de cache

filetype_based_ttl_set

  • Especifica o tempo de expiração do cache para arquivos com base na extensão do arquivo. Para obter mais informações, consulte Configure cache time-to-live.

  • ID da função (FunctionID/FuncId): 6.

  • Descrição dos parâmetros:

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo

    ttl

    Integer

    Sim

    A duração do cache em segundos. O valor deve ser um número inteiro de 1 a 99999999, o que equivale a pouco mais de 3 anos.

    500000

    file_type

    String

    Sim

    O tipo de arquivo. Este parâmetro diferencia maiúsculas de minúsculas. Separe vários tipos de arquivo com vírgulas (,). Exemplo: jpg,txt.

    jpg

    weight

    Integer

    Não

    O peso. Valores válidos: 1 a 99.

    Nota

    O valor padrão é 1. Um valor maior indica uma prioridade mais alta.

    1

    swift_origin_cache_high

    String

    Não

    Prioriza a política de cache do servidor de origem. Se você definir este parâmetro como on, a política de cache do servidor de origem terá precedência quando ele retornar cabeçalhos relacionados ao cache, como Cache-Control e Pragma. Valores válidos:

    • on: ativado

    • off (padrão): desativado

    off

    swift_no_cache_low

    String

    Não

    Ignora os cabeçalhos de resposta no-cache do servidor de origem. Se você definir este parâmetro como on, os seguintes cabeçalhos de resposta no-cache do servidor de origem serão ignorados.

    • Cache-Control: no-store

    • Cache-Control: no-cache

    • Cache-Control: max-age=0

    • Pragma: no-cache

    Valores válidos:

    • on: ativado

    • off (padrão): desativado

    off

    swift_follow_cachetime

    String

    Não

    Permite que os clientes sigam a política de cache do DCDN. Se você definir este parâmetro como on, a política final de cache do DCDN será retornada ao cliente. Valores válidos:

    • on: ativado

    • off (padrão): desativado

    off

    force_revalidate

    String

    Não

    Força a validação de conteúdo quando o TTL é 0. Valores válidos:

    • on: ativado. Quando o TTL é 0, o conteúdo é armazenado em cache nos pontos de presença (POPs) e cada solicitação exige uma busca na origem para validar o conteúdo em cache.

    • off (padrão): desativado. Quando o TTL é 0, o conteúdo não é armazenado em cache nos POPs e cada solicitação exige uma busca na origem para recuperar o conteúdo.

    off

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "file_type",
                "argValue": "jpg"
            }, {
                "argName": "weight",
                "argValue": "1"
            }, {
                "argName": "ttl",
                "argValue": "500000"
            }, {
                "argName": "swift_origin_cache_high",
                "argValue": "off"
            }, {
                "argName": "swift_no_cache_low",
                "argValue": "off"
            }, {
                "argName": "swift_follow_cachetime",
                "argValue": "off"
            },{
                "argName": "force_revalidate",
                "argValue": "off"
            }],
            "functionName": "filetype_based_ttl_set"
        }],
        "DomainNames": "example.com"
    }
    

path_based_ttl_set

  • Descrição: Configura o tempo de expiração do cache para uma pasta. Para mais informações, consulte Configure cache expiration time.

  • ID da função (FunctionID/FuncId): 7.

  • Descrição dos parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    ttl

    Integer

    Yes

    Duração do cache em segundos. O valor deve ser um número inteiro de 1 a 99999999, o que equivale a pouco mais de 3 anos.

    500000

    path

    String

    Yes

    Caminho da pasta. O caminho deve começar com uma barra (/).

    /example/demo

    weight

    Integer

    No

    Peso. Valores válidos: 1 a 99.

    Nota

    O valor padrão é 1. Um valor maior indica prioridade mais alta.

    1

    swift_origin_cache_high

    String

    No

    Prioriza a política de cache do servidor de origem. Se você definir este parâmetro como on, a política de cache do servidor de origem terá precedência quando ele retornar cabeçalhos relacionados ao cache, como Cache-Control e Pragma. Valores válidos:

    • on: ativado

    • off (padrão): desativado

    off

    swift_no_cache_low

    String

    No

    Ignora os cabeçalhos de resposta no-cache do servidor de origem. Se você definir este parâmetro como on, os seguintes cabeçalhos de resposta no-cache do servidor de origem serão ignorados.

    • Cache-Control: no-store

    • Cache-Control: no-cache

    • Cache-Control: max-age=0

    • Pragma: no-cache

    Valores válidos:

    • on: ativado

    • off (padrão): desativado

    off

    swift_follow_cachetime

    String

    No

    Permite que os clientes sigam a política de cache do DCDN. Se você definir este parâmetro como on, a política final de cache do DCDN será retornada ao cliente. Valores válidos:

    • on: ativado

    • off (padrão): desativado

    off

    force_revalidate

    String

    No

    Força a validação de conteúdo quando o TTL é 0. Valores válidos:

    • on: ativado. Quando o TTL é 0, o conteúdo é armazenado em cache nos POPs e cada solicitação exige uma busca na origem para validar o conteúdo em cache.

    • off (padrão): desativado. Quando o TTL é 0, o conteúdo não é armazenado em cache nos POPs e cada solicitação exige uma busca na origem para recuperar o conteúdo.

    off

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "path",
                "argValue": "/example/demo"
            }, {
                "argName": "weight",
                "argValue": "1"
            }, {
                "argName": "ttl",
                "argValue": "500000"
            }, {
                "argName": "swift_origin_cache_high",
                "argValue": "off"
            }, {
                "argName": "swift_no_cache_low",
                "argValue": "off"
            }, {
                "argName": "swift_follow_cachetime",
                "argValue": "off"
            }, {
                "argName": "force_revalidate",
                "argValue": "off"
            }],
            "functionName": "path_based_ttl_set"
        }],
        "DomainNames": "example.com"
    }
    

filetype_force_ttl_code

  • Define o tempo de expiração do cache para códigos de status. Para mais informações, consulte Configure status code expiration time.

  • ID da função (FunctionID/FuncId): 63.

  • Descrição dos parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    file_type

    String

    Yes

    Tipo de arquivo. Este parâmetro diferencia maiúsculas de minúsculas. Separe vários tipos de arquivo com vírgulas (,). Exemplo: jpg,txt.

    jpg

    code_string

    String

    Yes

    Código de status e sua duração de cache em segundos. A duração máxima é de 3 anos. Separe várias entradas com vírgulas (,). Exemplo: 302=0,301=0,4xx=2.

    403=10

    swift_code_origin_cache_high

    String

    No

    Prioriza a política de cache do servidor de origem. Se você definir este parâmetro como on, a política de cache do servidor de origem terá precedência quando ele retornar cabeçalhos relacionados ao cache, como Cache-Control e Pragma. Valores válidos:

    • on: ativado

    • off (padrão): desativado

    off

    swift_code_no_cache_low

    String

    No

    Ignora os cabeçalhos de resposta no-cache do servidor de origem. Se você definir este parâmetro como on, os seguintes cabeçalhos de resposta no-cache do servidor de origem serão ignorados.

    • Cache-Control: no-store

    • Cache-Control: no-cache

    • Cache-Control: max-age=0

    • Pragma: no-cache

    Valores válidos:

    • on: ativado

    • off (padrão): desativado

    off

    swift_code_follow_cachetime

    String

    No

    Permite que os clientes sigam a política de cache do DCDN. Se você definir este parâmetro como on, a política final de cache do DCDN será retornada ao cliente. Valores válidos:

    • on: ativado

    • off (padrão): desativado

    off

    force_revalidate

    String

    No

    Força a validação de conteúdo quando o TTL é 0. Valores válidos:

    • on: ativado. Quando o TTL é 0, o conteúdo é armazenado em cache nos POPs e cada solicitação exige uma busca na origem para validar o conteúdo em cache.

    • off (padrão): desativado. Quando o TTL é 0, o conteúdo não é armazenado em cache nos POPs e cada solicitação exige uma busca na origem para recuperar o conteúdo.

    off

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "file_type",
                "argValue": "jpg"
            }, {
                "argName": "code_string",
                "argValue": "403=10"
            }, {
                "argName": "swift_code_origin_cache_high",
                "argValue": "off"
            }, {
                "argName": "swift_code_no_cache_low",
                "argValue": "off"
            }, {
                "argName": "swift_code_follow_cachetime",
                "argValue": "off"
            }, {
                "argName": "force_revalidate",
                "argValue": "off"
            }],
            "functionName": "filetype_force_ttl_code"
        }],
        "DomainNames": "example.com"
    }

path_force_ttl_code

  • Estabelece o tempo de expiração do cache de códigos de status para caminhos específicos. Para mais informações, consulte Configure status code expiration time.

  • ID da função (FunctionID/FuncId): 65.

  • Descrição dos parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    path

    String

    Yes

    Caminho da pasta. O caminho deve começar com uma barra (/). Exemplo: /image.

    /example/demo

    code_string

    String

    Yes

    Código de status e sua duração de cache em segundos. O valor deve ser um número inteiro de 1 a 99999999, o que equivale a pouco mais de 3 anos. Separe várias entradas com vírgulas (,). Exemplo: 302=0,301=0,4xx=2.

    403=10,404=15

    swift_code_origin_cache_high

    String

    No

    Prioriza a política de cache do servidor de origem. Se você definir este parâmetro como on, a política de cache do servidor de origem terá precedência quando ele retornar cabeçalhos relacionados ao cache, como Cache-Control e Pragma. Valores válidos:

    • on: ativado

    • off (padrão): desativado

    off

    swift_code_no_cache_low

    String

    No

    Ignora os cabeçalhos de resposta no-cache do servidor de origem. Se você definir este parâmetro como on, os seguintes cabeçalhos de resposta no-cache do servidor de origem serão ignorados.

    • Cache-Control: no-store

    • Cache-Control: no-cache

    • Cache-Control: max-age=0

    • Pragma: no-cache

    Valores válidos:

    • on: ativado

    • off (padrão): desativado

    off

    swift_code_follow_cachetime

    String

    No

    Permite que os clientes sigam a política de cache do DCDN. Se você definir este parâmetro como on, a política final de cache do DCDN será retornada ao cliente. Valores válidos:

    • on: ativado

    • off (padrão): desativado

    off

    force_revalidate

    String

    No

    Força a validação de conteúdo quando o TTL é 0. Valores válidos:

    • on: ativado. Quando o TTL é 0, o conteúdo é armazenado em cache nos POPs e cada solicitação exige uma busca na origem para validar o conteúdo em cache.

    • off (padrão): desativado. Quando o TTL é 0, o conteúdo não é armazenado em cache nos POPs e cada solicitação exige uma busca na origem para recuperar o conteúdo.

    off

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "path",
                "argValue": "/example/demo"
            }, {
                "argName": "code_string",
                "argValue": "403=10,404=15"
            }, {
                "argName": "swift_code_origin_cache_high",
                "argValue": "off"
            }, {
                "argName": "swift_code_no_cache_low",
                "argValue": "off"
            }, {
                "argName": "swift_code_follow_cachetime",
                "argValue": "off"
            }, {
                "argName": "force_revalidate",
                "argValue": "off"
            }],
            "functionName": "path_force_ttl_code"
        }],
        "DomainNames": "example.com"
    }
    

default_ttl_code

  • Descrição: Define o tempo de expiração do cache para códigos de status (prioridade à origem).

  • ID da função (FunctionID/FuncId): 207.

  • Descrição dos parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    default_ttl_code

    String

    Yes

    Código de status e sua duração de cache em segundos. O valor deve ser um número inteiro de 1 a 99999999, o que equivale a pouco mais de 3 anos. Separe vários códigos de status com vírgulas (,).

    4xx=3,200=3600,5xx=1

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "default_ttl_code",
                "argValue": "4xx=3,200=3600,5xx=1"
            }],
            "functionName": "default_ttl_code"
        }],
        "DomainNames": "example.com"
    }

set_resp_header

  • Descrição: Configura cabeçalhos de resposta HTTP personalizados. Para mais informações, consulte Modify outbound response headers.

  • ID da função (FunctionID/FuncId): 27.

  • Descrição dos parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    key

    String

    Yes

    Cabeçalho de resposta.

    Cache-Control

    value

    String

    Yes

    Valor do cabeçalho de resposta. Separe vários valores com vírgulas (,).

    Nota

    Para excluir um cabeçalho de resposta, defina seu valor como null.

    no-cache

    header_operation_type

    String

    No

    Operação a ser executada no cabeçalho da solicitação. Os valores são:

    • add: Adiciona uma entrada.

    • Delete: exclui.

    • Modify: altera.

    • rewrite: substitui um cabeçalho.

    add

    duplicate

    String

    No

    Especifica se é permitido adicionar um cabeçalho de resposta com o mesmo nome. Este parâmetro é obrigatório quando você define header_operation_type como add. Valores válidos:

    • on: Duplicatas permitidas.

    • off: não permite.

    off

    header_source

    String

    No

    Valor a ser substituído. Este parâmetro é obrigatório quando você define header_operation_type como rewrite. O valor pode ser uma expressão regular.

    value1

    header_destination

    String

    No

    Novo valor. Este parâmetro é obrigatório quando você define header_operation_type como rewrite.

    value123

    match_all

    String

    No

    Padrão de correspondência. Este parâmetro é obrigatório quando você define header_operation_type como rewrite. Valores válidos:

    • on: corresponde a todos. Todos os valores correspondentes são substituídos.

    • off: corresponde ao primeiro. Apenas o primeiro valor correspondente é substituído.

    /

    access_origin_control

    String

    No

    Especifica se deve ativar a autenticação entre domínios. Valores válidos:

    • on: Os POPs do DCDN autenticam solicitações de usuário entre domínios.

    • off: desativa este recurso.

    /

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "header_operation_type",
                "argValue": "add"
            }, {
                "argName": "key",
                "argValue": "Cache-Control"
            }, {
                "argName": "value",
                "argValue": "no-cache"
            }, {
                "argName": "duplicate",
                "argValue": "off"
            }],
            "functionName": "set_resp_header"
        }],
        "DomainNames": "example.com"
    }

error_page

  • Descrição: Configura páginas de erro personalizadas. Para mais informações, consulte Configure custom pages.

  • ID da função (FunctionID/FuncId): 15.

  • Descrição dos parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    error_code

    Integer

    Yes

    Código de erro.

    404

    rewrite_page

    String

    Yes

    Página de redirecionamento.

    http://example.aliyundoc.com/error404.html

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "error_code",
                "argValue": "404"
            }, {
                "argName": "rewrite_page",
                "argValue": "http://example.aliyundoc.com/error404.html"
            }],
            "functionName": "error_page"
        }],
        "DomainNames": "example.com"
    }

host_redirect

  • Descrição do recurso: Configura regras de reescrita de URI. Para mais informações, consulte Configure URI rewrite rules.

  • ID da função (FunctionID/FuncId): 43.

  • Descrição dos parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    regex

    String

    Yes

    URL a ser reescrita. Deve ser uma URI que comece com uma barra (/) e não contenha o protocolo http:// ou um nome de domínio. Expressões regulares PCRE são suportadas. Exemplo: ^/hello$.

    ^/hello$

    replacement

    String

    Yes

    URL de destino. Deve ser uma URI que comece com uma barra (/) e não contenha o protocolo http:// ou um nome de domínio.

    /hello/test

    flag

    String

    No

    Ação que um POP do DCDN executa após a reescrita da URI. Valores válidos:

    • Vazio: Valor padrão. Significa que o parâmetro flag não é passado. Se várias regras forem configuradas e uma URL de solicitação corresponder a uma regra, o POP continuará a corresponder às regras subsequentes após a execução da regra atual.

    • break: Se uma URL de solicitação corresponder a uma regra, a solicitação será reescrita para a URL de destino. Os parâmetros na URL original não são modificados. Após a execução da regra atual, nenhuma outra regra será correspondida.

    • redirect: Se uma URL de solicitação corresponder a uma regra, a solicitação será redirecionada para a URL de destino com um código de status 302. O POP do DCDN retorna a URL de destino como o cabeçalho Location para o cliente. Os parâmetros na URL original não são modificados. Após a execução da regra atual, as regras subsequentes ainda serão correspondidas.

    • enhance_break: Semelhante a break, mas reescreve toda a URL, incluindo os parâmetros.

    • enhance_redirect: Semelhante a redirect, mas reescreve toda a URL, incluindo os parâmetros.

    Nota

    O método de reescrita e o suporte para outros nomes de domínio e protocolos variam conforme a ação:

    • Vazio, break e enhance_break reescrevem diretamente a URL da solicitação do usuário. Eles não suportam reescrita para outros nomes de domínio ou protocolos, como reescrita de HTTP para HTTPS.

    • redirect e enhance_redirect usam um redirecionamento 302 para reescrever a URL. Eles suportam reescrita para outros nomes de domínio e protocolos:

      • O endereço Location 302 pode ser definido como o nome de domínio acelerado atual ou outro nome de domínio. Por exemplo, você pode reescrever uma URL de example.com para aliyundoc.com.

      • O endereço Location 302 suporta outros protocolos. Por exemplo, você pode reescrever uma URL de HTTP para HTTPS.

    redirect

    rewrite_method

    String

    No

    Método de redirecionamento. Os códigos de status 302, 303 e 307 são suportados:

    • 302: Método de redirecionamento padrão. O método de solicitação GET não muda. Outros métodos de solicitação podem mudar para GET.

    • 303: O método de solicitação GET não muda. Outros métodos de solicitação mudam para GET e o corpo da mensagem é perdido.

    • 307: O método de solicitação e o corpo da mensagem não mudam.

    302

    sequence

    Integer

    No

    Prioridade da configuração. Valores válidos: 1 a 99. Um valor menor indica prioridade mais alta. Se este parâmetro não for especificado, os valores serão atribuídos automaticamente em ordem crescente a partir de 1.

    1

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "flag",
                "argValue": "redirect"
            }, {
                "argName": "regex",
                "argValue": "^/hello$"
            }, {
                "argName": "replacement",
                "argValue": "/hello/test"
            }, {
                "argName": "rewrite_method",
                "argValue": "302"
            }],
            "functionName": "host_redirect"
        }],
        "DomainNames": "example.com"
    }

self_defined_cachekey

  • Descrição: Configura uma CacheKey personalizada. Para mais informações, consulte Custom CacheKey.

  • ID da Função (FunctionID/FuncId): 227.

  • Descrição dos parâmetros:

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo

    uri

    Array of String

    Não

    Reescreve a URI de origem na solicitação para uma URI de destino e salva o resultado como chave de cache.

    • uri_to_rewrite especifica a URI de origem.

    • ai_uri_regex especifica a URI de destino.

    [{"uri_to_rewrite":"/hello","ai_uri_regex":"/hello/test"}]

    args

    Array of String

    Não

    Executa uma operação de adição, exclusão, modificação ou manutenção nos parâmetros da solicitação e salva o resultado como chave de cache. Valores válidos:

    • args_operation_type: especifica o tipo de operação do parâmetro. Os valores suportados são add, delete, modify e keep.

    • args: especifica o valor do parâmetro para a operação.

    [{"args":"test=123","args_operation_type":"add"}]

    headers

    String

    Não

    Adiciona múltiplos cabeçalhos HTTP e os anexa à chave de cache. Separe múltiplos cabeçalhos HTTP com espaços.

    example

    variable

    Array of String

    Não

    Variável personalizada. Use uma expressão regular para extrair qualquer campo dos parâmetros da solicitação, cabeçalhos HTTP, cookies ou URI na URL da solicitação e, em seguida, anexe o campo à chave de cache.

    []

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "uri",
                "argValue": [{
                    "uri_to_rewrite": "/hello",
                    "ai_uri_regex": "/hello/test"
                }]
            }, {
                "argName": "args",
                "argValue": [{
                    "args": "test=123",
                    "args_operation_type": "add"
                }]
            }, {
                "argName": "headers",
                "argValue": ""
            }, {
                "argName": "variable",
                "argValue": []
            }],
            "functionName": "self_defined_cachekey"
        }],
        "DomainNames": "example.com"
    }

rewrite_host

  • Descrição: Configura o cache compartilhado.

  • ID da Função (FunctionID/FuncId): 54.

  • Descrição dos parâmetros:

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo

    share_host

    String

    Sim

    Nome de domínio de destino que pode compartilhar cache com o nome de domínio atual. Esta configuração não modifica o cabeçalho Host para buscas na origem. Ela usa apenas o valor share_host para gerar a chave de cache na consulta de recursos em cache.

    example.com

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "share_host",
                "argValue": "example.com"
            }],
            "functionName": "rewrite_host"
        }],
        "DomainNames": "example.com"
    }

serving_stale_content

  • Descrição: Serve conteúdo obsoleto quando o servidor de origem estiver indisponível.

  • ID da Função (FunctionID/FuncId): 260.

  • Descrição dos parâmetros:

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo

    origin_error_status_code

    String

    Não

    Códigos de status anormais personalizados do servidor de origem.

    • Descrição: Especifica os códigos de status de origem aos quais este recurso se aplica.

    • Valor padrão: Este parâmetro não é especificado por padrão. Por padrão, um erro de origem é definido como um tempo limite ou qualquer código de status 5xx.

    • Configuração: Insira 4xx ou 5xx para uma correspondência aproximada, ou insira códigos de status específicos como 502 ou 504 para uma correspondência exata. Para especificar vários códigos de status, separe-os por vírgulas (,).

    502

    extend_expiration_time

    Integer

    Não

    Tempo de expiração estendido.

    • Descrição: O tempo máximo para manter o cache obsoleto após sua expiração.

    • Valor padrão: Este parâmetro não é especificado por padrão. O tempo de expiração estendido padrão é de 1 hora.

    • Configuração: Insira um número inteiro positivo maior ou igual a 1. Unidade: segundos.

    60

    origin_first

    String

    Não

    Política de prioridade de origem.

    • Descrição: Se você definir este parâmetro como on, a política de origem terá prioridade. Se o servidor de origem retornar um arquivo com a política de cache Cache-Control: stale-if-error=xx, o tempo especificado pelo parâmetro stale-if-error será usado como tempo de expiração estendido.

    • Valor padrão: Este parâmetro não é especificado por padrão. Isso equivale a off. Nesse caso, o tempo de expiração estendido é especificado pelo parâmetro extend_expiration_time.

    • Configuração: Os valores suportados são on (ativado) e off (desativado).

    on

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "origin_error_status_code",
                "argValue": "502"
            }, {
                "argName": "extend_expiration_time",
                "argValue": "60"
            }, {
                "argName": "origin_first",
                "argValue": "off"
            }],
            "functionName": "serving_stale_content"
        }],
        "DomainNames": "example.com"
    }

Configuração HTTPS

https_option

  • Descrição do recurso: Configura parâmetros básicos de HTTPS. Para mais informações, consulte Configure HTTPS certificates, Configure HTTP/2 e Configure OCSP Stapling.

  • ID da Função (FunctionID/FuncId): 78.

  • Descrição dos parâmetros:

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Valor de exemplo

    http2

    String

    Não

    Especifica se deve ativar o HTTP/2:

    • on: Ativa o recurso.

    • off: Desativa o recurso.

    on

    ocsp_stapling

    String

    Não

    Especifica se deve ativar o recurso Online Certificate Status Protocol (OCSP) Stapling:

    • on: Ativa o recurso.

    • off: Desativa o recurso.

    on

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "http2",
                "argValue": "on"
            }, {
                "argName": "ocsp_stapling",
                "argValue": "on"
            }],
            "functionName": "https_option"
        }],
        "DomainNames": "example.com"
    }

http_force

  • Descrição: Configura um redirecionamento forçado para HTTP. Para mais informações, consulte Configure force redirect.

  • Conflito de recursos: O recurso de redirecionamento forçado para HTTP entra em conflito com o recurso de redirecionamento forçado para HTTPS (função: https_force, ID da função: 44). Ative apenas um deles. Se um desses recursos já estiver configurado, exclua sua configuração antes de configurar o outro. Um recurso é considerado configurado mesmo que seu parâmetro de alternância esteja definido como off. Para excluir uma configuração de recurso de um nome de domínio, chame a operação DeleteDcdnSpecificConfig.

  • ID da Função (FunctionID/FuncId): 45.

  • Parâmetros:

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Valor de exemplo

    enable

    String

    Sim

    Especifica se deve ativar o redirecionamento forçado para HTTP.

    • on: Ativa o recurso.

    • off: Desativa o recurso.

    on

    http_rewrite

    String

    Não

    Método de redirecionamento. Os códigos de status suportados são 301 e 308.

    • 301: O método de solicitação GET não é alterado. Outros métodos de solicitação podem ser alterados para o método GET.

    • 308: O método de solicitação e a entidade da mensagem não são alterados.

    301

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "http_rewrite",
                "argValue": "301"
            }],
            "functionName": "http_force"
        }],
        "DomainNames": "example.com"
    }

https_force

  • Descrição do recurso: Configura um redirecionamento forçado para HTTPS. Para mais informações, consulte Configure a forced redirect.

  • Conflito de recursos: O recurso de redirecionamento forçado para HTTPS entra em conflito com o recurso de redirecionamento forçado para HTTP (função: http_force, ID da Função: 45). Ative apenas um deles. Se um recurso já estiver configurado, exclua sua configuração antes de configurar o outro. Um recurso é considerado configurado mesmo que seu parâmetro de alternância esteja definido como off. Para excluir uma configuração, chame a operação DeleteDcdnSpecificConfig. Após excluir a configuração, configure o outro recurso.

  • ID da Função (FunctionID/FuncId): 44.

  • Descrição dos parâmetros:

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo

    enable

    String

    Sim

    Especifica se deve ativar o redirecionamento forçado para HTTPS:

    • on: Ativa o recurso.

    • off: Desativa o recurso.

    on

    https_rewrite

    String

    Não

    Método de redirecionamento. Os valores válidos são 301 e 308.

    • 301: O método de solicitação GET permanece inalterado. Outros métodos de solicitação podem ser alterados para GET.

    • 308: O método de solicitação e a entidade da mensagem permanecem inalterados.

    301

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "https_rewrite",
                "argValue": "301"
            }],
            "functionName": "https_force"
        }],
        "DomainNames": "example.com"
    }

https_tls_version

  • Descrição do recurso: Configura a versão do TLS. Para mais informações, consulte Configure TLS versions and cipher suites.

  • ID da Função (FuncId): 110.

  • Parâmetros:

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Valor de exemplo

    tls10

    String

    Não

    Especifica se deve ativar o TLSv1.0:

    • on (padrão): Ativa a configuração.

    • Off: A instância é desligada.

    on

    tls11

    String

    Não

    Especifica se deve ativar o TLSv1.1:

    • on (padrão): Ativado.

    • off: Indica um desligamento.

    on

    tls12

    String

    Não

    Especifica se deve ativar o TLSv1.2:

    • On (padrão): A configuração está ativada.

    • Off: Desligado.

    on

    tls13

    String

    Não

    Especifica se deve ativar o TLSv1.3:

    • on (padrão): Ativa a configuração.

    • off: Desligamento.

    on

    ciphersuitegroup

    String

    Não

    Grupo de conjuntos de cifras:

    • all (padrão): Todos os conjuntos de cifras.

    • strict: Conjuntos de cifras fortes.

    • custom: Conjuntos de cifras personalizados.

    all

    ciphersuite

    String

    Não

    Conjuntos de cifras personalizados. Este parâmetro é válido apenas quando ciphersuitegroup está definido como custom. Especifique múltiplos conjuntos de cifras separados por vírgulas.

    TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256,TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256

  • Exemplos de configuração:

    • Configuração padrão: Ativar TLS 1.0, TLS 1.1 e TLS 1.2, e usar todos os conjuntos de cifras.

      {
          "Functions": [{
              "functionArgs": [
                  {
                    "ArgValue": "on",
                    "ArgName": "tls10"
                  },
                  {
                    "ArgValue": "on",
                    "ArgName": "tls11"
                  },
                  {
                    "ArgValue": "on",
                    "ArgName": "tls12"
                  },
                  {
                    "ArgValue": "off",
                    "ArgName": "tls13"
                  },
                  {
                    "ArgValue": "all",
                    "ArgName": "ciphersuitegroup"
                  }
                ],
              "functionName": "https_tls_version"
          }],
          "DomainNames": "example.com"
      }
    • Ativar TLS 1.2 e TLS 1.3, e usar conjuntos de cifras fortes.

      {
          "Functions": [{
              "functionArgs": [
                  {
                    "ArgValue": "off",
                    "ArgName": "tls10"
                  },
                  {
                    "ArgValue": "off",
                    "ArgName": "tls11"
                  },
                  {
                    "ArgValue": "on",
                    "ArgName": "tls12"
                  },
                  {
                    "ArgValue": "on",
                    "ArgName": "tls13"
                  },
                  {
                    "ArgValue": "strict",
                    "ArgName": "ciphersuitegroup"
                  }
                ],
              "functionName": "https_tls_version"
          }],
          "DomainNames": "example.com"
      }
    • Ativar TLS 1.2 e TLS 1.3, e usar conjuntos de cifras personalizados.

      {
          "Functions": [{
              "functionArgs": [
                  {
                    "ArgValue": "off",
                    "ArgName": "tls10"
                  },
                  {
                    "ArgValue": "off",
                    "ArgName": "tls11"
                  },
                  {
                    "ArgValue": "on",
                    "ArgName": "tls12"
                  },
                  {
                    "ArgValue": "on",
                    "ArgName": "tls13"
                  },
                  {
                    "ArgValue": "custom",
                    "ArgName": "ciphersuitegroup"
                  },
                  {
                    "ArgValue": "TLS_ECDHE_ECDSA_WITH_AES_128_CCM_8,TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256,TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256",
                    "ArgName": "ciphersuite"
                  }
                ],
              "functionName": "https_tls_version"
          }],
          "DomainNames": "example.com"
      }

HSTS

  • Descrição: Configura o HTTP Strict Transport Security (HSTS). Para mais informações, consulte 配置HSTS.

  • O ID da Função (FunctionID/FuncId) é 112.

  • Descrição dos parâmetros:

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Valor de exemplo

    enabled

    String

    Sim

    Ativar HSTS:

    • Ativado.

    • off: Desliga o sistema.

    on

    https_hsts_max_age

    Integer

    Sim

    Tempo de expiração em segundos.

    Nota

    O valor recomendado é 5.184.000 s (60 dias).

    5184000

    https_hsts_include_subdomains

    String

    Não

    Especifica se deve incluir o parâmetro de subdomínio no cabeçalho HTTP Strict Transport Security (HSTS). Os valores válidos são on ou off.

    Nota

    Antes de ativar esta opção, certifique-se de que o HTTPS esteja ativado para todos os subdomínios do nome de domínio acelerado. Caso contrário, os subdomínios ficarão inacessíveis após serem redirecionados automaticamente para HTTPS.

    off

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enabled",
                "argValue": "on"
            }, {
                "argName": "https_hsts_max_age",
                "argValue": "5184000"
            }, {
                "argName": "https_hsts_include_subdomains",
                "argValue": "off"
            }],
            "functionName": "HSTS"
        }],
        "DomainNames": "example.com"
    }

Controle de acesso

referer_white_list_set

  • Descrição: Configura uma lista de permissões de Referer. Para mais informações sobre como configurar esse recurso no console, consulte Configure Referer hotlink protection.

  • Conflitos: O recurso de lista de permissões de Referer é mutuamente exclusivo com o recurso de lista de bloqueios de Referer (função: referer_black_list_set, ID da função: 5). Ative apenas um deles. Se um dos recursos já estiver configurado, exclua a configuração existente antes de configurar o outro. Um recurso é considerado configurado mesmo que seu parâmetro de alternância esteja definido como off. Para excluir uma configuração específica de um nome de domínio, chame a operação DeleteDcdnSpecificConfig.

  • ID da função (FunctionID/FuncId): 1.

  • Parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    refer_domain_allow_list

    String

    Yes

    A lista de permissões. Separe vários nomes de domínio com vírgulas (,).

    example.aliyundoc.com,demo.aliyundoc.com

    allow_empty

    String

    No

    Define se o acesso aos recursos do DCDN é permitido quando o campo Referer está vazio. Valores válidos:

    • on: Permite o acesso.

    • off (padrão): Nega o acesso.

    off

    redirect_url

    String

    No

    A URL de redirecionamento. Se o Referer em uma solicitação de usuário não corresponder a nenhum nome de domínio na lista de permissões, o DCDN retornará um código de status 302 com esta URL como valor do cabeçalho Location, em vez de um erro 403. A URL deve começar com http:// ou https://.

    http://www.example.com

    disable_ast

    String

    No

    Ativa o modo de correspondência exata. Este parâmetro controla se os nomes de domínio na lista de permissões devem ter correspondência exata. Se definido como on, a correspondência exata será utilizada.

    • Se definido como on:

      • Há suporte para correspondência exata.

        • Se a lista de permissões contiver example.com, haverá correspondência com example.com.

        • Se a lista de permissões contiver a*b.example.com, haverá correspondência com a<any string>b.example.com.

      • Não há suporte para correspondência por sufixo.

    • Se definido como off (padrão):

      • Não há suporte para correspondência exata.

      • Há suporte para correspondência por sufixo.

        • Se a lista de permissões contiver example.com, haverá correspondência com example.com e <any string>.example.com.

        • Se a lista de permissões contiver a*b.example.com, haverá correspondência com a<any string>b.example.com e <any string>.a<any string>b.example.com.

    off

    ignore_scheme

    String

    No

    Define se o esquema deve ser ignorado. Quando ativado, um Referer em uma solicitação de usuário é considerado válido mesmo sem incluir o cabeçalho de protocolo HTTP ou HTTPS. Exemplos:

    • Se definido como on, o formato do Referer é:

      referer: www.example.com

    • Se definido como off (padrão), o formato do Referer é:

      referer: https://www.example.com

    off

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "allow_empty",
                "argValue": "off"
            }, {
                "argName": "refer_domain_allow_list",
                "argValue": "example.aliyundoc.com,demo.aliyundoc.com"
            }],
            "functionName": "referer_white_list_set"
        }],
        "DomainNames": "example.com"
    }

referer_black_list_set

  • Descrição: Configura uma lista de bloqueios de Referer. Para mais informações sobre como configurar esse recurso no console, consulte Configure Referer hotlink protection.

  • Conflitos: O recurso de lista de bloqueios de Referer é mutuamente exclusivo com o recurso de lista de permissões de Referer (função: referer_white_list_set, ID da função: 1). Ative apenas um deles. Se um dos recursos já estiver configurado, exclua a configuração existente antes de configurar o outro. Um recurso é considerado configurado mesmo que seu parâmetro de alternância esteja definido como off. Para excluir uma configuração específica de um nome de domínio, chame a operação DeleteDcdnSpecificConfig.

  • ID da função (FunctionID/FuncId): 5.

  • Parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    refer_domain_deny_list

    String

    Yes

    A lista de bloqueios. Separe vários nomes de domínio com vírgulas (,).

    example.aliyundoc.com,demo.aliyundoc.com

    allow_empty

    String

    No

    Define se o acesso aos recursos do DCDN é permitido quando o campo Referer está vazio:

    • on: Permite o acesso.

    • off: Nega o acesso.

    off

    redirect_url

    String

    No

    A URL de redirecionamento. Se o Referer em uma solicitação de usuário corresponder a um nome de domínio na lista de bloqueios, o DCDN retornará um código de status 302 com esta URL como valor do cabeçalho Location, em vez de um erro 403. A URL deve começar com http:// ou https://.

    http://www.example.com

    disable_ast

    String

    No

    Ativa o modo de correspondência exata. Este parâmetro controla se os nomes de domínio na lista de bloqueios devem ter correspondência exata. Se definido como on, a correspondência exata será utilizada.

    • Se definido como on:

      • Há suporte para correspondência exata.

        • Se a lista de bloqueios contiver example.com, haverá correspondência com example.com.

        • Se a lista de bloqueios contiver a*b.example.com, haverá correspondência com a<any string>b.example.com.

      • Não há suporte para correspondência por sufixo.

    • Se definido como off (padrão):

      • Não há suporte para correspondência exata.

      • Há suporte para correspondência por sufixo.

        • Se a lista de bloqueios contiver example.com, haverá correspondência com example.com e <any string>.example.com.

        • Se a lista de bloqueios contiver a*b.example.com, haverá correspondência com a<any string>b.example.com e <any string>.a<any string>b.example.com.

    off

    ignore_scheme

    String

    No

    Define se o esquema deve ser ignorado. Quando ativado, um Referer em uma solicitação de usuário é considerado válido mesmo sem incluir o cabeçalho de protocolo HTTP ou HTTPS. Exemplos:

    • Se definido como on, o formato do Referer é:

      referer: www.example.com

    • Se definido como off (padrão), o formato do Referer é:

      referer: https://www.example.com

    off

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "allow_empty",
                "argValue": "off"
            }, {
                "argName": "refer_domain_deny_list",
                "argValue": "example.aliyundoc.com,demo.aliyundoc.com"
            }],
            "functionName": "referer_black_list_set"
        }],
        "DomainNames": "example.com"
    }

aliauth

  • Descrição: Configura a assinatura de URL. Para mais informações sobre como configurar esse recurso no console, consulte Configure URL signing.

  • ID da função (FunctionID/FuncId): 25.

  • Parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    auth_m3u8

    String

    No

    Ativa a reescrita de conteúdo M3U8. Isso adiciona os parâmetros de assinatura necessários aos arquivos TS dentro do arquivo M3U8 para evitar falhas de acesso. Os valores válidos são on (padrão) e off.

    on

    auth_type

    String

    Yes

    O método de assinatura. Valores válidos:

    • no_auth: Sem assinatura.

    • type_a: Assinatura tipo A.

    • type_b: Assinatura tipo B.

    • type_c: Assinatura tipo C.

    • type_f: Assinatura tipo F.

    type_a

    auth_key1

    String

    Yes

    Chave de criptografia 1. A chave deve ter entre 16 e 128 caracteres e pode conter letras maiúsculas, letras minúsculas e dígitos.

    1234567890123456789

    auth_key2

    String

    No

    Chave de criptografia 2. A chave deve ter entre 16 e 128 caracteres e pode conter letras maiúsculas, letras minúsculas e dígitos.

    1234567890123456789

    ali_auth_delta

    Integer

    No

    O período de validade da URL assinada. Valor padrão: 1800. Unidade: segundos.

    1800

    req_auth_ip_white

    String

    No

    A lista de permissões de IP. Os endereços IP nesta lista estão isentos da verificação de assinatura.

    Insira vários endereços IP separados por vírgulas (,).

    192.168.0.1

    req_auth_ip_acl_xfwd

    String

    No

    O método para obter o endereço IP do cliente para a lista de permissões. Valores válidos:

    • on: Modo padrão. O DCDN verifica o primeiro endereço IP à esquerda no cabeçalho X-Forwarded-For da solicitação do usuário. Este é o endereço IP de origem do cliente.

    • off: O DCDN verifica o endereço IP usado para estabelecer a conexão entre o cliente e o ponto de presença do DCDN.

    • all: O DCDN verifica ambos os endereços IP a seguir:

      • O primeiro endereço IP à esquerda no cabeçalho X-Forwarded-For da solicitação do usuário, que é o endereço IP de origem do cliente.

      • O endereço IP usado para estabelecer a conexão entre o cliente e o ponto de presença do DCDN.

    all

    sign_param

    String

    No

    O nome do parâmetro de assinatura. Este parâmetro é válido apenas quando auth_type está definido como type_f.

    sign

    time_param

    String

    No

    O nome do parâmetro de timestamp. Este parâmetro é válido apenas quando auth_type está definido como type_f.

    time

    time_format

    String

    No

    O formato do timestamp. Este parâmetro é válido apenas quando auth_type está definido como type_f.

    • dec: decimal

    • hex: hexadecimal

    hec

    path_encoding

    String

    No

    Define se a codificação de URL deve ser ativada. Valores válidos: on e off. Este parâmetro é válido apenas quando auth_type está definido como type_f.

    on

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "auth_type",
                "argValue": "type_a"
            }, {
                "argName": "auth_key1",
                "argValue": "1234567890123456789"
            }, {
                "argName": "auth_key2",
                "argValue": "1234567890123456789"
            }, {
                "argName": "ali_auth_delta",
                "argValue": 1800
            }, {
                "argName": "req_auth_ip_white",
                "argValue": "192.168.0.1"
            }, {
                "argName": "req_auth_ip_acl_xfwd",
                "argValue": "all"   
            }, {
                "argName": "sign_param",
                "argValue": "sign"
            }, {
                "argName": "time_param",
                "argValue": "time"
            }, {
                "argName": "time_format",
                "argValue": "hec"
            }, {
                "argName": "path_encoding",
                "argValue": "on"
            }],
            "functionName": "aliauth"
        }],
        "DomainNames": "example.com"
    }

cdn_remote_auth

  • Descrição: Configura a autenticação remota.

  • ID da função (FunctionID/FuncId): 258.

  • Parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    enable

    String

    Yes

    Define se a autenticação remota deve ser ativada. Valores válidos:

    • Ativado.

    • Off: Desativado.

    on

    remote_auth_addr

    String

    Yes

    O endereço do servidor de autenticação. Formato: https://dcdn.aliyun.com/auth ou http://10.10.10.10/auth.

    https://example.aliyundoc.com/auth

    remote_auth_method

    String

    Yes

    O método de solicitação. Valores válidos: get, post e head.

    get

    remote_auth_type

    String

    Yes

    Os tipos de arquivo que exigem autenticação. all indica todos os tipos de arquivo. Para especificar vários tipos de arquivo, separe-os com barras verticais (|). Os tipos de arquivo diferenciam maiúsculas de minúsculas. Por exemplo, jpg não é igual a JPG.

    all

    remote_auth_reserve_args

    String

    Yes

    Os parâmetros a serem mantidos na solicitação. Para especificar vários parâmetros, separe-os com barras verticais (|). Os parâmetros não diferenciam maiúsculas de minúsculas. Por exemplo, key é igual a KEY.

    • all: Mantém todos os parâmetros.

    • ali_delete_all_args: Exclui todos os parâmetros da URL.

    all

    remote_auth_custom_args

    String

    No

    Os parâmetros personalizados a serem adicionados. Para especificar vários parâmetros, separe-os com barras verticais (|). Os parâmetros diferenciam maiúsculas de minúsculas. Por exemplo, key não é igual a KEY.

    empty

    remote_auth_reserve_header

    String

    Yes

    Os cabeçalhos de solicitação a serem mantidos. Para especificar vários cabeçalhos, separe-os com barras verticais (|). Os cabeçalhos não diferenciam maiúsculas de minúsculas. Por exemplo, http_remote_addr é igual a HTTP_Remote_Addr.

    • all: Mantém todos os cabeçalhos de solicitação.

    • ali_delete_all_headers: Exclui todos os cabeçalhos de solicitação.

    all

    remote_auth_custom_header

    String

    No

    Os cabeçalhos de solicitação personalizados a serem adicionados. Para especificar vários cabeçalhos, separe-os com barras verticais (|). Os cabeçalhos não diferenciam maiúsculas de minúsculas. Por exemplo, http_remote_addr é igual a HTTP_Remote_Addr.

    empty

    remote_auth_success_code

    Integer

    Yes

    O código de status para autenticação bem-sucedida. Este é o resultado que o servidor de autenticação retorna ao DCDN após uma autenticação bem-sucedida. Exemplo: 200. Especifique vários códigos de status separados por vírgulas (,).

    200

    remote_auth_fail_code

    Integer

    Yes

    O código de status para falha na autenticação. Este é o resultado que o servidor de autenticação retorna ao DCDN após uma falha na autenticação. Exemplo: 403. Especifique vários códigos de status separados por vírgulas (,).

    403,404

    remote_auth_other_code_act

    String

    No

    A ação que o DCDN executa em uma solicitação de usuário se o código de status retornado pelo servidor de autenticação não for um código de sucesso ou falha. Valores válidos:

    • pass (padrão): Permite a solicitação.

    • reject: Nega a solicitação.

    pass

    remote_auth_fail_resp_code

    Integer

    Yes

    O código de status de resposta que o DCDN retorna ao usuário após uma falha na autenticação. Exemplo: 403.

    403

    remote_auth_timeout

    Integer

    Yes

    O tempo limite de autenticação. Unidade: ms. O valor máximo é 3000.

    500

    remote_auth_timeout_action

    String

    Yes

    A ação a ser tomada quando a autenticação atingir o tempo limite. Valores válidos:

    • pass: O DCDN permite a solicitação do usuário.

    • reject: O DCDN retorna o remote_auth_fail_resp_code especificado ao usuário.

    pass

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "remote_auth_addr",
                "argValue": "https://example.aliyundoc.com/auth"
            }, {
                "argName": "remote_auth_method",
                "argValue": "get"
            }, {
                "argName": "remote_auth_type",
                "argValue": "all"
            }, {
                "argName": "remote_auth_reserve_args",
                "argValue": "all"
            }, {
                "argName": "remote_auth_custom_args",
                "argValue": ""
            }, {
                "argName": "remote_auth_reserve_header",
                "argValue": "all"
            }, {
                "argName": "remote_auth_custom_header",
                "argValue": ""
            }, {
                "argName": "remote_auth_success_code",
                "argValue": "200"
            }, {
                "argName": "remote_auth_fail_code",
                "argValue": "403"
            }, {
                "argName": "remote_auth_other_code_act",
                "argValue": "pass"
            }, {
                "argName": "remote_auth_fail_resp_code",
                "argValue": "403"
            }, {
                "argName": "remote_auth_timeout",
                "argValue": 500
            }, {
                "argName": "remote_auth_timeout_action",
                "argValue": "pass"
            }],
            "functionName": "cdn_remote_auth"
        }],
        "DomainNames": "example.com"
    }

ip_allow_list_set

  • Descrição: Configura uma lista de permissões de IP. Para mais informações sobre como configurar este recurso no console, consulte Configure IP blacklists and whitelists.

  • Conflitos: O recurso de lista de permissões de IP é mutuamente exclusivo com o recurso de lista de bloqueios de IP (função: ip_black_list_set, ID da função: 13). Ative apenas um deles. Se um dos recursos já estiver configurado, exclua a configuração dele antes de configurar o outro. Um recurso é considerado configurado mesmo que seu parâmetro de alternância esteja definido como off. Para excluir uma configuração específica de um nome de domínio, chame a operação DeleteDcdnSpecificConfig.

  • ID da Função (FunctionID/FuncId): 69.

  • Parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    ip_list

    String

    Yes

    A lista de IPs. Separe vários endereços IP ou blocos CIDR com vírgulas (,).

    192.168.0.1/24

    customize_response_status_code

    String

    No

    O código de status de resposta personalizado. O valor padrão é vazio, o que indica que o código de status da resposta é 403. Insira um número de 3 dígitos para definir um código de status de resposta personalizado.

    429

    ip_acl_xfwd

    String

    No

    Define se deve usar o endereço IP no cabeçalho X-Forwarded-For. Valores válidos:

    • on: Este é o valor padrão. O DCDN usa o primeiro endereço IP à esquerda no cabeçalho x-forwarded-for da solicitação do usuário para verificação.

    • off: Usa o endereço real client IP.

    • all: O DCDN usa tanto o cabeçalho x-forwarded-for quanto o IP address of the connection para verificação.

    all

    ip_list_notes

    String

    No

    Observações para a lista de endereços IP.

    192.x.x.1 (Malicious)

    192.x.x.2 (Illegal)

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "ip_list",
                "argValue": "192.168.0.1/24"
            }],
            "functionName": "ip_allow_list_set"
        }],
        "DomainNames": "example.com"
    }

ip_black_list_set

  • Descrição: Configura uma lista de bloqueios de IP. Para mais informações sobre como configurar este recurso no console, consulte Configure IP blacklists and whitelists.

  • Conflitos: O recurso de lista de bloqueios de IP é mutuamente exclusivo com o recurso de lista de permissões de IP (função: ip_allow_list_set, ID da função: 69). Ative apenas um deles. Se um dos recursos já estiver configurado, exclua a configuração dele antes de configurar o outro. Um recurso é considerado configurado mesmo que seu parâmetro de alternância esteja definido como off. Para excluir uma configuração específica de um nome de domínio, chame a operação DeleteDcdnSpecificConfig.

  • ID da Função (FunctionID/FuncId): 13.

  • Parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    ip_list

    String

    Yes

    A lista de IPs. Separe vários endereços IP ou blocos CIDR com vírgulas (,).

    192.168.0.1

    customize_response_status_code

    String

    No

    O código de status de resposta personalizado. O valor padrão é vazio, o que indica que o código de status da resposta é 403. Insira um número de 3 dígitos para definir um código de status de resposta personalizado.

    429

    ip_acl_xfwd

    String

    No

    Define se deve usar o endereço IP no cabeçalho X-Forwarded-For. Valores válidos:

    • on: Este é o valor padrão. O DCDN usa o primeiro endereço IP à esquerda no cabeçalho x-forwarded-for da solicitação do usuário para verificação.

    • off: Usa o actual source IP address.

    • all: O DCDN usa tanto o cabeçalho x-forwarded-for quanto o IP address of the connection para verificação.

    all

    ip_list_notes

    String

    No

    Observações para a lista de endereços IP.

    192.x.x.1 (Malicious)

    192.x.x.2 (Illegal)

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "ip_list",
                "argValue": "192.168.0.1"
            }],
            "functionName": "ip_black_list_set"
        }],
        "DomainNames": "example.com"
    }

ali_ua

  • Descrição: Configura o controle de acesso com base no cabeçalho User-Agent. Para mais informações sobre como configurar este recurso no console, consulte Configure User-Agent blacklists and whitelists.

  • ID da Função (FunctionID/FuncId): 58.

  • Parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    ua

    String

    Yes

    As strings de User-Agent. O caractere curinga () é suportado para corresponder a qualquer string. Para especificar vários valores, separe-os com barras verticais (|). Exemplo: curl|IE|chrome|firefox*.

    curl|IE|chrome|firefox

    type

    String

    Yes

    O tipo de lista. Valores válidos:

    • black: lista de bloqueios.

    • white: lista de permissões.

    Nota

    Listas de bloqueios e listas de permissões são mutuamente exclusivas. Apenas um tipo pode estar ativo por vez.

    black

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "ua",
                "argValue": "*curl*|*IE*|*chrome*|*firefox*"
            }, {
                "argName": "type",
                "argValue": "black"
            }],
            "functionName": "ali_ua"
        }],
        "DomainNames": "example.com"
    }

Otimização de desempenho

tesla

  • Descrição do recurso: Configura a otimização de HTML para acelerar o carregamento da página. Para mais informações, consulte HTML Optimization.

  • ID da Função (FunctionID/FuncId): 16.

  • Parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    enable

    String

    Yes

    Define se deve ativar a aceleração para otimização de HTML.

    • on: Ativa o recurso.

    • off: Desativa o recurso.

    on

    trim_js

    String

    No

    Define se deve otimizar o código JavaScript (JS) inline no HTML.

    • on: Ativa o recurso.

    • off (padrão): Desativa a otimização.

    off

    trim_css

    String

    No

    Define se deve otimizar o código Cascading Style Sheets (CSS) inline no HTML.

    • on: Ativa a otimização.

    • off (padrão): Estado desativado.

    off

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "trim_css",
                "argValue": "off"
            }, {
                "argName": "trim_js",
                "argValue": "off"
            }],
            "functionName": "tesla"
        }],
        "DomainNames": "example.com"
    }

gzip

  • Descrição do recurso: Otimiza páginas usando compressão Gzip. Para mais informações, consulte Gzip compression.

  • ID da Função (FunctionID/FuncId): 35.

  • Parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    enable

    String

    Yes

    Define se deve ativar a otimização Gzip para páginas.

    • on: Ativa o recurso.

    • off: Desativa o recurso.

    on

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }],
            "functionName": "gzip"
        }],
        "DomainNames": "example.com"
    }

brotli

  • Descrição do recurso: Configura a compressão Brotli para páginas. Para mais informações, consulte Brotli compression.

  • ID da Função (FunctionID/FuncId): 97.

  • Parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    enable

    String

    Yes

    Define se deve ativar a compressão Brotli para páginas.

    • on: Ativa o recurso.

    • off: Desativa o recurso.

    on

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }],
            "functionName": "brotli"
        }],
        "DomainNames": "example.com"
    }

set_hashkey_args

  • Descrição do recurso: Ignora parâmetros de URL retendo apenas os parâmetros especificados. Para mais informações, consulte Ignore parameters.

  • Conflito de recurso: O recurso Ignorar Parâmetros de URL (Reter) entra em conflito com o recurso Ignorar Parâmetros de URL (Excluir) (função: ali_remove_args, ID da função: 75). Ative apenas um desses recursos por vez. Se um recurso já estiver configurado, exclua a configuração dele antes de configurar o outro. Um recurso é considerado configurado mesmo que seu parâmetro de ativação esteja definido como off. Para excluir uma configuração de recurso de um nome de domínio, chame a operação DeleteDcdnSpecificConfig.

  • ID da Função (FunctionID/FuncId): 19.

  • Parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    hashkey_args

    String

    No

    A lista de parâmetros a serem retidos. Separe vários parâmetros com vírgulas (,). É possível especificar até 10 parâmetros.

    key1,key2

    disable

    String

    Yes

    Define se deve ignorar todos os parâmetros.

    • on: Ignora todos os parâmetros. Os recursos de excluir, reter e modificar parâmetros ficam desativados. Apenas o recurso de adicionar parâmetros permanece efetivo.

    • off (padrão): Desativa o recurso. Os recursos de reter, adicionar e excluir parâmetros permanecem efetivos.

    Nota

    A prioridade de ignorar todos os parâmetros para a chave de hash do cache é menor do que a prioridade de reter uma lista de parâmetros de cache.

    on

    keep_oss_args

    String

    Yes

    Define se deve reter parâmetros para solicitações de busca na origem.

    • on: Retém todos os parâmetros nas solicitações de busca na origem.

    • off: Os parâmetros nas solicitações de busca na origem são iguais aos parâmetros na chave de hash do cache.

    on

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "hashkey_args",
                "argValue": ""
            }, {
                "argName": "keep_oss_args",
                "argValue": "on"
            }, {
                "argName": "disable",
                "argValue": "on"
            }],
            "functionName": "set_hashkey_args"
        }],
        "DomainNames": "example.com"
    }

ali_remove_args

  • Descrição do recurso: Ignora parâmetros de URL excluindo os parâmetros especificados. Para mais informações, consulte Ignore parameters.

  • Conflito de recurso: O recurso Ignorar Parâmetros de URL (Excluir) entra em conflito com o recurso Ignorar Parâmetros de URL (Reter) (função: set_hashkey_args, ID da função: 19). Ative apenas um desses recursos por vez. Se um recurso já estiver configurado, exclua a configuração dele antes de configurar o outro. Um recurso é considerado configurado mesmo que seu parâmetro de ativação esteja definido como off. Para excluir uma configuração de recurso de um nome de domínio, chame a operação DeleteDcdnSpecificConfig.

  • ID da Função (FunctionID/FuncId): 75.

  • Parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    ali_remove_args

    String

    Yes

    Os parâmetros a serem excluídos. Separe vários parâmetros com espaços.

    Nota

    Os parâmetros restantes são usados como argumentos da URL na chave de hash.

    test

    keep_oss_args

    String

    Yes

    Define se deve reter parâmetros para solicitações de busca na origem.

    • on: Retém todos os parâmetros nas solicitações de busca na origem.

    • off: Os parâmetros nas solicitações de busca na origem são iguais aos parâmetros na chave de hash do cache.

    off

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "ali_remove_args",
                "argValue": "test"
            }, {
                "argName": "keep_oss_args",
                "argValue": "off"
            }],
            "functionName": "ali_remove_args"
        }],
        "DomainNames": "example.com"
    }

image_transform

  • Descrição do recurso: Configura a transformação de imagens do DCDN. Para mais informações, consulte Image editing methods and benefits.

  • ID da Função (FunctionID/FuncId): 239.

  • Parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    enable

    String

    Yes

    Define se deve ativar a transformação de imagens.

    • on: Ativa o recurso.

    • off: Desativa o recurso.

    on

    filetype

    String

    Yes

    Os formatos de imagem que suportam transcodificação. Separe vários formatos com uma barra vertical (|). Os seguintes valores são suportados:

    • JPEG: O formato de imagem JPEG.

    • JPG: O formato de imagem JPG.

    • PNG: O formato de imagem PNG.

    • WEBP: O formato de imagem WEBP.

    • BMP: O formato de imagem BMP.

    • GIF: O formato de imagem GIF.

    • TIFF: O formato de imagem TIFF.

    • JP2: O formato de imagem JPEG 2000.

    jpg|jpeg|png

    webp

    String

    No

    Define se deve ativar a conversão automática para WebP.

    • on: Ativa a conversão.

    • off: A instância está desligada.

    on

    orient

    String

    No

    Define se deve ativar a rotação automática de imagens.

    • on: O recurso está ativado.

    • off: O recurso está desligado.

    Nota

    Este recurso funciona apenas para imagens que possuem propriedade de rotação.

    on

    slim

    Integer

    No

    Compactação de imagem. Defina a porcentagem de compactação. O valor pode variar de 0 a 100. Este recurso reduz a qualidade da imagem para economizar tráfego sem alterar a resolução, as dimensões ou o formato.

    10

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "filetype",
                "argValue": "jpg|jpeg|png"
            }, {
                "argName": "webp",
                "argValue": "on"
            }, {
                "argName": "orient",
                "argValue": "on"
            }, {
                "argName": "slim",
                "argValue": ""
            }, {
                "argName": "enable",
                "argValue": "on"
            }],
            "functionName": "image_transform"
        }],
        "DomainNames": "example.com"
    }

Recursos de vídeo

range

  • Descrição do recurso: Configura a busca de origem por intervalo. Para mais informações, consulte Configure Range Origin Fetch.

  • ID da função: 31.

  • Parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    enable

    String

    Yes

    Define se a busca de origem por intervalo deve ser ativada.

    • on: Ativar.

    • off: Desativar.

    • force: Forçar ativação.

    on

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }],
            "functionName": "range"
        }],
        "DomainNames": "example.com"
    }

video_seek

  • Descrição: Configura a busca em vídeo. Para detalhes sobre a configuração no console, consulte Video seeking.

  • ID da função: 30.

  • Parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    enable

    String

    Yes

    Define se a busca em vídeo deve ser ativada.

    • on: Ativar.

    • off: Desativar.

    on

    flv_seek_by_time

    String

    No

    Indica se a busca por tempo para arquivos FLV está habilitada.

    • on: Ativar.

    • off: Desativar.

    on

    mp4_seek_start

    String

    No

    Parâmetro inicial personalizado para arquivos MP4.

    mp4starttime

    mp4_seek_end

    String

    No

    Parâmetro final personalizado para arquivos MP4.

    mp4endtime

    flv_seek_start

    String

    No

    Parâmetro inicial personalizado para arquivos FLV.

    flvstarttime

    flv_seek_end

    String

    No

    Parâmetro final personalizado para arquivos FLV.

    flvendtime

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }],
            "functionName": "video_seek"
        }],
        "DomainNames": "example.com"
    }

ali_video_split

  • Descrição: Configura a reprodução apenas de áudio.

  • ID da função: 204.

  • Parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    enable

    String

    Yes

    Especifica se a reprodução apenas de áudio deve ser ativada.

    • on: Ativar.

    • off: Desativar.

    on

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }],
            "functionName": "ali_video_split"
        }],
        "DomainNames": "example.com"
    }

ali_video_preview

  • Descrição: Configura a pré-visualização de vídeo.

  • ID da função: 205.

  • Parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    enable

    String

    Yes

    Determina se a pré-visualização de vídeo será habilitada.

    • on: Ativar.

    • off: Desativar.

    Nota

    É possível usar arquivos TS e MP3, além de arrastar e soltar arquivos FLV e MP4.

    on

    ali_video_preview_argument

    String

    Yes

    Nome do parâmetro personalizado para pré-visualização de vídeo. O valor deste parâmetro deve estar em segundos.

    fds

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "ali_video_preview_argument",
                "argValue": "fds"
            }],
            "functionName": "ali_video_preview"
        }],
        "DomainNames": "example.com"
    }

hls_token_rewrite

  • Descrição: Configura a criptografia e reescrita M3U8.

  • ID da função: 253.

  • Parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    enable

    String

    Yes

    Controla a ativação da criptografia e reescrita M3U8.

    • on: Ativar.

    • off: Desativar.

    on

    hls_token_arg_name

    String

    No

    Nome personalizado do parâmetro para o token HLS. Caso não seja definido, MtsHlsUriToken será usado como nome padrão.

    example

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }],
            "functionName": "hls_token_rewrite"
        }],
        "DomainNames": "example.com",
    }

Configuração de segurança

ddos_domain

  • Descrição do recurso: Configura o agendamento do Anti-DDoS. Para mais informações, consulte Mitigation Settings.

  • ID da função (FuncId): 209.

  • Descrição dos parâmetros:

    Parameter

    Type

    Required

    Description

    Example

    enable

    String

    Yes

    Define se a proteção Anti-DDoS deve ser ativada:

    • on: Ativar

    • off: Desativar

    on

    dispatch_qps

    String

    No

    Limiar de consultas por segundo (QPS).

    • Intervalo de valores: 2000 a 50000.

    • Valor padrão: 20000.

    20000

    auto_dispatch

    String

    No

    Ativa a limpeza inteligente de tráfego. Ao habilitar este recurso, não é necessário especificar um limiar de QPS. O sistema DCDN determina automaticamente se o padrão de limpeza de tráfego deve ser acionado.

    • on: Ativar

    • off: Desativar

    on

    checkurl

    String

    Yes

    Caminho para a verificação de integridade sob o nome de domínio.

    Valor padrão: / (diretório raiz do nome de domínio).

    /*/examplefile.txt

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "dispatch_qps",
                "argValue": "20000"
            }, {
                "argName": "checkurl",
                "argValue": "/*/examplefile.txt"
            }],
            "functionName": "ddos_domain"
        }],
        "DomainNames": "example.com"
    }

ali_location

  • Recurso: Lista de bloqueios por localização. Para mais informações, consulte Configure blacklist by region.

  • ID da função (FuncId): 57.

  • Parâmetros:

    Parameter

    Type

    Required

    Description

    Sample value

    location

    String

    Yes

    Especifica as regiões onde a política de bloqueio se aplica. O valor pode seguir um dos formatos abaixo:

    • Código de país de duas letras maiúsculas conforme o padrão ISO 3166. Para múltiplos países, separe os códigos com espaços.

    • A região pode ser definida como global.

    global

    type

    String

    Yes

    Define o tipo da política de bloqueio. Valores válidos:

    • black: Lista de bloqueios. Bloqueia endereços IP de clientes das regiões especificadas.

    • white: Lista de permissões. Bloqueia endereços IP de clientes de todas as regiões, exceto as especificadas.

    black

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "location",
                "argValue": "global"
            }, {
                "argName": "type",
                "argValue": "white"
            }],
            "functionName": "ali_location"
        }],
        "DomainNames": "example.com"
    }

Limitação de taxa

limit_rate

  • Descrição do recurso: Configura o limite de taxa para uma única solicitação.

  • ID da função: 72.

  • Descrição dos parâmetros:

    É possível configurar um limite fixo com ali_limit_rate, um limite dinâmico baseado em parâmetros da URL da solicitação ou um limite baseado em horário.

    Para limitar taxas com base em parâmetros da URL da solicitação, utilize traffic_limit_arg e traffic_limit_unit em conjunto.

    Para estabelecer horários de início e fim na limitação de taxa, combine os parâmetros ali_limit_start_hour e ali_limit_end_hour.

    Parameter

    Type

    Required

    Description

    Example value

    ali_limit_rate

    String

    Yes

    Estabelece o limite de taxa para uma única solicitação. O valor consiste em um número seguido de uma unidade. As unidades suportadas são k para KByte/s e m para MByte/s.

    O valor mínimo é 100k. Valores inferiores a 100k são tratados como 100k.

    • 1m: Define o limite de taxa para uma única solicitação em 1 MByte/s.

    • 100k: Define o limite de taxa para uma única solicitação em 100 KByte/s.

    ali_limit_rate_after

    String

    No

    Quantidade de dados a serem enviados antes do início da limitação de taxa. O valor é um número seguido de unidade. Unidades aceitas: k para KByte e m para MByte.

    1000

    traffic_limit_arg

    String

    No

    Nome do parâmetro de limitação de taxa. A taxa é limitada com base no argumento extraído da URL. Por exemplo, rate.

    Se a solicitação não contiver esse parâmetro, o limite padrão definido por ali_limit_rate será aplicado. Para desabilitar a limitação quando o parâmetro estiver ausente, defina ali_limit_rate como 0k.

    rate

    traffic_limit_unit

    String

    No

    Unidade para o parâmetro traffic_limit_arg. Unidades suportadas: m (MByte/s) e k (KByte/s). Por exemplo, se definido como m e a URL contiver rate=1, o limite real será 1 MByte/s.

    O valor mínimo é 100k. Valores abaixo de 100k são processados como 100k.

    m

    ali_limit_start_hour

    Integer

    No

    Horário de início para a limitação de taxa. Deve ser um inteiro entre 0 e 24, obrigatoriamente menor que o horário final. Valor padrão: 0.

    Nota

    Representa uma hora no formato de 24 horas. Por exemplo, 0 corresponde a 00:00:00 e 24 a 24:00:00.

    20

    ali_limit_end_hour

    Integer

    No

    Horário de término para a limitação de taxa. Deve ser um inteiro entre 0 e 24, obrigatoriamente maior que o horário inicial. Valor padrão: 24.

    23

  • Exemplo de configuração 1: Define o limite de taxa para uma única solicitação em 1 MB/s.

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "ali_limit_rate",
                "argValue": "1m"
            }],
            "functionName": "limit_rate"
        }],
        "DomainNames": "example.com"
    }
  • Exemplo de configuração 2: O limite padrão para uma única solicitação é 1 MB/s. Se a URL da solicitação incluir o parâmetro rate, a limitação seguirá o valor desse parâmetro. Por exemplo, se a solicitação contiver rate=200, o limite efetivo será 200 KB/s.

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "ali_limit_rate",
                "argValue": "1m"
            },{
                "argName": "traffic_limit_arg",
                "argValue": "rate"
            },{
                "argName": "traffic_limit_unit",
                "argValue": "k"
            }],
            "functionName": "limit_rate"
        }],
        "DomainNames": "example.com"
    }

WebSocket

websocket

  • Descrição: Configura o WebSocket. Para mais informações, consulte Configure WebSocket.

  • ID da função (FunctionID/FuncId): 144.

  • Descrições dos parâmetros:

    Parameter

    Type

    Required

    Description

    Example value

    enabled

    String

    Yes

    Indica se o WebSocket deve ser habilitado.

    • on: Habilita o recurso.

    • off: Desabilita o recurso.

    on

    origin_scheme

    String

    No

    Protocolo utilizado nas solicitações de busca de origem do WebSocket. Valores válidos:

    • http: O WebSocket utiliza HTTP para buscar a origem.

    • https: O WebSocket utiliza HTTPS para buscar a origem. O servidor de origem precisa suportar a porta 443.

    • follow: O WebSocket adota o mesmo protocolo da solicitação do cliente. O servidor de origem deve aceitar a porta 443 ou 80.

    Nota

    Caso este parâmetro não seja configurado, o valor padrão será follow.

    http

    heartbeat

    String

    No

    Tempo limite de conexão.

    • Intervalo de valores: 1 a 300

    • Unidade: segundos

    • Valor padrão: 60

    60

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enabled",
                "argValue": "on"
            }, {
                "argName": "origin_scheme",
                "argValue": "http"
            }, {
                "argName": "heartbeat",
                "argValue": "60"
            }],
            "functionName": "websocket"
        }],
        "DomainNames": "example.com"
    }

Aceleração de aplicações IP

protogw

  • Descrição do recurso: Configura a aceleração de aplicações IP. Para mais informações, consulte What is IP application acceleration?.

  • ID do recurso (FunctionID/FuncId): 163.

  • Parâmetros:

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo

    realip

    String

    Sim

    Define o protocolo usado para transmitir o endereço IP de origem do cliente. Valores válidos:

    • off: Estado desativado.

    • toa: Transmite o endereço IP de origem do cliente. É necessário instalar o módulo de kernel TOA no servidor de origem. Não são necessárias modificações no programa de service.

    • pp: Transmite o endereço IP de origem do cliente. O Nginx open source oferece suporte nativo a este protocolo. Verifique a compatibilidade com outros softwares de servidor de origem.

    toa

    port

    String

    Sim

    A porta de aceleração.

    Nota
    • Não há suporte para aceleração nas seguintes portas: 22, 123, 161 a 162, 179, 830, 2049, 2601, 2605, 3389, 5049, 7547, 8082, 8087, 8182, 8888, 9998, 15772, 15776, 15778 a 15779, 18053, 18098 a 18099, 18888, 19313, 19777 e 56667.

    • Para adicionar a porta 80 ou 443, envie um ticket.

    8443

    mux

    String

    Não

    Define se a multiplexação deve ser ativada para a porta. Valores válidos:

    • on: Ativado.

    • off: Desativado.

    off

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "realip",
                "argValue": "toa"
            }, {
                "argName": "port",
                "argValue": "8443"
            }, {
                "argName": "mux",
                "argValue": "off"
            }],
            "functionName": "protogw"
        }],
        "DomainNames": "example.com"
    }

EdgeScript/função Edge

edge_function

  • Descrição: Configura o EdgeScript. Para mais informações, consulte EdgeScript overview.

  • ID da função (FunctionID ou FuncId): 180.

  • Descrição dos parâmetros:

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo

    rule

    String

    Sim

    A regra DSL.

    if eq($uri, '/') {\n rewrite('https://example.com/index.html', 'redirect')\n}

    pri

    Integer

    Sim

    A prioridade. Valores válidos: [0, 999]. Um valor menor indica uma prioridade maior.

    Nota

    As prioridades para execução no cabeçalho e no rodapé são independentes entre si.

    0

    enable

    String

    Sim

    Define se a regra deve ser ativada. Valores válidos:

    • on: A regra está ativada.

    • off: A regra está desativada.

    on

    name

    String

    Sim

    O nome da regra. Apenas letras e sublinhados (_) são suportados.

    test

    pos

    String

    Não

    A posição onde a regra é executada. Valores válidos:

    • head (padrão): A regra é executada no início do fluxo de processamento da solicitação.

    • foot: A regra é executada no final do fluxo de processamento da solicitação.

    head

    brk

    String

    Não

    Define se a execução deve ser interrompida. Valores válidos:

    • on: Se esta regra for atingida, as regras restantes na posição de execução atual serão ignoradas.

    • off (padrão): Se esta regra for atingida, as regras restantes ainda serão executadas.

    off

    option

    String

    Não

    O campo de extensão.

    empty

    grammar

    String

    Não

    A sintaxe da regra. Valores válidos: es2 (padrão) e js.

    /

    jsmode

    String

    Não

    O modo de execução JavaScript (JS). Valores válidos:

    • redirect: Modo de Bloqueio.

    • bypass (padrão): Modo de desvio.

    /

  • Exemplo de configuração:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "name",
                "argValue": "test"
            }, {
                "argName": "rule",
                "argValue": "if eq($uri, '/') {\n  rewrite('https://example.com/index.html', 'redirect')\n}"
            }, {
                "argName": "pri",
                "argValue": "0"
            }, {
                "argName": "pos",
                "argValue": "head"
            }, {
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "brk",
                "argValue": "off"
            }, {
                "argName": "option",
                "argValue": ""
            }],
            "functionName": "edge_function"
        }],
        "DomainName": "example.com"
    }

EdgeRoutine

edgeroutine

  • Descrição: Configura o EdgeRoutine. Para mais informações, consulte What is an edge function?.

  • ID do recurso (FunctionID/FuncId): 275.

  • Este recurso está disponível apenas mediante solicitação. Para utilizá-lo, você deve ou enviar um ticket.

Mecanismo de regras

condition

  • Descrição do recurso: Configura regras condicionais no mecanismo de regras. Essas regras avaliam parâmetros nas solicitações do usuário para determinar se uma configuração se aplica, permitindo controle flexível e preciso sobre as políticas de configuração do DCDN.

  • ID do recurso (FunctionID/FuncId): 250.

  • Descrição dos parâmetros:

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Valor de exemplo

    rule

    Array

    Sim

    O conteúdo da regra condicional, incluindo seu nome, status, operador lógico e expressão condicional.

    Conteúdo da regra:

    {\"match\":{\"logic\":\"and\",\"criteria\":[{\"matchType\":\"clientipVer\",\"matchObject\":\"CONNECTING_IP\",\"matchOperator\":\"equals\",\"matchValue\":\"v6\",\"negate\":false}]},\"name\":\"example\",\"status\":\"enable\"}

    Resultado:

    • Nome da regra: example

    • Status: enable

    • Operador lógico: and

    • Expressão condicional: A versão do protocolo do endereço IP de conexão do cliente é v6.

    sequence

    Integer

    Não

    A prioridade da configuração. Valores válidos: 1 a 99. Um valor menor indica uma prioridade maior. Se este parâmetro não for especificado, os valores serão atribuídos automaticamente em ordem crescente, começando por 1.

    1

    A tabela a seguir descreve o formato da expressão condicional, que corresponde ao formato de argValue:

    Parâmetro

    Descrição

    "match":

    match especifica uma expressão de correspondência condicional.

    "logic":"and"

    logic define o operador lógico da expressão de correspondência condicional. Os valores válidos são and e or.

    "criteria"

    criteria especifica o conteúdo da expressão condicional.

    "matchType":"clientipVer"

    matchType indica o tipo de informação na solicitação do usuário a ser correspondida.

    "matchObject":"CONNECTING_IP"

    matchObject detalha o tipo de correspondência. Por exemplo, um endereço IP de cliente pode ser definido como um endereço IP de conexão ou um endereço IP X-Forwarded-For (XFF).

    "matchOperator":"equals"

    matchOperator define a ação para a operação de correspondência.

    "matchValue":"v6"

    matchValue especifica o valor predefinido para comparar com as informações da solicitação do usuário.

    "negate":false

    negate indica se o resultado da expressão condicional deve ser negado. Os valores válidos são true e false.

    "name":"example"

    name define o nome da regra condicional.

    "status":"enable"

    status especifica o status da regra condicional.

  • Exemplo de configuração:

    O exemplo abaixo mostra como usar a OpenAPI para adicionar uma configuração do mecanismo de regras ao nome de domínio acelerado example.com. Esta configuração filtra e faz a correspondência de solicitações com base na versão do protocolo IP do cliente ser IPv6.

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "rule",
                "argValue": "{\"match\":{\"logic\":\"and\",\"criteria\":[{\"matchType\":\"clientipVer\",\"matchObject\":\"CONNECTING_IP\",\"matchOperator\":\"equals\",\"matchValue\":\"v6\",\"negate\":false}]},\"name\":\"example\",\"status\":\"enable\"}"
            }],
            "functionName": "condition"
        }],
        "DomainNames": "example.com"
    }

    Após criar uma configuração do mecanismo de regras, associe-a a outras configurações de recursos. Isso proporciona um controle mais flexível e preciso sobre a execução das políticas de configuração do DCDN.

    Observações:

    • Para referenciar uma configuração do mecanismo de regras em outro recurso, defina o parâmetro parentid como o configid da regra condicional. O configid é gerado quando você adiciona a configuração do mecanismo de regras.

    • O parâmetro parentid não é suportado quando a função é condition (mecanismo de regras).

QUIC

iquic

  • Descrição: Configura o protocolo QUIC. Para mais informações, consulte What is QUIC?.

  • ID da função: 281.

  • Parâmetros:

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Valor de exemplo

    iquic_enable

    String

    Sim

    Define se o protocolo QUIC deve ser ativado:

    • on: Ativar

    • off: Desativar

    on

  • Exemplo de configuração

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "iquic_enable",
                "argValue": "on"
            }],
            "functionName": "iquic"
        }],
        "DomainNames": "example.com"
    }