Configuração de uma regra de cache
Função
Essa API é usada para configurar uma regra de cache de conteúdo para nós CDN.
URI
PUT /v1.0/cdn/domains/{domain_id}/cache
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
domain_id | Sim | String | Especifica o ID de nome de domínio acelerado. Para obter detalhes, consulte Consulta de detalhes sobre um nome de domínio. |
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
enterprise_project_id | Não | String | Projeto corporativo ao qual pertence o nome de domínio a ser modificado. Este parâmetro é válido somente quando a função do projeto empresarial está ativada. O valor all indica todos os projetos. Esse parâmetro é obrigatório quando você usa um usuário do IAM para chamar essa API. |
Parâmetros de solicitação
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
X-Auth-Token | Sim | String | Especifica o token do usuário. The token can be obtained by calling the IAM API used to obtain a user token. The value of **X-Subject-Token** in the response header is the user token. |
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
cache_config | Sim | CacheConfigRequest object | Especifica a configuração de cache. |
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
ignore_url_parameter | Não | Boolean | Especifica se os parâmetros de URL serão ignorados. |
follow_origin | Não | Boolean | Especifica se o controle de cache de origem deve ser ativado. |
compress | Não | CompressRequest object | Especifica as configurações de compactação gzip. |
rules | Não | Array of Rules objects | Especifica as regras de cache, que sobrescrevem as configurações de regra anteriores. Regras em branco são redefinidas para regras padrão. |
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
compress_switch | Não | Integer | Especifica se a compactação gzip está ativada. Valores possíveis: 0 (desativado) e 1 (ativado). |
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
rule_type | Sim | Integer | 0: todos os tipos de arquivos são correspondidos. É o valor padrão. 1: os arquivos são correspondidos com base em seus sufixos. 2: os arquivos são correspondidos com base em seus diretórios. 3: os arquivos são correspondidos com base em seus caminhos completos. |
content | Não | String | Especifica o conteúdo que corresponde a rule_type.Se rule_type estiver definido como 0, este parâmetro estará vazio.Se rule_type estiver definido como 1, o valor deste parâmetro é uma lista de extensões de nome de arquivo. Uma extensão de nome de arquivo começa com um ponto (.). As extensões de nome de arquivo são separadas por ponto e vírgula (;), por exemplo, .jpg;.zip;.exe.Se rule_type for definido como 2, o valor deste parâmetro é uma lista de diretórios. Um diretório começa com uma barra (/). Os diretórios são separados por ponto e vírgula (;), por exemplo, /test/folder01;/test/folder02. |
ttl | Sim | Integer | Especifica a idade do cache. A idade máxima do cache é de 365 dias. |
ttl_type | Sim | Integer | Especifica a unidade da idade do cache. Valores possíveis: 1 (segundo), 2 (minuto), 3 (hora) e 4 (dia). |
priority | Sim | Integer | Especifica o peso de prioridade desta regra. O valor padrão é 1. Um valor maior indica uma prioridade mais alta. O valor varia de 1 a 100. Os valores de peso devem ser únicos. |
Parâmetros de resposta
Código de estado: 200
Parâmetro | Tipo | Descrição |
|---|---|---|
cache_config | CacheConfig object | Especifica a configuração de cache. |
Parâmetro | Tipo | Descrição |
|---|---|---|
ignore_url_parameter | Boolean | Especifica se os parâmetros de URL serão ignorados. |
follow_origin | Boolean | Especifica se o controle de cache de origem deve ser ativado. |
compress | CompressResponse object | Especifica as configurações de compactação gzip. |
rules | Array of Rules objects | Especifica as regras de cache, que sobrescrevem as configurações de regra anteriores. Regras em branco são redefinidas para regras padrão. |
Parâmetro | Tipo | Descrição |
|---|---|---|
compress_switch | Integer | Especifica se a compactação gzip está ativada. Valores possíveis: 0 (desativado) e 1 (ativado). |
compress_rules | Array of CompressRules objects | Especifica a regra de compactação gzip. |
Parâmetro | Tipo | Descrição |
|---|---|---|
compress_type | String | Especifica o tipo de compactação. Atualmente, o valor só pode ser definido para gzip. |
compress_file_type | String | Especifica os tipos de arquivo suportados pela compactação gzip. Os tipos de arquivo são separados por barras verticais (|), por exemplo, .js|.html|.css|.xml. |
Parâmetro | Tipo | Descrição |
|---|---|---|
rule_type | Integer | 0: todos os tipos de arquivos são correspondidos. É o valor padrão. 1: os arquivos são correspondidos com base em seus sufixos. 2: os arquivos são correspondidos com base em seus diretórios. 3: os arquivos são correspondidos com base em seus caminhos completos. |
content | String | Especifica o conteúdo que corresponde a rule_type.Se rule_type estiver definido como 0, este parâmetro estará vazio.Se rule_type estiver definido como 1, o valor deste parâmetro é uma lista de extensões de nome de arquivo. Uma extensão de nome de arquivo começa com um ponto (.). As extensões de nome de arquivo são separadas por ponto-e-vírgula (;), por exemplo, .jpg;.zip;.exe.Se rule_type for definido como 2, o valor deste parâmetro é uma lista de diretórios. Um diretório começa com uma barra (/). Os diretórios são separados por ponto e vírgula (;), por exemplo, /test/folder01;/test/folder02. |
ttl | Integer | Especifica a idade do cache. A idade máxima do cache é de 365 dias. |
ttl_type | Integer | Especifica a unidade da idade do cache. Valores possíveis: 1 (segundo), 2 (minuto), 3 (hora) e 4 (dia). |
priority | Integer | Especifica o peso de prioridade desta regra. O valor padrão é 1. Um valor maior indica uma prioridade mais alta. O valor varia de 1 a 100. Os valores de peso devem ser únicos. |
Exemplos de solicitações
PUT https://cdn.myhuaweicloud.com/v1.0/cdn/domains/ff808***********************2d71/cache?enterprise_project_id=0
{
"cache_config" : {
"ignore_url_parameter" : false,
"follow_origin" : false,
"compress" : {
"compress_switch" : 1
},
"rules" : [ {
"rule_type" : 1,
"content" : ".jpg;.png",
"ttl" : 30,
"ttl_type" : 3,
"priority" : 1
} ]
}
} Exemplo de respostas
Código de estado: 200
OK
{
"cache_config" : {
"rules" : [ {
"rule_type" : 1,
"content" : ".jpg;.png",
"ttl" : 30,
"ttl_type" : 3,
"priority" : 1
}, {
"rule_type" : 0,
"content" : "",
"ttl" : 600,
"ttl_type" : 1,
"priority" : 1
} ],
"ignore_url_parameter" : false,
"follow_origin" : false,
"compress" : {
"compress_switch" : 1,
"compress_rules" : [ {
"compress_type" : "gzip",
"compress_file_type" : ".js|.html|.css|.xml|.json|.shtml|.htm"
} ]
}
}
} Códigos de status
Código de status | Descrição |
|---|---|
200 | OK |
Códigos de erro
Consulte Códigos de erro.

