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.
As operações de API a seguir fazem referência aos recursos descritos neste tópico: BatchSetDcdnDomainConfigs, DescribeDcdnDomainConfigs, BatchDeleteDcdnDomainConfigs e DescribeDcdnUserDomainsByFunc.
Chame BatchSetDcdnDomainConfigs para configurar recursos em vários nomes de domínio acelerados de uma só vez e gerar um ConfigId exclusivo. Use esse ConfigId para atualizar ou excluir uma configuração específica. Para mais informações, consulte Usage of ConfigId.
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.
NotaUse 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.
NotaSe 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.
NotaUm 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.
NotaSe 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.
NotaRecomendamos 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.
NotaSe 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].
NotaO 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.
Notaset_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 comoAccept-Encodinge o valor do cabeçalho da requisição é definido comogzip.{ "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.
NotaA 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
parentidpara 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 doconfigidgerado 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.comhost
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 dehostutilizado 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 dehost: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 dehostsegue a URL de origem (representado porali_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.
NotaSe 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.
NotaAlgoritmos 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
httpe 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.comsni_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.orgkeepalive_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.
NotaSe 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 SNIhost.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âmetroali_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âmetroali_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
NotaLó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.
NotaSe 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.
NotaQuando 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.
NotaO 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_authquando 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.
NotaO 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, comoCache-ControlePragma. Valores válidos:on: ativadooff(padrão): desativado
off
swift_no_cache_low
String
Não
Ignora os cabeçalhos de resposta
no-cachedo servidor de origem. Se você definir este parâmetro comoon, os seguintes cabeçalhos de respostano-cachedo 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: ativadooff(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: ativadooff(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.
NotaO 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, comoCache-ControlePragma. Valores válidos:on: ativadooff(padrão): desativado
off
swift_no_cache_low
String
No
Ignora os cabeçalhos de resposta
no-cachedo servidor de origem. Se você definir este parâmetro comoon, os seguintes cabeçalhos de respostano-cachedo 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: ativadooff(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: ativadooff(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, comoCache-ControlePragma. Valores válidos:on: ativadooff(padrão): desativado
off
swift_code_no_cache_low
String
No
Ignora os cabeçalhos de resposta
no-cachedo servidor de origem. Se você definir este parâmetro comoon, os seguintes cabeçalhos de respostano-cachedo 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: ativadooff(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: ativadooff(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, comoCache-ControlePragma. Valores válidos:on: ativadooff(padrão): desativado
off
swift_code_no_cache_low
String
No
Ignora os cabeçalhos de resposta
no-cachedo servidor de origem. Se você definir este parâmetro comoon, os seguintes cabeçalhos de respostano-cachedo 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: ativadooff(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: ativadooff(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 (,).
NotaPara 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_typecomoadd. 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_typecomorewrite. 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_typecomorewrite.value123
match_all
String
No
Padrão de correspondência. Este parâmetro é obrigatório quando você define
header_operation_typecomorewrite. 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
Locationpara 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.
NotaO 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
Location302 pode ser definido como o nome de domínio acelerado atual ou outro nome de domínio. Por exemplo, você pode reescrever uma URL deexample.comparaaliyundoc.com.O endereço
Location302 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_rewriteespecifica a URI de origem.ai_uri_regexespecifica 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ãoadd,delete,modifyekeep.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
Hostpara buscas na origem. Ela usa apenas o valorshare_hostpara 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
4xxou5xxpara uma correspondência aproximada, ou insira códigos de status específicos como502ou504para 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âmetrostale-if-errorserá 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âmetroextend_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.
NotaO 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.
NotaAntes 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.comallow_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.comdisable_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 comexample.com.Se a lista de permissões contiver
a*b.example.com, haverá correspondência coma<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 comexample.come<any string>.example.com.Se a lista de permissões contiver
a*b.example.com, haverá correspondência coma<any string>b.example.come<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.comSe 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.comallow_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.comdisable_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 comexample.com.Se a lista de bloqueios contiver
a*b.example.com, haverá correspondência coma<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 comexample.come<any string>.example.com.Se a lista de bloqueios contiver
a*b.example.com, haverá correspondência coma<any string>b.example.come<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.comSe 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_typeestá definido comotype_f.sign
time_param
String
No
O nome do parâmetro de timestamp. Este parâmetro é válido apenas quando
auth_typeestá definido comotype_f.time
time_format
String
No
O formato do timestamp. Este parâmetro é válido apenas quando
auth_typeestá definido comotype_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_typeestá definido comotype_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/authouhttp://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.
allindica 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_codeespecificado 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-forda 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-forquanto oIP address of the connectionpara 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-forda 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-forquanto oIP address of the connectionpara 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.
NotaListas 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.
NotaA 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.
NotaOs 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.
NotaEste 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_argetraffic_limit_unitem conjunto.Para estabelecer horários de início e fim na limitação de taxa, combine os parâmetros
ali_limit_start_houreali_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
kpara KByte/s empara MByte/s.O valor mínimo é
100k. Valores inferiores a100ksão tratados como100k.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:
kpara KByte empara 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_rateserá aplicado. Para desabilitar a limitação quando o parâmetro estiver ausente, definaali_limit_ratecomo0k.rate
traffic_limit_unit
String
No
Unidade para o parâmetro
traffic_limit_arg. Unidades suportadas:m(MByte/s) ek(KByte/s). Por exemplo, se definido comome a URL contiverrate=1, o limite real será 1 MByte/s.O valor mínimo é
100k. Valores abaixo de100ksão processados como100k.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.
NotaRepresenta uma hora no formato de 24 horas. Por exemplo,
0corresponde a 00:00:00 e24a 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 contiverrate=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.
NotaCaso 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.
NotaNã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.
NotaAs 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":
matchespecifica uma expressão de correspondência condicional."logic":"and"
logicdefine o operador lógico da expressão de correspondência condicional. Os valores válidos sãoandeor."criteria"
criteriaespecifica o conteúdo da expressão condicional."matchType":"clientipVer"
matchTypeindica o tipo de informação na solicitação do usuário a ser correspondida."matchObject":"CONNECTING_IP"
matchObjectdetalha 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"
matchOperatordefine a ação para a operação de correspondência."matchValue":"v6"
matchValueespecifica o valor predefinido para comparar com as informações da solicitação do usuário."negate":false
negateindica se o resultado da expressão condicional deve ser negado. Os valores válidos sãotrueefalse."name":"example"
namedefine o nome da regra condicional."status":"enable"
statusespecifica 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
parentidcomo oconfigidda regra condicional. Oconfigidé gerado quando você adiciona a configuração do mecanismo de regras.O parâmetro
parentidnã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" }