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.