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> APIs desatualizadas> Atualização e pré-aquecimento (versão anterior)> Criação de uma tarefa de atualização de cache

Atualizado em 2023-02-27 GMT+08:00

Ver PDF

Criação de uma tarefa de atualização de cache

Função

Essa API é usada para criar uma tarefa de atualização de cache.

URI

POST /v1.0/cdn/refreshtasks

Tabela 1 lista os parâmetros.

**Tabela 1** Descrição do parâmetro
Parâmetro	Obrigatório	Tipo	Descrição
enterprise_project_id	Não	String	Projeto corporativo ao qual a tarefa de atualização do cache é adicionada. 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.

solicitação

Parâmetros de solicitação

Tabela 2 descreve os parâmetros de solicitação.

**Tabela 2** Parâmetros de solicitação
Parâmetro	Obrigatório	Tipo	Descrição
type	Não	String	Especifica o tipo de conteúdo em cache a ser atualizado. O valor é file ou directory. O valor padrão é file.
urls	Sim	Array of strings	Exemplo de valor: http://abc.com/image/1.png. Use vírgulas (,) para separar os URLs umas das outras. Um único URL pode conter um máximo de caracteres 10.240. Um máximo de 1.000 URLs podem ser inseridos por vez.

Exemplos de solicitações

Caminho solicitado

POST https://cdn.myhuaweicloud.com/v1.0/cdn/refreshtasks?enterprise_project_id=0

{
    "refreshTask":{
        "type":"file",
        "urls":[
            "http://www.example.com/index.html",
            "http://www.example.com/web"
        ]
    }
}

Resposta

Parâmetros de resposta

Tabela 3 descreve os parâmetros de resposta.

**Tabela 3** Parâmetros de resposta
Parâmetro	Tipo	Descrição
id	String	Especifica a ID da tarefa.
task_type	String	Especifica o tipo de uma tarefa. O valor é refresh ou preheating.
status	String	Especifica o status de uma tarefa após a atualização. task_done indica que a tarefa de atualização foi bem-sucedida. task_inprocess indica que a tarefa de atualização está sendo processada.
processing	Integer	Especifica o número de URLs que estão sendo processados.
succeed	Integer	Especifica o número de URLs processados com êxito.
failed	Integer	Especifica o número de URLs que falharam no processamento.
total	Integer	Especifica o número total de tarefas.
create_time	Integer	Especifica a hora em que a tarefa é criada, que é expressa em milissegundos desde 01/01/1970 00:00:00 Tempo Universal Coordenado (UTC).
urls	Array of strings	Especifica os URLs que precisam ser atualizados.

Exemplo de respostas

{
  "refreshTask" : {
    "id" : "ff808***********************2b35",
    "status" : "task_inprocess",
    "processing" : 2,
    "succeed" : 0,
    "failed" : 0,
    "urls" : [ "http://www.example1.com/index.html", "http://www.example2.com/web" ],
    "task_type" : "refresh",
    "total" : 2,
    "create_time" : 0
  }
}