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

Parameter

Type

Required

Description

Example

enable

String

Yes

Ativa a aceleração estática:

• on: ativa o recurso.

• off: desativa o recurso.

on

static_route_type

String

No

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

.txt

static_route_url

String

No

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

/domain/detail/log.txt

static_route_path

String

No

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

/abc/test/*

dynamic_route_origin

String

No

A 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 do servidor de origem.

https

dynamic_route_round_robin

String

No

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

• on: ativa o recurso.

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

off

Parameter

Type

Required

Description

Example

switch

String

Yes

Ative o acesso IPv6:

• on: ativa o recurso.

• off: desativa o recurso.

on

region

String

Yes

As regiões nas quais você deseja ativar o IPv6. O caractere curinga (*) é compatível.

*

Parameter

Type

Required

Description

Example

oss_bucket_id

String

Yes

O endereço do seu bucket.

***.oss-cn-hangzhou.aliyuncs.com

Parameter

Type

Required

Description

Example

domain_name

String

Yes

O conteúdo do cabeçalho do host de origem.

example.com

Parameter

Type

Required

Description

Example

enable

String

Yes

Indica se a política de protocolo de origem está ativa. Valores válidos:

• on: ativa o recurso.

• off: desativa o recurso.

on

scheme_origin

String

No

A 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 requisição do cliente para busca na origem.

follow

scheme_origin_port

String

No

A porta de origem personalizada. Este parâmetro deve ser usado em conjunto com o parâmetro scheme_origin. Valores válidos:

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

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

• Se scheme_origin estiver definido como follow, configure tanto a porta de origem HTTP quanto a HTTPS, separando-as com dois-pontos (:). Exemplo: 80:443.

80:443

Parameter

Type

Required

Description

Example

private_oss_auth

String

Yes

Indica se a busca na origem a partir de um bucket privado está ativa. 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 a configuração. No entanto, este método suporta busca na origem apenas a partir de buckets OSS privados que pertencem à mesma conta Alibaba Cloud do nome de domínio acelerado pelo DCDN. Para mais informações sobre tokens STS, consulte O que é o Security Token Service (STS)?.

on

perm_private_oss_tbl

String

No

A 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, você pode realizar a busca na origem a partir de buckets OSS privados da mesma conta Alibaba Cloud do nome de domínio acelerado pelo DCDN, bem como de buckets OSS privados pertencentes a outra conta Alibaba Cloud. Para mais informações sobre tokens de segurança permanentes, consulte Criar um AccessKey.

access_id=123 access_secret=123abc

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

host

String

Sim

O endereço completo do bucket OSS.

example.oss-cn-hangzhou.aliyuncs.com

key

String

Sim

A 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 de origem em buckets OSS privados que pertencem à mesma conta Alibaba Cloud do nome de domínio acelerado pelo DCDN, bem como em buckets OSS privados de outra conta Alibaba Cloud. Para mais informações sobre tokens de segurança permanentes, consulte Criar um AccessKey.

access_id=123 access_secret=123abc

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

enabled

String

Sim

Indica se o recurso de SNI de origem está ativo. Valores válidos:

• on: ativa o recurso.

• off: desativa o recurso.

on

https_origin_sni

String

Sim

As informações de SNI incluídas na requisição de origem. Trata-se do endereço do servidor de origem que a requisição precisa acessar.

origin.example.com

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

forward_timeout

Integer

Sim

O período de timeout da requisição. Unidade: segundos.

30

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

variable_type

String

Sim

O tipo da variável. Valores válidos:

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

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

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

• cookie: um cookie de requisição presente na solicitação do usuário.

uri

variable

String

Sim

O nome da variável.

uri

conditions

String

Sim

A condição. Valores válidos:

• ==: igual a.

• !=: diferente de.

==

value

String

Sim

O valor da variável.

/image

origin

String

Sim

O nome de domínio usado na consulta DNS durante o fetch de origin. Trata-se do valor da variável presente na solicitação do usuário. Se o valor corresponder, a solicitação é redirecionada para a URL de origin especificada.

origin.example.com

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

enable

String

Sim

Define se o redirecionamento 302 para o origin fetch deve ser ativado. Valores válidos:

• on: ativa o recurso.

• off: desativa o recurso.

on

max_tries

Integer

Não

O número máximo de redirecionamentos 302.

• Valor padrão: 2.

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

2

retain_args

String

Não

Define se os parâmetros originais da requisição 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

Não

Define se o header original da requisição deve ser mantido ao redirecionar para o servidor de origem de destino. Valores válidos:

• On: mantém o header.

• off (padrão): não mantém o header.

off

response_header

String

Não

O header de resposta do redirecionamento 302. Trata-se do nome do header de resposta 302 que o servidor de origem envia ao DCDN. O nome padrão do header é Location.

X-Alicdn-Redirect

retain_host

String

No

Retenção do nome de domínio de origem em redirecionamentos 302. Quando ativado, o DCDN mantém o nome de domínio de origem durante um redirecionamento 302. Aplica-se apenas 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 do nome de domínio de origem em redirecionamentos 302. O DCDN modifique o nome de domínio de origem durante um redirecionamento 302. Aplica-se apenas ao redirecionar para o nome de domínio de destino. Por padrão, o nome de domínio de origem não é alterado.

example.com

cache

String

No

Cache do resultado do redirecionamento 302. Quando ativado, o DCDN armazena em cache o resultado do 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

Período de expiração do cache do resultado do redirecionamento 302. Define por quanto tempo o DCDN armazena em cache o resultado do redirecionamento para a mesma URL durante um redirecionamento 302. Este parâmetro deve ser usado em conjunto com o recurso de cache. Unidade: segundos. Valor padrão: 3600.

7200

follow_origin_host

String

No

Uso do nome de domínio de origem como origin host em redirecionamentos 302. Quando ativado, o DCDN utiliza o nome de domínio de origem como origin host. O nome de domínio de origem mais recente é usado mesmo após uma alternância 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

Alternância entre servidores de origem primário e secundário. Quando ativado, o DCDN muda para o próximo servidor de origem disponível ao receber um código de status 5xx do servidor de origem. Valores válidos:

• on: ativa o recurso.

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

off

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

key

String

Sim

O nome do cabeçalho de origem.

Accept-Encoding

value

String

Sim

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

gzip

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

header_operation_type

String

Sim

A operação sobre o cabeçalho de requisição. Valores válidos:

• add: Adiciona uma nova entrada.

• delete: exclui.

• Modify

• Use replace em vez de rewrite.

add

header_name

String

Sim

O nome do cabeçalho de requisição.

Accept-Encoding

header_value

String

Não

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

gzip

duplicate

String

Não

Especifica se é permitido adicionar um cabeçalho de requisição com o mesmo nome. Ao definir header_operation_type como add, especifique se duplicatas são permitidas. Valores válidos:

• On: Permitido.

• Off: Desativado.

off

header_source

String

Não

O valor do parâmetro a ser substituído. Ao definir header_operation_type como rewrite, este parâmetro é obrigatório. Expressões regulares são suportadas.

value1

header_destination

String

Não

O novo valor do parâmetro. Ao definir header_operation_type como rewrite, este parâmetro é obrigatório.

value123

match_all

String

Não

O modo de correspondência. Ao definir header_operation_type como rewrite, defina também o modo de correspondência. Valores válidos:

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

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

off

Parameter

Type

Required

Description

Example

header_operation_type

String

Sim

A operação sobre o header de requisição. Valores válidos:

• add: Adiciona uma nova entrada.

• delete: Exclui.

• Modify

• Use replace em vez de rewrite.

add

header_name

String

Sim

O nome do header de requisição.

Accept-Encoding

header_value

String

Não

O valor do header de requisição. É possível configurar múltiplos valores para um parâmetro de header de requisição. Separe os valores com vírgulas (,).

gzip

duplicate

String

Não

Especifica se é permitido adicionar um header de requisição com o mesmo nome. Ao definir header_operation_type como add, especifique se duplicatas são permitidas. Valores válidos:

• On: Permitido.

• Off: Desativado.

off

header_source

String

Não

O valor do parâmetro a ser substituído. Ao definir header_operation_type como rewrite, configure este parâmetro. Expressões regulares são suportadas.

value1

header_destination

String

Não

O novo valor do parâmetro. Ao definir header_operation_type como rewrite, configure este parâmetro.

value123

match_all

String

Não

O modo de correspondência. Ao definir header_operation_type como rewrite, configure o modo de correspondência. Valores válidos:

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

• off: Corresponde apenas ao primeiro valor. Somente o primeiro valor correspondente é substituído.

off

Parameter

Type

Required

Description

Example

header_operation_type

String

Sim

A operação sobre o cabeçalho de resposta. Valores válidos:

• add: adiciona um item.

• Delete: exclui o item.

• To modify é para fazer uma alteração.

• Replace.

add

header_name

String

Sim

O nome do cabeçalho de resposta.

Cache-Control

header_value

String

Não

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

no-cache

duplicate

String

Não

Especifica se é permitido adicionar um cabeçalho de resposta com o mesmo nome. Ao definir header_operation_type como add, especifique se duplicatas são permitidas. Valores válidos:

• on: permite duplicatas.

• off: não permite duplicatas.

off

header_source

String

Não

O valor do parâmetro a ser substituído. Ao definir header_operation_type como rewrite, configure este parâmetro. Expressões regulares são compatíveis.

value1

header_destination

String

Não

O novo valor do parâmetro. Ao definir header_operation_type como rewrite, configure este parâmetro.

value123

match_all

String

Não

O modo de correspondência. Ao definir header_operation_type como rewrite, defina o modo de correspondência. Valores válidos:

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

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

off

Parameter

Type

Required

Description

Example

source_url

String

Yes

A URI a ser reescrita.

^/hello$

target_url

String

Yes

A URI de destino.

/hello/test

flag

String

No

A regra de execução da operação de reescrita. Valores válidos:

• Vazio: quando este parâmetro não é definido, as regras de reescrita subsequentes continuam sendo executadas após a regra atual.

• break: após a execução da regra atual, as regras de reescrita subsequentes deixam de ser executadas.

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

break

Parameter

Type

Required

Description

Example

delete_argument

String

No

Lista de parâmetros a excluir. Separe múltiplos parâmetros com espaços.

code1

save_argument

String

No

Lista de parâmetros a reter. Separe múltiplos parâmetros com espaços. Somente os parâmetros listados são mantidos. As ações de adição e exclusão de parâmetros continuam em vigor.

Empty

ignore_all_argument

String

No

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

• on: ignora todos os parâmetros. Apenas o recurso de adição de parâmetros permanece ativo. Os recursos de exclusão, retenção exclusiva e modificação de parâmetros tornam-se inefetivos.

• off (padrão): não ignora todos os parâmetros. Os recursos de retenção, adição e exclusão de parâmetros permanecem ativos.

on

add_argument

String

No

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

value=123

modify_argument

String

No

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

value=321

enable

String

Yes

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

• on: ativa o recurso.

• off: desativa o recurso.

on

Parameter

Type

Required

Description

Example

enabled

String

Yes

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

• L2: ativa o recurso.

• off: desativa o recurso.

l2

bucketname

String

No

O nome do bucket do Amazon S3.

/

accesskey

String

Yes

O AccessKey da AWS.

123456789

secretkey

String

Yes

O SecretKey da AWS.

12345678

region

String

Yes

A região de armazenamento do Amazon S3.

us-east-2

Parameter

Type

Required

Description

Example

enabled

String

Yes

Indica 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

No

A lista de domínios na lista de permissões do certificado. É possível configurar vários domínios, separando-os por vírgula (,). Certificados que correspondam a esses domínios passam pela verificação.

example.com

Parameter

Type

Required

Description

Example

ali_origin_dns_host

String

Yes

O nome de domínio usado para consulta DNS durante o fetch de origem.

example.com

Parameter

Type

Required

Description

Example

origin

String

Yes

A URL de origem específica. Também é possível deixar este campo sem especificação, definindo o parâmetro origin como all, o que representa todos os servidores de origem.

example.com

host

String

Yes

O host específico. Também é possível deixar este campo sem especificação, definindo o parâmetro host como ali_follow_origin, o que faz com que o valor do host acompanhe a URL de origem.

host.example.com

Parameter

Type

Required

Description

Example

port

String

Yes

A porta de origem.

80

scheme

String

Yes

O protocolo de origem. É possível personalizar o protocolo de origem. Valores válidos: http, https, follow, https_sm e follow_sm.

• http: o fetch de origem é realizado via HTTP.

• https: o fetch de origem é realizado via HTTPS com algoritmo internacional.

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

  • Se o cliente usa HTTP, o fetch de origem também utiliza HTTP.

  • O cliente se comunica via protocolo HTTPS.

    • Se o cliente usa um algoritmo internacional, o fetch de origem utiliza HTTPS com algoritmo internacional.

    • Se o cliente usa um algoritmo criptográfico chinês, o fetch de origem utiliza HTTPS com algoritmo internacional.

• https_sm: o fetch de origem é realizado via HTTPS com algoritmo criptográfico chinês.

• follow_sm: o serviço segue o protocolo utilizado pelo cliente, HTTP ou HTTPS. Os algoritmos RSA e SM são ambos suportados.

  • O cliente usa o protocolo HTTP para o fetch de origem.

  • O cliente usa o protocolo HTTPS.

    • Se o cliente usa um algoritmo internacional, o fetch de origem utiliza HTTPS com algoritmo internacional.

    • Se o cliente usa um algoritmo criptográfico chinês, o fetch de origem utiliza HTTPS com algoritmo criptográfico chinês.

http

Parameter

Type

Required

Description

Example

origin

String

Yes

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

example.com

sni_host

String

Yes

O valor do host SNI:

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

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

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

example.org

keepalive_sni

String

No

Indica se o matching de SNI deve ser ativado para conexões persistentes. Valores válidos:

• on: ativa o recurso.

• off: desativa o recurso.

/

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 corresponde a pouco mais de 3 anos.

500000

file_type

String

Yes

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

jpg

weight

Integer

No

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

1

swift_origin_cache_high

String

No

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

• on: ativado

• off (padrão): desativado

off

swift_no_cache_low

String

No

Ignora os cabeçalhos de resposta no-cache do servidor de origem. Ao defina este parâmetro como on, os seguintes cabeçalhos de resposta no-cache do servidor de origem são ignorados.

• Cache-Control: no-store

• Cache-Control: no-cache

• Cache-Control: max-age=0

• Pragma: no-cache

Valores válidos:

• on: ativado

• off (padrão): desativado

off

swift_follow_cachetime

String

No

Permite que os clientes sigam a política de cache do DCDN. Ao defina este parâmetro como on, a política de cache final do DCDN é retornada ao cliente. Valores válidos:

• on: ativado

• off (padrão): desativado

off

force_revalidate

String

No

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

• on: ativado. Quando o TTL é 0, o conteúdo é armazenado em cache nos points of presence (POPs), e cada requisiçã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 requisição exige uma busca na origem para recuperar o conteúdo.

off

Parameter

Type

Required

Description

Example

ttl

Integer

Yes

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

500000

path

String

Yes

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

/example/demo

weight

Integer

No

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

1

swift_origin_cache_high

String

No

Prioriza a política de cache do servidor de origem. Ao definir este parâmetro como on, a política de cache do servidor de origem tem precedência quando ele retorna headers relacionados ao cache, como Cache-Control e Pragma. Valores válidos:

• on: enabled

• off (default): disabled

off

swift_no_cache_low

String

No

Ignora os headers de resposta no-cache do servidor de origem. Ao definir este parâmetro como on, os seguintes headers de resposta no-cache do servidor de origem são ignorados.

• Cache-Control: no-store

• Cache-Control: no-cache

• Cache-Control: max-age=0

• Pragma: no-cache

Valores válidos:

• on: enabled

• off (default): disabled

off

swift_follow_cachetime

String

No

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

• on: enabled

• off (default): disabled

off

force_revalidate

String

No

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

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

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

off

Parameter

Type

Required

Description

Example

file_type

String

Yes

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

jpg

code_string

String

Yes

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

403=10

swift_code_origin_cache_high

String

No

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

• on: enabled

• off (default): disabled

off

swift_code_no_cache_low

String

No

Ignore os cabeçalhos de resposta no-cache do servidor de origem. Ao definir este parâmetro como on, os seguintes cabeçalhos de resposta no-cache do servidor de origem são ignorados.

• Cache-Control: no-store

• Cache-Control: no-cache

• Cache-Control: max-age=0

• Pragma: no-cache

Valores válidos:

• on: enabled

• off (default): disabled

off

swift_code_follow_cachetime

String

No

Permita que os clientes sigam a política de cache do DCDN. Ao definir este parâmetro como on, a política de cache final do DCDN é retornada ao cliente. Valores válidos:

• on: enabled

• off (default): disabled

off

force_revalidate

String

No

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

• on: enabled. Quando o TTL é 0, o conteúdo é armazenado em cache nos POPs e cada requisição exige um fetch da origem para validar o conteúdo em cache.

• off (default): disabled. Quando o TTL é 0, o conteúdo não é armazenado em cache nos POPs e cada requisição exige um fetch da origem para recuperar o conteúdo.

off

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

path

String

Sim

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

/example/demo

code_string

String

Sim

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

403=10,404=15

swift_code_origin_cache_high

String

Não

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

• on: ativado

• off (padrão): desativado

off

swift_code_no_cache_low

String

Não

Ignora cabeçalhos de resposta no-cache provenientes do servidor de origem. Ao definir este parâmetro como on, os seguintes cabeçalhos de resposta no-cache do servidor de origem são ignorados.

• Cache-Control: no-store

• Cache-Control: no-cache

• Cache-Control: max-age=0

• Pragma: no-cache

Valores válidos:

• on: ativado

• off (padrão): desativado

off

swift_code_follow_cachetime

String

Não

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

• on: ativado

• off (padrão): desativado

off

force_revalidate

String

Não

Força a validação do 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 requisiçã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 requisição exige uma busca na origem para recuperar o conteúdo.

off

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

default_ttl_code

String

Sim

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

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

Parameter

Type

Required

Description

Example

key

String

Yes

O cabeçalho de resposta.

Cache-Control

value

String

Yes

O valor do cabeçalho de resposta. Separe múltiplos valores com vírgulas (,).

no-cache

header_operation_type

String

No

A operação a ser executada no cabeçalho de requisição. Os valores possíveis são:

• add: adiciona uma entrada.

• Delete: exclui.

• Modify: modifica.

• rewrite: substitui um cabeçalho.

add

duplicate

String

No

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

• on: duplicatas são permitidas.

• off: não permite duplicatas.

off

header_source

String

No

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

value1

header_destination

String

No

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

value123

match_all

String

No

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

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

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

/

access_origin_control

String

No

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

• on: os POPs do DCDN autenticam as requisições de usuários entre domínios.

• off: desativa este recurso.

/

Parameter

Type

Required

Description

Example

error_code

Integer

Yes

O código de erro.

404

rewrite_page

String

Yes

A página de redirecionamento.

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

Parameter

Type

Required

Description

Example

regex

String

Yes

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

^/hello$

replacement

String

Yes

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

/hello/test

flag

String

No

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

• Empty: Valor padrão — indica que o parâmetro flag não foi informado. Quando múltiplas regras estão configuradas e o URL da requisição corresponde a uma delas, o POP continua verificando as regras subsequentes após executar a regra atual.

• break: Se o URL da requisição corresponder a uma regra, a requisição é reescrita para o URL de destino. Os parâmetros do URL original não são alterados. Após a execução da regra atual, nenhuma outra regra é verificada.

• redirect: Se o URL da requisição corresponder a uma regra, a requisição é redirecionada para o URL de destino com o código de status 302. O POP do DCDN retorna o URL de destino como cabeçalho Location ao cliente. Os parâmetros do URL original não são alterados. Após a execução da regra atual, as regras subsequentes continuam sendo verificadas.

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

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

redirect

rewrite_method

String

No

O 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 requisição GET não é alterado. Outros métodos de requisição podem ser convertidos para GET.

• 303: O método de requisição GET não é alterado. Outros métodos de requisição são convertidos para GET e o corpo da mensagem é descartado.

• 307: O método de requisição e o corpo da mensagem não são alterados.

302

Parameter

Type

Required

Description

Example

uri

Array of String

No

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

• uri_to_rewrite especifica a URI de origem.

• ai_uri_regex especifica a URI de destino.

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

args

Array of String

No

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

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

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

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

headers

String

No

Adiciona múltiplos HTTP headers e os anexa à cache key. Separe vários HTTP headers com espaços.

example

variable

Array of String

No

Uma variável personalizada. É possível usar uma expressão regular para extrair qualquer campo dos parâmetros da requisição, HTTP headers, cookies ou URI na URL da requisição e, em seguida, anexá-lo à cache key.

[]

Parameter

Type

Required

Description

Example

share_host

String

Yes

O nome de domínio de destino que pode compartilhar cache com o nome de domínio atual. Essa configuração não modifica o header Host nas requisições de origem. Ela utiliza apenas o valor de share_host para gerar a cache key e consultar os recursos em cache.

example.com

Parameter

Type

Required

Description

Example

origin_error_status_code

String

No

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

• Descrição: especifique 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 timeout ou qualquer código de status 5xx.

• Configuração: insira 4xx ou 5xx para uma correspondência genérica, ou insira códigos de status específicos como 502 ou 504 para uma correspondência exata. Para especificar múltiplos códigos de status, separe-os com vírgulas (,).

502

extend_expiration_time

Integer

No

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

No

Priorizar política de origem.

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

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

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

on

Parameter

Type

Required

Description

Example value

http2

String

No

Especifica se o HTTP/2 deve ser ativado:

• on: ativa o recurso.

• off: desativa o recurso.

on

ocsp_stapling

String

No

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

• on: ativa o recurso.

• off: desativa o recurso.

on

Parameter

Type

Required

Description

Example value

enable

String

Yes

Indica se o redirecionamento forçado para HTTP está ativado.

• on: Ativa o recurso.

• off: Desativa o recurso.

on

http_rewrite

String

No

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

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

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

301

Parameter

Type

Required

Description

Example

enable

String

Yes

Indica se o redirecionamento forçado para HTTPS está ativado:

• on: Ativa o recurso.

• off: Desativa o recurso.

on

https_rewrite

String

No

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

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

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

301

Parameter

Type

Required

Description

Example value

tls10

String

No

Especifica se o TLSv1.0 deve ser ativado:

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

• Off: A instância é desligada.

on

tls11

String

No

Especifica se o TLSv1.1 deve ser ativado:

• on (padrão): Ativado.

• off: Indica desligamento.

on

tls12

String

No

Especifica se o TLSv1.2 deve ser ativado:

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

• Off: Desligado.

on

tls13

String

No

Especifica se o TLSv1.3 deve ser ativado:

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

• off: Desligado.

on

ciphersuitegroup

String

No

O grupo de cipher suites:

• all (padrão): Todas as cipher suites.

• strict: Cipher suites fortes.

• custom: Cipher suites personalizadas.

all

ciphersuite

String

No

As cipher suites personalizadas. Este parâmetro é válido somente quando ciphersuitegroup está definido como custom. Especifique múltiplas cipher suites separadas 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

Parameter

Type

Required

Description

Example value

enabled

String

Yes

Ative o HSTS:

• Enabled.

• off: Desliga o sistema.

on

https_hsts_max_age

Integer

Yes

O tempo de expiração em segundos.

5184000

https_hsts_include_subdomains

String

No

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

off

Parameter

Type

Required

Description

Example

refer_domain_allow_list

String

Yes

A lista de permissões. Separe múltiplos nomes de domínio com vírgulas (,).

example.aliyundoc.com,demo.aliyundoc.com

allow_empty

String

No

Define se o acesso a recursos 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. Quando o Referer de uma requisição do usuário não corresponde a nenhum nome de domínio da lista de permissões, o DCDN retorna o código de status 302 com essa URL como valor do cabeçalho Location, em vez de retornar um erro 403. A URL deve começar com http:// ou https://.

http://www.example.com

disable_ast

String

No

Ativa o modo de correspondência exata, controlando se os nomes de domínio da lista de permissões são comparados de forma exata. Ao definir este parâmetro como on, a correspondência exata é aplicada.

• Quando definido como on:

  • A correspondência exata é suportada.

    • Se a lista de permissões contiver example.com, ela corresponde a example.com.

    • Se a lista de permissões contiver a*b.example.com, ela corresponde a a<any string>b.example.com.

  • A correspondência por sufixo não é suportada.

• Quando definido como off (padrão):

  • A correspondência exata não é suportada.

  • A correspondência por sufixo é suportada.

    • Se a lista de permissões contiver example.com, ela corresponde a example.com e a <any string>.example.com.

    • Se a lista de permissões contiver a*b.example.com, ela corresponde a a<any string>b.example.com e a <any string>.a<any string>b.example.com.

off

ignore_scheme

String

No

Define se o scheme deve ser ignorado. Quando ativado, um Referer em uma requisição do usuário é considerado válido mesmo que não inclua o cabeçalho de protocolo HTTP ou HTTPS. Exemplos:

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

  referer: www.example.com

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

  referer: https://www.example.com

off

Parameter

Type

Required

Description

Example

refer_domain_deny_list

String

Yes

A lista negra. Separe múltiplos nomes de domínio com vírgulas (,).

example.aliyundoc.com,demo.aliyundoc.com

allow_empty

String

No

Especifica se o acesso aos recursos DCDN será permitido quando o campo Referer estiver vazio:

• on: Permite o acesso.

• off: Nega o acesso.

off

redirect_url

String

No

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

http://www.example.com

disable_ast

String

No

Ativa o modo de correspondência exata, controlando se os nomes de domínio da lista negra são correspondidos de forma exata. Ao definir este parâmetro como on, a correspondência exata é utilizada.

• Quando definido como on:

  • A correspondência exata é suportada.

    • Se a lista negra contiver example.com, ela corresponde a example.com.

    • Se a lista negra contiver a*b.example.com, ela corresponde a a<any string>b.example.com.

  • A correspondência por sufixo não é suportada.

• Quando definido como off (padrão):

  • A correspondência exata não é suportada.

  • A correspondência por sufixo é suportada.

    • Se a lista negra contiver example.com, ela corresponde a example.com e a <any string>.example.com.

    • Se a lista negra contiver a*b.example.com, ela corresponde a a<any string>b.example.com e a <any string>.a<any string>b.example.com.

off

ignore_scheme

String

No

Especifica se o scheme será ignorado. Quando ativado, um Referer em uma requisição do usuário é considerado válido mesmo que não inclua o cabeçalho de protocolo HTTP ou HTTPS. Exemplos:

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

  referer: www.example.com

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

  referer: https://www.example.com

off

Parameter

Type

Required

Description

Example

auth_m3u8

String

No

Ativa a reescrita de conteúdo M3U8. 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 do tipo A.

• type_b: assinatura do tipo B.

• type_c: assinatura do tipo C.

• type_f: assinatura do 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 nessa lista ficam isentos da verificação de assinatura.

É possível informar múltiplos endereços IP. Separe-os com vírgulas (,).

192.168.0.1

req_auth_ip_acl_xfwd

String

No

O método para obter o endereço IP do cliente na 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 requisição do usuário. Esse endereço IP é o IP de origem do cliente.

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

• all: o DCDN verifica os dois endereços IP a seguir:

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

  • O endereço IP utilizado 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 somente quando auth_type está definido como type_f.

sign

time_param

String

No

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

time

time_format

String

No

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

• dec: decimal

• hex: hexadecimal

hec

path_encoding

String

No

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

on

Parameter

Type

Required

Description

Example

enable

String

Yes

Indica se a autenticação remota está ativa. Valores válidos:

• Enabled.

• Off: Shutdown.

on

remote_auth_addr

String

Yes

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

https://example.aliyundoc.com/auth

remote_auth_method

String

Yes

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

get

remote_auth_type

String

Yes

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

all

remote_auth_reserve_args

String

Yes

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

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

• ali_delete_all_args: Exclua todos os parâmetros de URL.

all

remote_auth_custom_args

String

No

Os parâmetros personalizados a serem adicionados. Para especificar múltiplos parâmetros, separe-os com barras verticais (|). Os parâmetros diferenciam maiúsculas de minúsculas. Por exemplo, key é diferente de KEY.

empty

remote_auth_reserve_header

String

Yes

Os cabeçalhos de requisição a serem mantidos. Para especificar múltiplos cabeçalhos, separe-os com barras verticais (|). Os cabeçalhos não diferenciam maiúsculas de minúsculas. Por exemplo, http_remote_addr é equivalente a HTTP_Remote_Addr.

• all: Retém todos os cabeçalhos de requisição.

• ali_delete_all_headers: Exclua todos os cabeçalhos de requisição.

all

remote_auth_custom_header

String

No

Os cabeçalhos de requisição personalizados a serem adicionados. Para especificar múltiplos cabeçalhos, separe-os com barras verticais (|). Os cabeçalhos não diferenciam maiúsculas de minúsculas. Por exemplo, http_remote_addr é equivalente a HTTP_Remote_Addr.

empty

remote_auth_success_code

Integer

Yes

O código de status para autenticação bem-sucedida. Trata-se do resultado que o servidor de autenticação retorna ao DCDN após uma autenticação bem-sucedida. Exemplo: 200. É possível especificar múltiplos códigos de status — separe-os com vírgulas (,).

200

remote_auth_fail_code

Integer

Yes

O código de status para autenticação malsucedida. Trata-se do resultado que o servidor de autenticação retorna ao DCDN após uma falha de autenticação. Exemplo: 403. É possível especificar múltiplos códigos de status — separe-os com vírgulas (,).

403,404

remote_auth_other_code_act

String

No

A ação que o DCDN executa sobre uma requisição do usuário quando o código de status retornado pelo servidor de autenticação não é nem de sucesso nem de falha. Valores válidos:

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

• reject: Nega a requisiçã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 de autenticação. Exemplo: 403.

403

remote_auth_timeout

Integer

Yes

O período de timeout da autenticação. Unidade: ms. O valor máximo é 3000.

500

remote_auth_timeout_action

String

Yes

A ação a ser executada quando a autenticação atinge o timeout. Valores válidos:

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

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

pass

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

ip_list

String

Sim

A lista de IP. Separe múltiplos endereços IP ou blocos CIDR com vírgulas (,).

192.168.0.1/24

customize_response_status_code

String

Não

O código de status de resposta personalizado. O valor padrão é vazio, o que indica que o código de status de 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

Não

Especifica se o endereço IP do cabeçalho X-Forwarded-For deve ser utilizado. Valores válidos:

• on: Valor padrão. O DCDN utiliza o primeiro endereço IP à esquerda no cabeçalho x-forwarded-for da requisição do usuário para verificação.

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

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

all

ip_list_notes

String

Não

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

192.x.x.1 (Malicious)

192.x.x.2 (Illegal)

Parameter

Type

Required

Description

Example

ip_list

String

Yes

A lista de endereços IP. Separe múltiplos 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 de 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

Especifica se o endereço IP do cabeçalho X-Forwarded-For deve ser utilizado. Valores válidos:

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

• off: utiliza o actual source IP address.

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

all

ip_list_notes

String

No

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

192.x.x.1 (Malicious)

192.x.x.2 (Illegal)

Parameter

Type

Required

Description

Example

ua

String

Yes

As strings do User-Agent. O caractere curinga () é suportado para corresponder a qualquer string. Para especificar múltiplos 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.

black

Parameter

Type

Required

Description

Example

enable

String

Yes

Define se a aceleração da otimização de HTML deve ser ativada.

• on: Ativa o recurso.

• off: Desativa o recurso.

on

trim_js

String

No

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

• on: Ativa o recurso.

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

off

trim_css

String

No

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

• on: Ativa a otimização.

• off (padrão): Estado desativado.

off

Parameter

Type

Required

Description

Example

enable

String

Yes

Define se a otimização Gzip deve ser ativada para as páginas.

• on: Ativa o recurso.

• off: Desativa o recurso.

on

Parameter

Type

Required

Description

Example

enable

String

Yes

Define se a compressão Brotli deve ser ativada para as páginas.

• on: Ativa o recurso.

• off: Desativa o recurso.

on

Parameter

Type

Required

Description

Example

hashkey_args

String

No

A lista de parâmetros a reter. Separe múltiplos parâmetros com vírgulas (,). É possível especificar até 10 parâmetros.

key1,key2

disable

String

Yes

Especifica se todos os parâmetros devem ser ignorados.

• on: ignora todos os parâmetros. Os recursos para excluir, reter e modificar parâmetros são desativados. Apenas o recurso de adição de parâmetros permanece efetivo.

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

on

keep_oss_args

String

Yes

Especifica se os parâmetros devem ser retidos nas requisições de busca de origem.

• on: retém todos os parâmetros nas requisições de busca de origem.

• off: os parâmetros nas requisições de busca de origem são os mesmos da chave de hash de cache.

on

Parameter

Type

Required

Description

Example

ali_remove_args

String

Yes

Os parâmetros a excluir. Separe múltiplos parâmetros com espaços.

test

keep_oss_args

String

Yes

Especifica se os parâmetros devem ser retidos nas requisições de busca de origem.

• on: retém todos os parâmetros nas requisições de busca de origem.

• off: os parâmetros nas requisições de busca de origem são os mesmos da chave de hash de cache.

off

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

enable

String

Sim

Especifica se a transformação de imagens deve ser ativada.

• on: Ativa o recurso.

• off: Desativa o recurso.

on

filetype

String

Sim

Os formatos de imagem compatíveis com transcodificação. Separe múltiplos formatos com uma barra vertical (|). Os seguintes valores são aceitos:

• 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

Não

Especifica se a conversão automática para WebP deve ser ativada.

• on: Ativa a conversão.

• off: A instância é desligada.

on

orient

String

Não

Especifica se a rotação automática de imagens deve ser ativada.

• on: O recurso está ativado.

• off: O recurso está desativado.

on

slim

Integer

Não

Emagrecimento de imagem. Defina o percentual de emagrecimento. O valor pode ser de 0 a 100. Esse recurso reduz a qualidade da imagem para economizar tráfego sem alterar a resolução, as dimensões ou o formato.

10

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

enable

String

Sim

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

• on: Ativa a busca.

• off: Desativa a busca.

• force: Força a ativação.

on

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

enable

String

Sim

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

• on: Ativar.

• off: Desativar.

on

flv_seek_by_time

String

Não

Define se a busca por tempo para arquivos FLV deve ser ativada.

• on: Ativar.

• off: Desativar.

on

mp4_seek_start

String

Não

Parâmetro de início personalizado para arquivos MP4.

mp4starttime

mp4_seek_end

String

Não

Parâmetro de fim personalizado para arquivos MP4.

mp4endtime

flv_seek_start

String

Não

Parâmetro de início personalizado para arquivos FLV.

flvstarttime

flv_seek_end

String

Não

Parâmetro de fim personalizado para arquivos FLV.

flvendtime

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

enable

String

Sim

Define se a reprodução somente de áudio deve ser ativada.

• on: Ativar.

• off: Desativar.

on

Parameter

Type

Required

Description

Example

enable

String

Yes

Especifica se a pré-visualização de vídeo deve ser ativada.

• on: Ativa.

• off: Desativa.

on

ali_video_preview_argument

String

Yes

O nome de parâmetro personalizado para pré-visualização de vídeo. O valor deste parâmetro deve ser expresso em segundos.

fds

Parameter

Type

Required

Description

Example

enable

String

Yes

Especifica se a criptografia e reescrita de M3U8 deve ser ativada.

• on: Ativa.

• off: Desativa.

on

hls_token_arg_name

String

No

O nome de parâmetro personalizado para o token HLS. Se este parâmetro não for definido, MtsHlsUriToken será usado como nome de parâmetro padrão.

example

Parameter

Type

Required

Description

Example

cc_protect_status

String

Yes

O switch para CC inteligente. O valor padrão é on.

on

cc_slow_sample_ratio

String

Yes

A taxa de amostragem de log. O valor padrão é 10.

10

cc_charge_status

String

Yes

O switch para análise inteligente. O valor padrão é on.

on

Parameter

Type

Required

Description

Example value

ali_limit_rate

String

Yes

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

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

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

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

ali_limit_rate_after

String

No

A quantidade de dados a enviar antes de o limite de taxa entrar em vigor. O valor é um número seguido de uma unidade. As unidades suportadas são k para KByte e m para MByte.

1000

traffic_limit_arg

String

No

O nome do parâmetro de limite de taxa. A taxa é limitada com base no argumento extraído da URL. Por exemplo, rate.

Se a requisição não contiver esse parâmetro, o limite de taxa padrão definido por ali_limit_rate é aplicado. Para desativar o limite de taxa quando esse parâmetro não estiver presente na requisição, defina ali_limit_rate como 0k.

rate

traffic_limit_unit

String

No

A unidade para o parâmetro traffic_limit_arg. As unidades suportadas são m (MByte/s) e k (KByte/s). Por exemplo, se este parâmetro for definido como m e a URL da requisição contiver rate=1, o limite de taxa efetivo será de 1 MByte/s.

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

m

ali_limit_start_hour

Integer

No

O horário de início para o limite de taxa. O valor deve ser um número inteiro de 0 a 24 e deve ser menor que o horário de término. O valor padrão é 0.

20

ali_limit_end_hour

Integer

No

O horário de término para o limite de taxa. O valor deve ser um número inteiro de 0 a 24 e deve ser maior que o horário de início. O valor padrão é 24.

23

Parameter

Type

Required

Description

Example value

enabled

String

Yes

Indica se o WebSocket deve ser ativado.

• on: Ativa o recurso.

• off: Desativa o recurso.

on

origin_scheme

String

No

O protocolo para requisições de busca na origem via WebSocket. Valores válidos:

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

• https: o WebSocket usa HTTPS para busca na origem. O servidor de origem deve suportar a porta 443.

• follow: o WebSocket utiliza o mesmo protocolo da requisição do cliente. O servidor de origem deve suportar a porta 443 ou a porta 80.

http

heartbeat

String

No

O tempo limite da conexão.

• Intervalo de valores: 1 a 300

• Unidade: segundos

• Valor padrão: 60

60

Parameter

Type

Required

Description

Example

rule

String

Yes

A regra DSL.

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

pri

Integer

Yes

A prioridade. Valores válidos: [0, 999]. Quanto menor o valor, maior a prioridade.

0

enable

String

Yes

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

• on: A regra está ativada.

• off: A regra está desativada.

on

name

String

Yes

O nome da regra. Somente letras e sublinhados (_) são aceitos.

test

pos

String

No

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

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

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

head

brk

String

No

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

• on: Se esta regra for acionada, as demais regras na posição de execução atual são ignoradas.

• off (padrão): Se esta regra for acionada, as demais regras continuam sendo executadas.

off

option

String

No

O campo de extensão.

empty

grammar

String

No

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

/

jsmode

String

No

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

• redirect: Modo de bloqueio.

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

/

Parâmetro

Tipo

Obrigatório

Descrição

Valor de exemplo

rule

Array

Sim

O conteúdo da regra condicional, incluindo 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 IP do endereço IP de conexão do cliente é v6.

Parâmetro

Descrição

"match":

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

"logic":"and"

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

"criteria"

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

"matchType":"clientipVer"

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

"matchObject":"CONNECTING_IP"

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

"matchOperator":"equals"

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

"matchValue":"v6"

matchValue especifica o valor predefinido a ser comparado com as informações na requisição do usuário.

"negate":false

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

"name":"example"

name especifica o nome da regra condicional.

"status":"enable"

status especifica o status da regra condicional.

Parâmetro

Tipo

Obrigatório

Descrição

Valor de exemplo

iquic_enable

String

Sim

Indica se o protocolo QUIC está ativo:

• on: Ativar

• off: Desativar

on