Criação de uma tarefa de pré-aquecimento de cache
Função
Essa API é usada para criar uma tarefa de pré-aquecimento de cache.
URI
POST /v1.0/cdn/preheatingtasks
Tabela 1 lista os parâmetros.
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.
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
urls |
Sim |
Array of strings |
Exemplo de valor: http://abc.com/image/1.png. Use vírgulas (,) para separar os URLs umas das outras. O pré-aquecimento para diretórios ainda não está disponível. Um único URL pode conter um máximo de caracteres 10.240. Os URLs do 1 000 podem ser inseridos de cada vez. |
Exemplos de solicitações
Caminho solicitado
{ "preheatingTask":{ "urls":[ "http://www.example1.com/index.html", "http://www.example2.com/web" ] } }
Resposta
Parâmetros de resposta
Tabela 3 descreve os 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 de pré-aquecimento. task_done indica que a tarefa de pré-aquecimento foi bem-sucedida. task_inprocess indica que a tarefa está sendo pré-aquecida. |
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 pré-aquecidos. |
{ "preheatingTask" : { "id" : "ff8080*********************c6e", "status" : "task_inprocess", "processing" : 2, "succeed" : 0, "failed" : 0, "urls" : [ "http://www.example1.com/index.html", "http://www.example2.com/web" ], "task_type" : "preheating", "total" : 2, "create_time" : 0 } }
Código de estado
Consulte Códigos de estado.
Código de erro
Consulte Códigos de erro.