Parâmetros para configuração de recursos em nomes de domínio - CDN: Central de Documentação do Alibaba Cloud

Este tópico descreve os recursos e parâmetros configuráveis ao chamar as operações BatchSetCdnDomainConfig ou SetCdnDomainStagingConfig para definir funcionalidades em nomes de domínio. Cada recurso é identificado por um nome de função e um ID numérico, transmitido como elemento no array Functions do corpo da requisição.

Estrutura da requisição

Ao chamar BatchSetCdnDomainConfig (ambiente de produção) ou SetCdnDomainStagingConfig (ambiente de staging) para configurar recursos de nome de domínio, o corpo da requisição contém um array Functions. Cada elemento desse array especifica um functionName e um ou mais functionArgs como pares chave-valor (argName e argValue).

{
    "Functions": [{
        "functionArgs": [{
            "argName": "<parameter-name>",
            "argValue": "<parameter-value>"
        }],
        "functionName": "<feature-name>"
    }],
    "DomainNames": "example.com"
}

Nota

As operações listadas abaixo permitem referenciar os recursos descritos neste tópico: - Ambiente de produção: BatchSetCdnDomainConfig, DescribeCdnDomainConfigs, BatchDeleteCdnDomainConfig e DescribeCdnUserDomainsByFunc.

Ambiente de staging: SetCdnDomainStagingConfig, DescribeCdnDomainStagingConfig, RollbackStagingConfig e PublishStagingConfigToProduction.

A chamada a BatchSetCdnDomainConfig ou SetCdnDomainStagingConfig gera um ConfigId exclusivo para a configuração. Utilize esse ConfigId para atualizar ou excluir a configuração. Para mais informações, consulte ConfigId Usage Notes. - Alguns recursos apresentam conflitos entre si. Configure apenas um recurso de cada par conflitante por vez. Os pares conflitantes estão indicados nas seções correspondentes abaixo.

Configurações de rede

ipv6

Descrição: Configura o acesso IPv6.
ID da função: 194
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
switch	String	Sim	Defina se o acesso IPv6 deve ser ativado. Valores válidos: `on`, `off`.	on
region	String	Sim	Região onde o IPv6 está habilitado. Use um asterisco (`*`) para todas as regiões.	*

Exemplo:

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

Configurações de source

set_req_host_header

Descrição: Defina o host de source padrão.
ID da função: 18
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
domain_name	String	Sim	Conteúdo do cabeçalho de host de source.	example.com

Exemplo:

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

forward_scheme

Descrição: Configura o protocolo de source.
ID da função: 47
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
enable	String	Sim	Indica se o recurso de protocolo de source deve ser ativado. Valores válidos: `on`, `off`.	on
scheme_origin	String	Não	Esquema de protocolo para busca na source. Valores válidos: `http`, `https`, `follow`. Valor padrão: `follow`.	follow
scheme_origin_port	String	Não	Portas personalizadas de source. Obrigatório quando `scheme_origin` estiver definido como `follow` (formato: `httpPort:httpsPort`, por exemplo, `80:443`).	80:443

Exemplo:

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

l2_oss_key

Descrição: Configura a busca em source de Bucket OSS privado. Ao utilizar este recurso pela primeira vez, ative a política de permissão padrão, que concede ao CDN acesso somente leitura a todos os Buckets OSS na mesma conta Alibaba Cloud.
ID da função: 85
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
private_oss_auth	String	Sim	Defina se a busca em source de Bucket OSS privado deve ser ativada. Valores válidos: `on`, `off`. Quando ativado, o sistema configura automaticamente tokens de segurança STS. Suporta apenas busca de source de domínio CDN para Buckets privados OSS na mesma conta Alibaba Cloud.	on
perm_private_oss_tbl	String	Não	Configuração de token de segurança permanente. Formato: access_id=123 access_secret=123abc (separado por espaço). Quando configurado, também permite busca de source de domínio CDN para Buckets privados OSS em outras contas Alibaba Cloud.	access_id=123 access_secret=123abc

Exemplo:

{
    "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: Configura a lista de chaves privadas de source OSS. Permite definir uma ou mais regras representando diferentes Buckets privados OSS com seus respectivos tokens de segurança.
ID da função: 183
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
host	String	Sim	Endereço completo do Bucket OSS.	example.oss-cn-hangzhou.aliyuncs.com
key	String	Sim	Configuração de token de segurança permanente. Formato: access_id=123 access_secret=123abc (separado por espaço).	access_id=123 access_secret=123abc

Exemplo:

{
    "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: Configura o SNI (Server Name Indication) de source.
ID da função: 114
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
enabled	String	Sim	Defina se o SNI de source deve ser ativado. Valores válidos: `on`, `off`.	on
https_origin_sni	String	Sim	Informação SNI transportada nas requisições de source (endereço do servidor de source que a requisição precisa acessar).	origin.example.com

Exemplo:

{
    "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: Defina o tempo limite da requisição de source.
ID da função: 124
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
forward_timeout	Integer	Sim	Tempo limite da requisição em segundos. Recomenda-se definir um valor inferior a 100 segundos.	30

Exemplo:

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

advanced_origin

Descrição: Configura a busca avançada na source, roteando requisições para diferentes servidores de source com base em variáveis da requisição do usuário (como URI, cabeçalhos, parâmetros de consulta ou cookies).
ID da função: 235
Conflito: Conflita com origin_dns_host (ID da função: 212). Apenas um pode ser configurado. Se um dos recursos já estiver configurado (inclusive quando seu parâmetro switch estiver definido como off), exclua a configuração existente antes de configurar o outro.
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
variable_type	String	Sim	Tipo da variável. Valores válidos: `header` (cabeçalho da requisição), `arg` (parâmetro de query string), `uri` (caminho da requisição), `cookie` (cookie da requisição).	uri
variable	String	Sim	Nome da variável. Quando variable_type for definido como uri, a variável deve ser definida como uri.	uri
conditions	String	Sim	Operador de condição. Valores válidos: == (igual), != (diferente).	==
value	String	Sim	Valor da variável a ser correspondido.	/image
origin	String	Sim	Nome de domínio do servidor de source a ser usado quando a variável corresponder ao valor especificado.	origin.example.com

Exemplo:

{
    "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: Configura o seguimento de redirecionamento 302 na source.
ID da função: 219
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
enable	String	Sim	Defina se o seguimento de redirecionamento 302 na source deve ser ativado. Valores válidos: `on`, `off`.	on
max_tries	Integer	Não	Número máximo de redirecionamentos 302 a seguir. Valor padrão: 2. Valores válidos: 1-5. O número real máximo de requisições à source é max_tries + 1.	2
retain_args	String	Não	Indica se os parâmetros originais da requisição devem ser mantidos ao seguir redirecionamentos 302. Valores válidos: `on`, `off` (padrão).	off
retain_header	String	Não	Indica se os cabeçalhos originais da requisição devem ser mantidos ao seguir redirecionamentos 302. Valores válidos: `on`, `off` (padrão).	off
response_header	String	Não	Nome do cabeçalho de resposta para redirecionamento 302. Valor padrão: Location.	X-Alicdn-Redirect
retain_host	String	Não	Indica se o host de source deve ser mantido ao seguir redirecionamentos 302. Valores válidos: `on`, `off` (padrão).	off
modify_host	String	Não	Modifique o host de source ao seguir redirecionamentos 302. Por padrão, o host de source não é modificado.	example.com
cache	String	Não	Defina se os resultados de redirecionamento 302 para a mesma URL devem ser armazenados em cache para melhorar o desempenho de resposta do CDN. Valores válidos: `on`, `off` (padrão).	off
expired_time	Integer	Não	Tempo de expiração do cache para resultados de redirecionamento 302, em segundos. Deve ser usado junto com o parâmetro cache. Valor padrão: 3.600.	7.200
follow_origin_host	String	Não	Defina se o nome de domínio do servidor de source deve ser usado como host de source (utiliza o domínio de source mais recente mesmo após alternância primário/standby). Valores válidos: `on`, `off` (padrão).	off
follow_5xx_retry_origin	String	Não	Indica se deve alternar para o próximo servidor de source disponível quando a source atual responder com um código de status 5xx. Valores válidos: `on`, `off` (padrão).	off

Exemplo:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "enable",
            "argValue": "on"
        }, {
            "argName": "max_tries",
            "argValue": "2"
        }, {
            "argName": "retain_args",
            "argValue": "off"
        }, {
            "argName": "retain_header",
            "argValue": "off"
        }],
        "functionName": "follow_302"
    }],
    "DomainNames": "example.com"
}

set_req_header

Descrição: Configura cabeçalhos personalizados de requisição HTTP de source (v1). Recomendamos usar a versão v2: origin_request_header, que oferece suporte a mais recursos.
ID da função: 39
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
key	String	Sim	Nome do cabeçalho de requisição de source.	Accept-Encoding
value	String	Sim	Valor do cabeçalho de requisição de source. Para excluir um cabeçalho, defina o valor como null.	gzip

Exemplo:

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

origin_request_header

Descrição: Configura cabeçalhos personalizados de requisição HTTP de source (v2). Suporta operações de adição, exclusão, modificação e reescrita.
ID da função: 228
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
header_operation_type	String	Sim	Tipo de operação no cabeçalho. Valores válidos: `add`, `delete`, `modify`, `rewrite`.	add
header_name	String	Sim	Nome do cabeçalho da requisição.	Accept-Encoding
header_value	String	Não	Valor do cabeçalho da requisição. Múltiplos valores podem ser separados por vírgulas (,).	gzip
duplicate	String	Não	Defina se cabeçalhos duplicados com o mesmo nome são permitidos (ao usar a operação add). Valores válidos: `on`, `off`.	off
header_source	String	Não	Valor a ser buscado para substituição (ao usar a operação rewrite). Suporta expressões regulares.	value1
header_destination	String	Não	Valor de substituição (ao usar a operação rewrite).	value123
match_all	String	Não	Modo de correspondência (ao usar a operação rewrite). Valores válidos: `on` (substituir todas as correspondências), `off` (substituir apenas a primeira correspondência).	off

Exemplo:

{
    "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: Configura cabeçalhos de resposta HTTP de source. Suporta operações de adição, exclusão, modificação e reescrita.
ID da função: 229
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
header_operation_type	String	Sim	Tipo de operação no cabeçalho de resposta. Valores válidos: `add`, `delete`, `modify`, `rewrite`.	add
header_name	String	Sim	Nome do cabeçalho de resposta.	Cache-Control
header_value	String	Não	Valor do cabeçalho de resposta. Múltiplos valores podem ser separados por vírgulas (,).	no-cache
duplicate	String	Não	Defina se cabeçalhos duplicados com o mesmo nome são permitidos (ao usar a operação add). Valores válidos: `on`, `off`.	off
header_source	String	Não	Valor a ser buscado para substituição (ao usar a operação rewrite). Suporta expressões regulares.	value1
header_destination	String	Não	Valor de substituição (ao usar a operação rewrite).	value123
match_all	String	Não	Modo de correspondência (ao usar a operação rewrite). Valores válidos: `on` (substituir todas as correspondências), `off` (substituir apenas a primeira correspondência).	off

Exemplo:

{
    "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: Configura a reescrita de URI de source.
ID da função: 225
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
source_url	String	Sim	URI a ser reescrita.	^/hello$
target_url	String	Sim	URI de destino após a reescrita.	/hello/test
flag	String	Não	Regra de execução para a operação de reescrita. Valores válidos: (vazio, padrão) continua a corresponder às regras de reescrita subsequentes após a execução; break: interrompe a correspondência de regras subsequentes após a execução; enhance_break: semelhante a break, mas processa parâmetros em conjunto e também funciona para streaming ao vivo FLV.	break
sequence	Integer	Não	Defina a prioridade de execução da configuração. Valores válidos: 1 a 99. Um valor menor indica maior prioridade. Se este parâmetro não for especificado, as prioridades são atribuídas automaticamente em ordem crescente a partir de 1.	1

Exemplo:

{
    "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: Configura a reescrita de argumentos de source. Reescreve parâmetros de consulta na URL da requisição de source. Suporta a configuração de múltiplas regras de reescrita. Prioridade das operações: add > delete > keep > modify.
ID da função: 224
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
delete_argument	String	Não	Argumentos a serem excluídos, separados por espaços.	code1
save_argument	String	Não	Argumentos a serem mantidos, separados por espaços. Apenas os argumentos listados são retidos. As operações de adição e exclusão ainda têm efeito.	(vazio)
ignore_all_argument	String	Não	Defina se todos os argumentos devem ser ignorados. Valores válidos: `on` (ignora todos os argumentos; apenas a operação add permanece efetiva), `off` (padrão).	on
add_argument	String	Não	Argumentos a serem adicionados (maior prioridade), separados por espaços.	value=123
modify_argument	String	Não	Argumentos a serem modificados (menor prioridade), separados por espaços. Se um argumento for excluído, ele não será retido.	value=321
enable	String	Sim	Defina se a reescrita de argumentos de source deve ser ativada. Valores válidos: `on`, `off`.	on

Exemplo:

{
    "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: Configura a busca em source de Bucket autenticado Amazon S3.
ID da função: 186
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
enabled	String	Sim	Defina se o Bucket autenticado Amazon S3 deve ser ativado. Valores válidos: `l2` (ativar), `off` (desativar).	l2
bucketname	String	Não	Nome do Bucket 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:

{
    "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: Configura a verificação de certificado de source (lista de permissões de SNI).
ID da função: 223
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
enabled	String	Sim	Defina se a verificação de certificado de source deve ser ativada. Valores válidos: `on`, `off`.	on
common_name_whitelist	String	Não	Nomes de domínio da lista de permissões de certificados, separados por vírgulas (,). Certificados correspondentes a esses domínios permitidos passam na verificação.	example.com

Exemplo:

{
    "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: Configura servidor de source condicional. Funciona em conjunto com o recurso de mecanismo de regras (condition, ID da função: 250) para rotear requisições a servidores de source específicos com base em caminho, parâmetros de URL, cabeçalhos de requisição e outras informações. Antes de configurar, crie pelo menos uma condição no mecanismo de regras.
ID da função: 212
Conflito: Conflita com advanced_origin (ID da função: 235). Apenas um pode ser configurado. Se um dos recursos já estiver configurado (inclusive quando seu parâmetro switch estiver definido como off), exclua a configuração existente antes de configurar o outro.
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ali_origin_dns_host	String	Sim	Nome de domínio usado para resolução DNS de source.	example.com

Exemplo:

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

origin_host

Descrição: Configura o host de source para um servidor de source específico.
ID da função: 242
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
origin	String	Sim	Endereço do servidor de source. Defina como all para aplicar a todos os servidores de source.	example.com
host	String	Sim	Valor do cabeçalho host. Defina como ali_follow_origin para usar o endereço do servidor de source como valor do host.	host.example.com

Exemplo:

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

ali_origin_port_scheme

Descrição: Configura porta e protocolo de source.
ID da função: 276
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
port	String	Sim	Porta de source. Quando scheme estiver definido como follow, use o formato http:80	https:443.	80
scheme	String	Sim	Protocolo de source. Valores válidos: `http`, `https`, `follow` (segue o protocolo do cliente), `https_sm` (HTTPS com algoritmos criptográficos nacionais chineses), `follow_sm` (segue o protocolo do cliente, suportando algoritmos criptográficos internacionais e nacionais).	http

Exemplo:

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

origin_sni

Descrição: Configura o SNI de source para um servidor de source específico.
ID da função: 262
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
origin	String	Sim	Endereço do servidor de source. Defina como all para aplicar a todos os servidores de source.	example.com
sni_host	String	Sim	Valor do host SNI. Pode ser um valor fixo, ali_follow_origin (segue o endereço do servidor de source) ou ali_follow_host (segue o host de source).	example.org
keepalive_sni	String	Não	Defina se a correspondência SNI keepalive deve ser ativada. Valores válidos: `on`, `off`. Quando ativado, diferentes valores de SNI de source usam conexões keepalive separadas.	off

Exemplo:

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

source_group

Descrição: Configura grupos de servidores de source.
ID da função: 294
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
source_group_name	String	Sim	Nome do grupo de servidores de source. Suporta letras minúsculas, dígitos e sublinhados. Comprimento máximo: 128 bytes.	example_origin
source_info	String	Sim	Informações do servidor de source no formato: address_priority_weight_port. Separe múltiplos servidores de source com vírgulas (,). Prioridade: 1-65535 (valor menor = maior prioridade). Peso: 1-100. Porta: 1-65535.	192.168.0.1_10_33_80,192.0.2.1_10_67_80
retry_times	Integer	Não	Número de tentativas de nova conexão com a source.	3
retry_status_rule	Integer	Não	Códigos de status para nova tentativa. Valores suportados: 4xx, 5xx, 404, 404-or-5xx, 4xx-or-5xx.	404-or-5xx
failback_source	String	Não	Defina se deve retornar à configuração básica do servidor de source quando todos os servidores do grupo estiverem indisponíveis. Valores válidos: `on`, `off`.	on

Exemplo:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "source_group_name",
            "argValue": "test_origin"
        }, {
            "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-or-5xx"
        }, {
            "argName": "failback_source",
            "argValue": "on"
        }],
        "functionName": "source_group"
    }],
    "DomainNames": "example.com"
}

ipv6_origin

Descrição: Configura a busca de source via IPv6.
ID da função: 265
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
enable	String	Sim	Defina se a busca de source via IPv6 deve ser ativada. Valores válidos: `on`, `off`. Quando ativado, o CDN usa IPv6 para conexões de source sempre que tanto o nó CDN quanto o servidor de source possuírem endereços IPv6 disponíveis.	on
follow	String	Sim	Defina se a versão do protocolo IP do cliente deve ser seguida para busca na source. Valores válidos: `on`, `off`. Quando ativado, o CDN segue o protocolo da requisição do cliente: requisições de clientes IPv6 preferem servidores de source IPv6; requisições de clientes IPv4 preferem servidores de source IPv4.	on
ipv6_v4_mix_used	String	Não	Defina se a busca de source em round-robin IPv4/IPv6 deve ser ativada. Valores válidos: `on`, `off`. Quando ativado, os recursos de source IPv6 e follow tornam-se ineficazes. Todas as requisições usam round-robin em todos os endereços de source, independentemente do protocolo do cliente.	off

Exemplo:

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

cos_auth

Descrição: Configura a busca em source de Bucket autenticado Tencent Cloud COS.
ID da função: 288
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
enable	String	Sim	Defina se o Bucket autenticado Tencent Cloud COS deve ser ativado. Valores válidos: `on`, `off`.	on
cos_valid_period	String	Não	Período de validade da assinatura de autenticação em segundos. Valor padrão: 3.600.	3.600
cos_secret_id	String	Sim	ID de autenticação da Tencent Cloud.	123456789
cos_secret_key	String	Sim	Chave de autenticação da Tencent Cloud.	12345678

Exemplo:

{
    "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: Configura as informações do bucket de autenticação OSS usadas pelo CDN para busca na source. Essa configuração é adicionada automaticamente ao configurar um servidor de source do tipo OSS para um nome de domínio acelerado. Não exclua manualmente esta configuração, pois isso pode causar problemas de faturamento de tráfego de source do CDN e falhas de autenticação para acesso a Buckets privados.
ID da função: 10
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
oss_bucket_id	String	Sim	Endpoint público do Bucket OSS.	cdn-test.oss-cn-hongkong.aliyuncs.com
oss_pri_buckets	String	Sim	Endpoint público do Bucket OSS e seu nome correspondente, separados por uma barra vertical (	).	cdn-test.oss-cn-hongkong.aliyuncs.com	cdn-test

Exemplo:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "oss_bucket_id",
            "argValue": "cdn-test.oss-cn-hongkong.aliyuncs.com"
        }, {
            "argName": "oss_pri_buckets",
            "argValue": "cdn-test.oss-cn-hongkong.aliyuncs.com|cdn-test"
        }],
        "functionName": "oss_auth"
    }],
    "DomainNames": "example.com"
}

Controle de acesso

referer_white_list_set

Descrição: Configura uma lista de permissões de Referer.
ID da função: 1
Conflito: Conflita com referer_black_list_set (ID da função: 5). Apenas um pode ser configurado.
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
refer_domain_allow_list	String	Sim	Lista de permissões de domínios Referer, separados por vírgulas (`,`).	example.aliyundoc.com,demo.aliyundoc.com
allow_empty	String	Não	Defina se campos Referer vazios são permitidos. Valores válidos: `on`, `off` (padrão).	off
redirect_url	String	Não	URL de redirecionamento para requisições não correspondidas (deve começar com `http://` ou `https://`).	http://www.example.com
disable_ast	String	Não	Modo de correspondência exata. Valores válidos: `on` (correspondência exata), `off` (correspondência por sufixo, padrão).	off
ignore_scheme	String	Não	Defina se o esquema HTTP ou HTTPS no Referer deve ser ignorado. Valores válidos: `on`, `off` (padrão).	off

Exemplo:

{
    "Functions": [{
        "functionArgs": [{
            "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.
ID da função: 5
Conflito: Conflita com referer_white_list_set (ID da função: 1). Apenas um pode ser configurado.
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
refer_domain_deny_list	String	Sim	Lista de bloqueios de domínios Referer, separados por vírgulas (`,`).	example.aliyundoc.com,demo.aliyundoc.com
allow_empty	String	Não	Defina se campos Referer vazios são permitidos. Valores válidos: `on`, `off`.	off
redirect_url	String	Não	URL de redirecionamento para requisições correspondidas.	http://www.example.com
disable_ast	String	Não	Modo de correspondência exata. Valores válidos: `on` (correspondência exata), `off` (correspondência por sufixo, padrão).	off
ignore_scheme	String	Não	Defina se o esquema HTTP ou HTTPS no Referer deve ser ignorado. Valores válidos: `on`, `off` (padrão).	off

Exemplo:

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

ip_allow_list_set

Descrição: Configura uma lista de permissões de IP.
ID da função: 69
Conflito: Conflita com ip_black_list_set (ID da função: 13). Apenas um pode ser configurado.
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ip_list	String	Sim	Lista de endereços IP ou blocos CIDR, separados por vírgulas (`,`). É possível configurar até 700 endereços IPv6 ou 2.000 endereços IPv4. O comprimento total da string dos endereços IP não pode exceder 30 KB. Blocos CIDR são suportados (por exemplo, `127.0.0.0/24`). Maiúsculas e minúsculas não fazem diferença em endereços IPv6. A notação abreviada `::` não é suportada.	192.168.0.1/24
customize_response_status_code	String	Não	Código de status de resposta personalizado. Valor padrão: `403`.	429
ip_acl_xfwd	String	Não	Modo de correspondência de IP. Valores válidos: `on` (usa cabeçalho X-Forwarded-For, padrão), `off` (usa IP da conexão TCP), `all` (usa ambos).	all
ip_list_notes	String	Não	Observações para a lista de IPs.	192.x.x.1 (IP malicioso)

Exemplo:

{
    "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.
ID da função: 13
Conflito: Conflita com ip_allow_list_set (ID da função: 69). Apenas um pode ser configurado.
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ip_list	String	Sim	Lista de endereços IP ou blocos CIDR, separados por vírgulas (`,`). É possível configurar até 700 endereços IPv6 ou 2.000 endereços IPv4. O comprimento total da string dos endereços IP não pode exceder 30 KB. Blocos CIDR são suportados (por exemplo, `127.0.0.0/24`). Maiúsculas e minúsculas não fazem diferença em endereços IPv6. A notação abreviada `::` não é suportada.	192.168.0.1
customize_response_status_code	String	Não	Código de status de resposta personalizado. Valor padrão: `403`.	429
ip_acl_xfwd	String	Não	Modo de correspondência de IP. Valores válidos: `on` (usa cabeçalho X-Forwarded-For, padrão), `off` (usa IP da conexão TCP), `all` (usa ambos).	all
ip_list_notes	String	Não	Observações para a lista de IPs.	192.x.x.1 (IP malicioso)

Exemplo:

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

aliauth

Descrição: Configura a autenticação de URL.
ID da função: 25
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
auth_m3u8	String	Não	Habilita a reescrita de conteúdo m3u8. Quando ativado, parâmetros de autenticação são anexados aos segmentos TS no arquivo m3u8 para evitar falhas de autenticação de acesso TS. Valores válidos: `on` (padrão), `off`.	on
auth_type	String	Sim	Tipo de autenticação. Valores válidos: `no_auth`, `type_a`, `type_b`, `type_c`, `type_d`, `type_e`, `type_f`. Para detalhes sobre cada tipo, consulte a documentação de autenticação de URL.	type_a
auth_key1	String	Sim	Chave de autenticação 1 (16-128 caracteres, apenas letras e dígitos).	1234567890123456789
auth_key2	String	Não	Chave de autenticação 2 (16-128 caracteres, apenas letras e dígitos).	1234567890123456789
ali_auth_delta	Integer	Não	Duração válida da URL autenticada, em segundos. Valor padrão: `1800`.	1.800
req_auth_ip_white	String	Não	Endereços IP da lista de permissões isentos de autenticação. Separe múltiplos endereços IP com vírgulas (,).	192.168.0.1
req_auth_ip_acl_xfwd	String	Não	Método para extrair o IP do cliente para isenção da lista de permissões. Valores válidos: `on` (padrão, usa o primeiro IP do cabeçalho X-Forwarded-For), `off` (usa o IP da conexão TCP), `all` (usa ambos).	all
sign_param	String	Não	Nome do parâmetro de assinatura. Válido apenas quando auth_type estiver definido como type_f.	sign
time_param	String	Não	Nome do parâmetro de timestamp. Válido apenas quando auth_type estiver definido como type_f.	time
time_format	String	Não	Formato do timestamp. Válido apenas quando auth_type estiver definido como type_f. Valores válidos: `dec` (decimal), `hex` (hexadecimal).	hex
path_encoding	String	Não	Defina se a codificação de URL deve ser ativada. Válido apenas quando auth_type estiver definido como type_f. Valores válidos: `on`, `off`.	on

Exemplo 1 (Autenticação tipo A):

{
    "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"
        }],
        "functionName": "aliauth"
    }],
    "DomainNames": "example.com"
}

Exemplo 2 (Autenticação tipo F):

{
    "Functions": [{
        "functionArgs": [{
            "argName": "auth_type",
            "argValue": "type_f"
        }, {
            "argName": "auth_key1",
            "argValue": "1234567890123456789"
        }, {
            "argName": "auth_key2",
            "argValue": "1234567890123456789"
        }, {
            "argName": "ali_auth_delta",
            "argValue": 1800
        }, {
            "argName": "sign_param",
            "argValue": "sign"
        }, {
            "argName": "time_param",
            "argValue": "time"
        }, {
            "argName": "time_format",
            "argValue": "hex"
        }, {
            "argName": "path_encoding",
            "argValue": "on"
        }],
        "functionName": "aliauth"
    }],
    "DomainNames": "example.com"
}

cdn_remote_auth

Descrição: Configura a autenticação remota.
ID da função: 258
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
enable	String	Sim	Defina se a autenticação remota deve ser ativada. Valores válidos: `on`, `off`.	on
remote_auth_addr	String	Sim	Endereço do servidor de autenticação. Formato: https://cdn.aliyun.com/auth ou http://10.10.10.10/auth.	https://example.aliyundoc.com/auth
remote_auth_method	String	Sim	Método de requisição. Valores válidos: GET, POST, HEAD.	get
remote_auth_type	String	Sim	Tipo de arquivo a autenticar. Defina como all para todos os tipos. Múltiplos tipos são separados por barras verticais (	), diferenciando maiúsculas de minúsculas.	all
remote_auth_reserve_args	String	Sim	Parâmetros de requisição reservados, separados por barras verticais (	), sem distinção entre maiúsculas e minúsculas. Defina como all para reservar todos os parâmetros, ou ali_delete_all_args para excluir todos os parâmetros de URL.	all
remote_auth_custom_args	String	Não	Parâmetros personalizados a adicionar, separados por barras verticais (	), diferenciando maiúsculas de minúsculas.	(vazio)
remote_auth_reserve_header	String	Sim	Cabeçalhos de requisição reservados, separados por barras verticais (	), sem distinção entre maiúsculas e minúsculas. Defina como all para reservar todos os cabeçalhos, ou ali_delete_all_headers para excluir todos os cabeçalhos.	all
remote_auth_custom_header	String	Não	Cabeçalhos de requisição personalizados a adicionar, separados por barras verticais (	), sem distinção entre maiúsculas e minúsculas.	(vazio)
remote_auth_success_code	Integer	Sim	Código de status de sucesso de autenticação retornado pelo servidor de autenticação. Múltiplos códigos são separados por vírgulas.	200
remote_auth_fail_code	Integer	Sim	Código de status de falha de autenticação retornado pelo servidor de autenticação. Múltiplos códigos são separados por vírgulas.	403.404
remote_auth_other_code_act	String	Não	Ação para outros códigos de status (nem sucesso nem falha). Valores válidos: `pass` (padrão, permite a requisição), `reject` (nega a requisição).	pass
remote_auth_fail_resp_code	Integer	Sim	Código de status que o CDN retorna ao cliente quando a autenticação falha.	403
remote_auth_timeout	Integer	Sim	Tempo limite de autenticação em milissegundos. Valor máximo: 3.000.	500
remote_auth_timeout_action	String	Sim	Ação quando a autenticação atinge o tempo limite. Valores válidos: `pass` (permite a requisição), `reject` (retorna o código de resposta de falha).	pass

Exemplo:

{
    "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_reserve_header",
            "argValue": "all"
        }, {
            "argName": "remote_auth_success_code",
            "argValue": "200"
        }, {
            "argName": "remote_auth_fail_code",
            "argValue": "403"
        }, {
            "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"
}

ali_ua

Descrição: Configura restrições de acesso baseadas em User-Agent.
ID da função: 58
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ua	String	Sim	Valores de User-Agent. Suporta o caractere curinga * (corresponde a qualquer string) e múltiplos valores separados por barras verticais (	).	curl	IE	chrome	firefox
type	String	Sim	Tipo de lista. Valores válidos: `black` (lista de bloqueios), `white` (lista de permissões). Lista de bloqueios e lista de permissões são mutuamente exclusivas; apenas uma pode estar ativa por vez.	black

Exemplo:

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

Configurações de cache

filetype_based_ttl_set

Descrição: Configura o tempo de expiração de arquivos.
ID da função: 6
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ttl	Integer	Sim	Duração do cache em segundos. Valores válidos: 1-99999999.	500000
file_type	String	Sim	Tipos de arquivo, separados por vírgulas (`,`). Diferencia maiúsculas de minúsculas. Por exemplo, jpg,txt.	jpg
weight	Integer	Não	Prioridade. Valores válidos: 1-99. Valor padrão: `1` (valor maior = maior prioridade).	1
swift_origin_cache_high	String	Não	Defina se a política de cache da source deve ter prioridade. Quando ativado, a política de cache dos cabeçalhos de resposta da source (como Cache-Control e Pragma) tem precedência. Valores válidos: `on`, `off` (padrão).	off
swift_no_cache_low	String	Não	Defina se os cabeçalhos de resposta no-cache da source devem ser ignorados. Quando ativado, os seguintes cabeçalhos de resposta da source são ignorados: Cache-Control: no-store, Cache-Control: no-cache, Cache-Control: max-age=0, Pragma: no-cache. Valores válidos: `on`, `off` (padrão).	off
swift_follow_cachetime	String	Não	Defina se o cliente deve seguir a política de cache do CDN. Quando ativado, a política de cache efetiva final do CDN é enviada na resposta ao cliente. Valores válidos: `on`, `off` (padrão).	off
force_revalidate	String	Não	Defina se a validação de conteúdo deve ser forçada quando o TTL for 0. Valores válidos: `on` (quando TTL é 0, o conteúdo é armazenado em cache no nó CDN e revalidado com a source em cada requisição), `off` (padrão, quando TTL é 0, o conteúdo não é armazenado em cache e é buscado na source em cada requisição).	off

Exemplo:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "ttl",
            "argValue": "500000"
        }, {
            "argName": "file_type",
            "argValue": "jpg"
        }],
        "functionName": "filetype_based_ttl_set"
    }],
    "DomainNames": "example.com"
}

ali_return_code

Descrição: Resposta HTTP personalizada. Constrói uma resposta HTTP com um código de status HTTP e corpo HTTP personalizados. A resposta construída é retornada diretamente ao cliente.
ID da função: 56
Parâmetros:

Nota

Modo de resposta pré-source (exit_after_return_code definido como on): O CDN não busca conteúdo na source. Ele intercepta a requisição diretamente e retorna o código de status de resposta e o corpo da resposta (se configurado) ao cliente.

Modo de resposta pós-source (exit_after_return_code definido como return_code_phase ou vazio): O CDN primeiro busca o conteúdo na source e depois retorna tanto o código de status de resposta quanto o conteúdo da resposta da source ao cliente. Esta configuração não tem efeito por padrão no modo pós-source; o corpo da resposta é sempre o conteúdo retornado pela source. Para substituir o corpo da resposta da source, ative também ali_body_filter_switch.

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
return_code	Integer	Sim	Código de status da resposta. Defina o código de status HTTP que o nó CDN finalmente retorna ao cliente.	302
exit_after_return_code	String	Não	Modo de resposta, que controla quando o CDN retorna a resposta ao cliente. Valores válidos: `on`: Resposta pré-source. O CDN não busca conteúdo na source. Ele intercepta a requisição diretamente e retorna o código de status de resposta e o corpo da resposta (se configurado) ao cliente. `return_code_phase`: Resposta pós-source. O CDN primeiro busca o conteúdo na source e depois retorna tanto o código de status de resposta quanto o conteúdo da resposta da source ao cliente (modo padrão, usado quando este parâmetro está vazio).	on
resp_body_ct	String	Não	Conteúdo do corpo da resposta (HTTP Body) para personalizar o que é retornado ao cliente. No modo de resposta pré-source: se especificado, este conteúdo é retornado como corpo da resposta; se não especificado, apenas o código de status é retornado. No modo de resposta pós-source: esta configuração não tem efeito por padrão; o corpo da resposta é sempre o conteúdo retornado pela source.	example
ali_body_filter_switch	String	Não	Interruptor para modificar o conteúdo da resposta da source. Esta configuração só tem efeito no modo de resposta pós-source. Quando ativado, o CDN substitui o corpo da resposta da source pelo conteúdo de resposta especificado e retorna o código de status de resposta mais o conteúdo da resposta ao cliente. Valores válidos: `on`: Ativar. `off`: Desativar.	on
ali_body_filter_code	Integer	Não	Corresponde ao código de status da resposta da source. Esta configuração só tem efeito no modo de resposta pós-source e quando a modificação do conteúdo da resposta da source está ativada. Quando especificado, o CDN aciona a lógica de substituição do conteúdo da resposta apenas quando a source retorna o código de status especificado. Se o código de status não corresponder, nenhuma substituição é realizada.	404

Exemplo:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "return_code",
            "argValue": "403"
        }, {
            "argName": "exit_after_return_code",
            "argValue": "on"
        }, {
            "argName": "resp_body_ct",
            "argValue": "null"
        }, {
            "argName": "ali_body_filter_switch",
            "argValue": "on"
        }, {
            "argName": "ali_body_filter_code",
            "argValue": "333"
        }],
        "functionName": "ali_return_code"
    }],
    "DomainNames": "example.com"
}

path_based_ttl_set

Descrição: Configura o tempo de expiração de cache baseado em diretório.
ID da função: 7
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ttl	Integer	Sim	Duração do cache em segundos. Valores válidos: 1-99999999.	500000
path	String	Sim	Caminho do diretório, que deve começar com uma barra (/).	/example/demo
weight	Integer	Não	Prioridade. Valores válidos: 1-99. Valor padrão: 1 (valor maior = maior prioridade).	1
swift_origin_cache_high	String	Não	Defina se a política de cache da source deve ter prioridade. Valores válidos: `on`, `off` (padrão).	off
swift_no_cache_low	String	Não	Defina se os cabeçalhos de resposta no-cache da source devem ser ignorados. Valores válidos: `on`, `off` (padrão).	off
swift_follow_cachetime	String	Não	Defina se o cliente deve seguir a política de cache do CDN. Valores válidos: `on`, `off` (padrão).	off
force_revalidate	String	Não	Defina se a validação de conteúdo deve ser forçada quando o TTL for 0. Valores válidos: `on`, `off` (padrão).	off

Exemplo:

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

filetype_force_ttl_code

Descrição: Configura o tempo de expiração de cache de código de status baseado em tipo de arquivo.
ID da função: 63
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
file_type	String	Sim	Tipos de arquivo, diferencia maiúsculas de minúsculas, separados por vírgulas (,).	jpg
code_string	String	Sim	Códigos de status e suas durações de cache em segundos (1-99999999), separados por vírgulas. Formato: code=ttl.	403=10
swift_code_origin_cache_high	String	Não	Defina se a política de cache da source deve ter prioridade. Valores válidos: `on`, `off` (padrão).	off
swift_code_no_cache_low	String	Não	Defina se os cabeçalhos de resposta no-cache da source devem ser ignorados. Valores válidos: `on`, `off` (padrão).	off
swift_code_follow_cachetime	String	Não	Defina se o cliente deve seguir a política de cache do CDN. Valores válidos: `on`, `off` (padrão).	off
force_revalidate	String	Não	Defina se a validação de conteúdo deve ser forçada quando o TTL for 0. Valores válidos: `on`, `off` (padrão).	off

Exemplo:

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

path_force_ttl_code

Descrição: Configura o tempo de expiração de cache de código de status baseado em caminho.
ID da função: 65
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
path	String	Sim	Caminho do diretório, que deve começar com uma barra (/).	/example/demo
code_string	String	Sim	Códigos de status e suas durações de cache em segundos (1-99999999), separados por vírgulas. Formato: code=ttl.	403=10,404=15
swift_code_origin_cache_high	String	Não	Defina se a política de cache da source deve ter prioridade. Valores válidos: `on`, `off` (padrão).	off
swift_code_no_cache_low	String	Não	Defina se os cabeçalhos de resposta no-cache da source devem ser ignorados. Valores válidos: `on`, `off` (padrão).	off
swift_code_follow_cachetime	String	Não	Defina se o cliente deve seguir a política de cache do CDN. Valores válidos: `on`, `off` (padrão).	off
force_revalidate	String	Não	Defina se a validação de conteúdo deve ser forçada quando o TTL for 0. Valores válidos: `on`, `off` (padrão).	off

Exemplo:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "path",
            "argValue": "/example/demo"
        }, {
            "argName": "code_string",
            "argValue": "403=10.404=15"
        }],
        "functionName": "path_force_ttl_code"
    }],
    "DomainNames": "example.com"
}

default_ttl_code

Descrição: Configura o tempo de expiração de cache de código de status (prioridade da source).
ID da função: 207
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
default_ttl_code	String	Sim	Códigos de status e suas durações de cache em segundos (1-99999999), separados por vírgulas. Formato: code=ttl.	4xx=3,200=3600,5xx=1

Exemplo:

{
    "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.
ID da função: 27
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
key	String	Sim	Nome do cabeçalho de resposta.	Cache-Control
value	String	Sim	Valor do cabeçalho de resposta. Múltiplos valores são separados por vírgulas (,). Para excluir um cabeçalho, defina o valor como null.	no-cache
header_operation_type	String	Não	Tipo de operação no cabeçalho. Valores válidos: `add`, `delete`, `modify`, `rewrite`.	add
duplicate	String	Não	Defina se cabeçalhos duplicados são permitidos (ao usar a operação add). Valores válidos: `on`, `off`.	off
header_source	String	Não	Valor a ser buscado para substituição (ao usar rewrite). Suporta expressões regulares.	value1
header_destination	String	Não	Valor de substituição (ao usar rewrite).	value123
match_all	String	Não	Modo de correspondência (ao usar rewrite). Valores válidos: `on` (substituir todos), `off` (substituir apenas o primeiro).	off
access_origin_control	String	Não	Defina se a validação cross-origin deve ser ativada. Valores válidos: `on`, `off`.	off

Exemplo:

{
    "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.
ID da função: 15
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
error_code	Integer	Sim	Código de status de erro.	404
rewrite_page	String	Sim	URL da página de redirecionamento.	http://example.aliyundoc.com/error404.html

Exemplo:

{
    "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: Configura regras de reescrita de URI.
ID da função: 43
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
regex	String	Sim	URI a ser reescrita. Deve começar com /. Suporta expressões regulares PCRE.	^/hello$
replacement	String	Sim	URI de destino. Quando flag estiver definido como break, suporta apenas caminhos começando com /. Quando flag estiver definido como redirect, pode incluir protocolo e nome de domínio. Suporta expressões regulares PCRE ($1, $2 para grupos de captura).	/hello/test
flag	String	Não	Regra de execução. Valores válidos: (vazio, padrão) continua a corresponder às regras subsequentes; break: interrompe a correspondência de regras subsequentes, reescreve a URI sem modificar parâmetros; redirect: retorna um redirecionamento 302 ao cliente, continua a corresponder às regras subsequentes; enhance_break: semelhante a break, mas modifica toda a URL incluindo parâmetros; enhance_redirect: semelhante a redirect, mas modifica toda a URL incluindo parâmetros.	redirect
rewrite_method	String	Não	Método de redirecionamento. Valores válidos: 302 (padrão, método de requisição pode mudar para GET), 303 (método de requisição muda para GET, corpo é perdido), 307 (método de requisição e corpo são preservados).	302
sequence	Integer	Não	Defina a prioridade de execução da configuração. Valores válidos: 1 a 99. Um valor menor indica maior prioridade. Se este parâmetro não for especificado, as prioridades são atribuídas automaticamente em ordem crescente a partir de 1.	1

Exemplo:

{
    "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 chaves de cache personalizadas.
ID da função: 227
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
uri	Array of String	Não	Reescreve a URI de source para uma URI de destino para a chave de cache. Use uri_to_rewrite para a source e ai_uri_regex para o destino.	[{"uri_to_rewrite":"/hello","ai_uri_regex":"/hello/test"}]
args	Array of String	Não	Executa operações de adição, exclusão, modificação ou manutenção nos parâmetros de requisição para a chave de cache.	[{"args":"test=123","args_operation_type":"add"}]
headers	String	Não	Cabeçalhos HTTP a serem incluídos na chave de cache, separados por espaços.	example
variable	Array of String	Não	Variáveis personalizadas extraídas de parâmetros de URL de requisição, cabeçalhos HTTP, cookies ou URI usando expressões regulares para anexar à chave de cache.	[]

Exemplo:

{
    "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 cache compartilhado (reescrita de chave de cache).
ID da função: 54
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 domínio atual. Isso não modifica o host de source nas requisições do usuário. Usa apenas o valor share_host para gerar a chave de cache para buscas no cache.	example.com

Exemplo:

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

serving_stale_content

Descrição: Configura o fornecimento de conteúdo obsoleto. Fornece conteúdo em cache que expirou quando o servidor de source está indisponível.
ID da função: 260
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
origin_error_status_code	String	Não	Códigos de status de erro de source personalizados que acionam o fornecimento de conteúdo obsoleto. Por padrão (quando não especificado), erros de source são definidos como tempos limite mais todos os códigos de status 5xx. Suporta correspondência difusa (4xx, 5xx) e correspondência exata (502, 504). Múltiplos códigos são separados por vírgulas.	502
extend_expiration_time	Integer	Não	Tempo máximo (em segundos) para manter conteúdo em cache obsoleto após a expiração. Valor padrão: 3.600 (1 hora).	60
origin_first	String	Não	Defina se a política stale-if-error da source deve ter prioridade. Quando ativado (on), se a resposta da source incluir Cache-Control: stale-if-error=xx, o tempo stale-if-error tem precedência sobre extend_expiration_time. Valores válidos: `on`, `off` (padrão).	on

Exemplo:

{
    "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ções HTTPS

https_option

Descrição: Configura parâmetros básicos de HTTPS.
ID da função: 78
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
http2	String	Não	Defina se o HTTP/2 deve ser ativado. Valores válidos: `on`, `off`.	on
ocsp_stapling	String	Não	Defina se o OCSP Stapling deve ser ativado. Valores válidos: `on`, `off`.	on

Exemplo:

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

https_force

Descrição: Configura o redirecionamento HTTPS.
ID da função: 44
Conflito: Conflita com http_force (ID da função: 45). Apenas um pode ser configurado.
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
enable	String	Sim	Defina se o redirecionamento HTTPS deve ser ativado. Valores válidos: `on`, `off`.	on
https_rewrite	String	Não	Método de redirecionamento. Valores válidos: `301`, `308`.	301

Exemplo:

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

http_force

Descrição: Configura o redirecionamento forçado para HTTP.
ID da função: 45
Conflito: Conflita com https_force (ID da função: 44). Apenas um pode ser configurado. Se um dos recursos já estiver configurado (inclusive quando seu parâmetro switch estiver definido como off), exclua a configuração existente antes de configurar o outro.
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
enable	String	Sim	Defina se o redirecionamento forçado para HTTP deve ser ativado. Valores válidos: `on`, `off`.	on
http_rewrite	String	Não	Método de redirecionamento. Valores válidos: 301 (método de requisição GET inalterado, outros métodos podem mudar para GET), 308 (método de requisição e corpo são preservados).	301

Exemplo:

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

https_tls_version

Descrição: Configura versões do protocolo TLS.
ID da função: 110
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
tls10	String	Não	Defina se o TLS 1.0 deve ser ativado. Valores válidos: `on` (padrão), `off`.	on
tls11	String	Não	Defina se o TLS 1.1 deve ser ativado. Valores válidos: `on` (padrão), `off`.	on
tls12	String	Não	Defina se o TLS 1.2 deve ser ativado. Valores válidos: `on` (padrão), `off`.	on
tls13	String	Não	Defina se o TLS 1.3 deve ser ativado. Valores válidos: `on` (padrão), `off`.	on
ciphersuitegroup	String	Não	Grupo de conjuntos de cifras. Valores válidos: `all` (padrão, todos os conjuntos de cifras), `strict` (apenas conjuntos de cifras fortes), `custom` (conjuntos de cifras personalizados).	all
ciphersuite	String	Não	Conjuntos de cifras personalizados. Usado com ciphersuitegroup definido como custom. Múltiplos conjuntos de cifras são separados por vírgulas.	TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256

Exemplo:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "tls10",
            "argValue": "on"
        }, {
            "argName": "tls11",
            "argValue": "on"
        }, {
            "argName": "tls12",
            "argValue": "on"
        }, {
            "argName": "tls13",
            "argValue": "off"
        }, {
            "argName": "ciphersuitegroup",
            "argValue": "all"
        }],
        "functionName": "https_tls_version"
    }],
    "DomainNames": "example.com"
}

HSTS

Descrição: Configura HTTP Strict Transport Security (HSTS).
ID da função: 112
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
enabled	String	Sim	Defina se o HSTS deve ser ativado. Valores válidos: `on`, `off`.	on
https_hsts_max_age	Integer	Sim	Tempo de expiração em segundos. Valor recomendado: 5.184.000 (60 dias).	5.184.000
https_hsts_include_subdomains	String	Não	Defina se subdomínios devem ser incluídos no cabeçalho HSTS. Valores válidos: `on`, `off`. Antes de ativar, certifique-se de que todos os subdomínios tenham HTTPS habilitado; caso contrário, o acesso aos subdomínios pode falhar.	off

Exemplo:

{
    "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"
}

https_client_cert

Descrição: Configura a autenticação por certificado de cliente.
ID da função: 111
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
client_certificate_verify	String	Sim	Defina se a autenticação por certificado de cliente deve ser ativada. Valores válidos: `on`, `off`.	on
client_certificate	String	Sim	Certificado de cliente (chave pública) a ser usado para autenticação. O certificado CA deve começar com -----BEGIN CERTIFICATE----- e terminar com -----END CERTIFICATE-----.	-----BEGIN PUBLIC KEY-----***-----END PUBLIC KEY-----
client_verify_depth	String	Não	Profundidade de verificação da cadeia de certificados (número de níveis de certificado do certificado do cliente até a CA raiz). Valor padrão: 1.	1

Exemplo:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "client_certificate_verify",
            "argValue": "on"
        }, {
            "argName": "client_certificate",
            "argValue": "-----BEGIN PUBLIC KEY-----***-----END PUBLIC KEY-----"
        }],
        "functionName": "https_client_cert"
    }],
    "DomainNames": "example.com"
}

Otimização de desempenho

gzip

Descrição: Habilita a compressão Gzip de página.
ID da função: 35
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
enable	String	Sim	Defina se a compressão Gzip deve ser ativada. Valores válidos: `on`, `off`.	on

Exemplo:

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

tesla

Descrição: Configura a otimização de páginas HTML.
ID da função: 16
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
enable	String	Sim	Defina se a otimização de página deve ser ativada. Valores válidos: `on`, `off`.	on
trim_js	String	Não	Defina se o código JS inline no HTML deve ser otimizado. Valores válidos: `on`, `off` (padrão).	off
trim_css	String	Não	Defina se o código CSS inline no HTML deve ser otimizado. Valores válidos: `on`, `off` (padrão).	off

Exemplo:

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

brotli

Descrição: Configura a compressão Brotli.
ID da função: 97
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
enable	String	Sim	Defina se a compressão Brotli deve ser ativada. Valores válidos: `on`, `off`.	on

Exemplo:

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

set_hashkey_args

Descrição: Configura a filtragem de parâmetros de URL (modo de retenção).
ID da função: 19
Conflito: Conflita com ali_remove_args (ID da função: 75). Apenas um pode ser configurado.
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
hashkey_args	String	Não	Lista de parâmetros a serem retidos, separados por vírgulas (,). Máximo: 10 parâmetros.	key1,key2
disable	String	Sim	Defina se todos os parâmetros devem ser ignorados. Valores válidos: `on` (ignorar todos, apenas a operação add permanece efetiva), `off` (padrão). Ignorar todos os parâmetros tem prioridade menor que a lista de parâmetros retidos.	on
keep_oss_args	String	Sim	Defina se os parâmetros devem ser retidos para requisições de source. Valores válidos: `on` (reter todos os parâmetros), `off` (parâmetros de source correspondem aos parâmetros da chave de cache).	on

Exemplo:

{
    "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: Configura a filtragem de parâmetros de URL (modo de exclusão).
ID da função: 75
Conflito: Conflita com set_hashkey_args (ID da função: 19). Apenas um pode ser configurado.
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ali_remove_args	String	Sim	Parâmetros a serem excluídos, separados por espaços. Os parâmetros restantes são usados como a parte de argumentos de URL da chave de cache.	test
keep_oss_args	String	Sim	Defina se os parâmetros devem ser retidos para requisições de source. Valores válidos: `on` (reter todos os parâmetros), `off` (parâmetros de source correspondem aos parâmetros da chave de cache).	off

Exemplo:

{
    "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: Configura a transformação de imagens do CDN.
ID da função: 239
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
enable	String	Sim	Defina se a transformação de imagem deve ser ativada. Valores válidos: `on`, `off`.	on
filetype	String	Sim	Formatos de imagem suportados para transcodificação, separados por barras verticais (	). Valores válidos: JPEG, JPG, PNG, WEBP, BMP, GIF, TIFF, JP2.	jpg	jpeg	png
webp	String	Não	Defina se a conversão adaptativa para WebP deve ser ativada. Valores válidos: `on`, `off`.	on
orient	String	Não	Defina se a rotação automática de imagem deve ser ativada. Valores válidos: `on`, `off`. Aplica-se apenas a imagens com atributos de rotação.	on
slim	Integer	Não	Percentual de redução de imagem. Valores válidos: 0-100. Reduz a qualidade da imagem sem alterar resolução, tamanho ou formato para economizar largura de banda.	10

Exemplo:

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

Vídeo

range

Descrição: Configura a busca na source baseada em Range.
ID da função: 31
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
enable	String	Sim	Defina se a busca na source baseada em Range deve ser ativada. Valores válidos: `on`, `off`, `force` (ativação forçada).	on

Exemplo:

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

video_seek

Descrição: Configura a busca em vídeo (arrastar e reproduzir).
ID da função: 30
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
enable	String	Sim	Defina se a busca em vídeo deve ser ativada. Valores válidos: `on`, `off`.	on
flv_seek_by_time	String	Não	Defina se a busca baseada em tempo para FLV deve ser ativada. Valores válidos: `on`, `off`.	on
mp4_seek_start	String	Não	Nome personalizado do parâmetro de início MP4.	mp4starttime
mp4_seek_end	String	Não	Nome personalizado do parâmetro de fim MP4.	mp4endtime
flv_seek_start	String	Não	Nome personalizado do parâmetro de início FLV.	flvstarttime
flv_seek_end	String	Não	Nome personalizado do parâmetro de fim FLV.	flvendtime

Exemplo:

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

ali_video_split

Descrição: Configura a extração de áudio de vídeo.
ID da função: 204
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
enable	String	Sim	Defina se a extração de áudio deve ser ativada. Valores válidos: `on`, `off`.	on

Exemplo:

{
    "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 (visualização de teste).
ID da função: 205
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
enable	String	Sim	Defina se a pré-visualização de vídeo deve ser ativada. Valores válidos: `on`, `off`. Suporta formatos de arquivo TS e MP3. Para FLV e MP4, use o recurso de busca em vídeo.	on
ali_video_preview_argument	String	Sim	Nome do parâmetro de pré-visualização personalizado. A unidade do valor do parâmetro deve estar em segundos.	fds

Exemplo:

{
    "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 reescrita de criptografia padrão M3U8.
ID da função: 253
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
enable	String	Sim	Defina se a reescrita de criptografia padrão M3U8 deve ser ativada. Valores válidos: `on`, `off`.	on
hls_token_arg_name	String	Não	Nome do parâmetro de token HLS personalizado. Valor padrão: MtsHlsUriToken.	example

Exemplo:

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

Limitação de tráfego

limit_rate

Descrição: Configura a limitação de taxa por requisição.
ID da função: 72
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ali_limit_rate	String	Sim	Valor limite de taxa para uma única requisição (por exemplo, `200 KByte/s` ou `1 MByte/s`). O valor deve estar no formato número + unidade (k para KByte/s, m para MByte/s). Valor mínimo: `100k`. Valores abaixo de 100k são tratados como 100k.	1m
ali_limit_rate_after	String	Não	Limite de volume de dados antes do início da limitação de taxa. O valor deve estar no formato número + unidade (k ou m), em bytes.	1.000
traffic_limit_arg	String	Não	Nome do parâmetro de limite de taxa extraído da URL da requisição. Quando especificado, o limite de taxa baseia-se no valor deste parâmetro na URL. Quando a requisição não contém este parâmetro, o limite de taxa padrão (ali_limit_rate) é usado. Para desativar a limitação de taxa quando o parâmetro estiver ausente, defina ali_limit_rate como 0k.	rate
traffic_limit_unit	String	Não	Unidade para o valor do parâmetro traffic_limit_arg. Valores válidos: `m` (MByte/s), `k` (KByte/s). Por exemplo, se a unidade for definida como m e a URL da requisição contiver rate=1, o limite de taxa real será 1 MByte/s. Valor mínimo: 100k. Valores abaixo de 100k são tratados como 100k.	k
ali_limit_start_hour	Integer	Não	Hora de início da limitação de taxa. Valores válidos: 0-24 (formato de 24 horas). Valor padrão: `0`.	20
ali_limit_end_hour	Integer	Não	Hora de término da limitação de taxa. Valores válidos: 0-24 (deve ser maior que a hora de início). Valor padrão: `24`.	23

Exemplo 1:

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

Exemplo 2: Defina um limite de taxa padrão de 1 MByte/s. Se a URL da requisição contiver o parâmetro rate, o limite de taxa seguirá o valor desse parâmetro. Por exemplo, se a URL contiver rate=200, o limite de taxa real será 200 KByte/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"
}

EdgeScript e funções de borda

edge_function

Descrição: Configura regras do EdgeScript.
ID da função: 180
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
rule	String	Sim	Regra DSL.	if eq($uri, '/') { rewrite('https://example.com/index.html', 'redirect') }
pri	Integer	Sim	Prioridade. Valores válidos: 0-999 (valor menor = maior prioridade). As prioridades das posições de execução head e foot são independentes.	0
enable	String	Sim	Defina se a regra está efetiva. Valores válidos: `on`, `off`.	on
name	String	Sim	Nome da regra (apenas letras e sublinhados).	test
pos	String	Não	Posição de execução. Valores válidos: `head` (padrão, intercepta no início do processamento da requisição), `foot` (intercepta no final do processamento da requisição).	head
brk	String	Não	Defina se a execução deve ser interrompida. Valores válidos: `on` (pula as regras restantes na posição de execução atual após esta regra ser correspondida), `off` (padrão, continua executando as regras restantes).	off
option	String	Não	Campo de extensão.	(vazio)
grammar	String	Não	Sintaxe da regra. Valores válidos: `es2` (padrão), `js`.	es2
jsmode	String	Não	Modo de execução JS. Valores válidos: `redirect` (modo de interceptação), `bypass` (padrão, modo de bypass).	bypass

Exemplo:

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

Funções de borda

edgeroutine

Descrição: Configura o Edge Routine (funções de borda).
ID da função: 275

Nota

Este recurso requer solicitação para ativação. Solicite a ativação deste recurso antes de usá-lo.

Mecanismo de regras

condition

Descrição: Configura o mecanismo de regras. Permite a configuração gráfica de regras de condição que identificam vários parâmetros nas requisições do usuário (como IP do cliente, URI, cabeçalhos, cookies) para determinar se uma configuração se aplica a uma requisição específica. Isso possibilita um controle mais flexível e preciso das políticas de configuração do CDN.
ID da função: 250
Parâmetros:

Nota

Este recurso requer solicitação para ativação. Solicite a ativação deste recurso antes de usá-lo.

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
rule	Array	Sim	Conteúdo da condição da regra, incluindo nome, status, lógica e critérios. O objeto criteria contém: matchType (o tipo de informação da requisição a ser correspondida), matchObject (refinamento adicional do tipo de correspondência), matchOperator (a ação de correspondência, como equals), matchValue (o valor a ser correspondido), negate (se deve negar o resultado, true ou false).	{"match":{"logic":"and","criteria":[{"matchType":"clientipVer","matchObject":"CONNECTING_IP","matchOperator":"equals","matchValue":"v6","negate":false}]},"name":"example","status":"enable"}
sequence	Integer	Não	Defina a prioridade de execução da configuração. Valores válidos: 1 a 99. Um valor menor indica maior prioridade. Se este parâmetro não for especificado, as prioridades são atribuídas automaticamente em ordem crescente a partir de 1.	1

Exemplo:

{
    "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"
}

Segurança

ali_location

Descrição: Configura o bloqueio de acesso baseado em região.
ID da função: 57
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
location	String	Sim	Regiões para aplicar a política de bloqueio. Suporta códigos de país de duas letras (padrão ISO 3166), separados por espaços. Também suporta global para bloqueio mundial.	CN
type	String	Sim	Tipo de política de bloqueio. Valores válidos: `black` (lista de bloqueios, bloqueia IPs de clientes das regiões especificadas), `white` (lista de permissões, bloqueia IPs de clientes de regiões não listadas).	black

Exemplo:

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

QUIC

iquic

Descrição: Configura parâmetros básicos do protocolo QUIC.
ID da função: 281
Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
iquic_enable	String	Sim	Defina se o protocolo QUIC deve ser ativado. Valores válidos: `on`, `off`.	on

Exemplo:

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