Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Content Delivery Network/ Referência de API/ API/ Configuração de nome de domínio/ Configuração de uma regra de cache

Atualizado em 2022-12-26 GMT+08:00

Ver PDF

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

**Tabela 1** Parâmetros de caminho
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.

**Tabela 2** Parâmetros de consulta
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

**Tabela 3** Parâmetros de cabeçalho 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.

**Tabela 4** Parâmetros do corpo da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
cache_config	Sim	CacheConfigRequest object	Especifica a configuração de cache.

**Tabela 5** CacheConfigRequest
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.

**Tabela 6** CompressRequest
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).

**Tabela 7** Regras
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

**Tabela 8** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
cache_config	CacheConfig object	Especifica a configuração de cache.

**Tabela 9** CacheConfig
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.

**Tabela 10** CompressResponse
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.

**Tabela 11** CompressRules
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.

**Tabela 12** Regras
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

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