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> Consulta de uma tarefa de atualização ou pré-aquecimento do cache

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

Ver PDF

Consulta de uma tarefa de atualização ou pré-aquecimento do cache

Função

Essa API é usada para consultar uma tarefa de atualização ou pré-aquecimento de cache.

URI

GET /v1.0/cdn/historytasks/{history_tasks_id}/detail

**Tabela 1** Parâmetros de caminho
Parâmetro	Obrigatório	Tipo	Descrição
history_tasks_id	Sim	String	Especifica a ID da tarefa.

**Tabela 2** Parâmetros de consulta
Parâmetro	Obrigatório	Tipo	Descrição
enterprise_project_id	Não	String	Projeto corporativo ao qual o recurso pertence. 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.
page_size	Não	Integer	Especifica o número máximo de URLs para atualização ou pré-aquecimento em cada página. O valor varia de 1 a 10.000. Valor padrão: 30. Os valores de page_size e page_number devem ser passados juntos.
page_number	Não	Integer	Especifica o número da página a ser consultada. O valor varia de 1 a 65.535. Valor padrão: 1.
status	Não	String	Especifica o estado do URL. Valores possíveis: processing, succeed, failed, waiting, refreshing e preheating.
url	Não	String	Especifica o endereço URL.
create_time	Não	Long	Especifica a hora em que uma tarefa de pré-aquecimento foi criada. Se esse parâmetro não for passado, as tarefas nos últimos sete dias serão consultadas por padrão. Dados dos últimos 15 dias podem ser consultados.

Parâmetros de solicitação

**Tabela 3** Parâmetros do 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.

Parâmetros de resposta

Código de estado: 200

**Tabela 4** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
id	String	Especifica a ID da tarefa.
task_type	String	Tipo de tarefa. Valores possíveis: REFRESH (cache refrescante) e PREHEATING (cache pré-aquecimento).
status	String	Resultado da execução da tarefa. Valores possíveis: task_done (bem-sucedido) e task_inprocess (processamento).
urls	Array of UrlObject objects	Especifica a lista de URL da tarefa.
create_time	Long	Especifica a hora em que a tarefa foi criada.
processing	Integer	Especifica o número de URLs que estão sendo processados.
succeed	Integer	Especifica o número de URLs processados.
failed	Integer	Especifica o número de URLs que falharam no processamento.
total	Integer	Especifica o número total de URLs em tarefas históricas.
file_type	String	Tipo de arquivo. Valores possíveis: file (valor padrão) e directory.

**Tabela 5** UrlObject
Parâmetro	Tipo	Descrição
id	String	Especifica o ID da URL.
url	String	Especifica o endereço URL.
status	String	Especifica o estado do URL. Valores possíveis: processing, succeed, failed, waiting, refreshing e preheating.
create_time	Long	Especifica a hora em que o URL foi criado. O valor é o número de milissegundos desde a época UNIX (1 de janeiro de 1970).
task_id	String	Especifica a ID da tarefa.
task_type	String	Especifica o tipo de tarefa. Valores possíveis: REFRESH,PREHEATING e REFRESH_AFTER_PREHEATING.

Exemplos de solicitações

GET https://cdn.myhuaweicloud.com/v1.0/cdn/historytasks/ff808***********************b39/detail?page_size=10&page_number=1&enterprise_project_id=0

Exemplo de respostas

Código de estado: 200

{
  "id" : "ff80808xxxxxxxxx64797",
  "status" : "task_inprocess",
  "processing" : 2,
  "succeed" : 0,
  "failed" : 0,
  "urls" : [ {
    "url" : "http://www.example1.example2.com/index.html",
    "id" : "ff80808264exxxxxxxxx60c4fe74798",
    "status" : "processing",
    "create_time" : 1532867923942,
    "task_id" : "ff80808xxxxxxxxx64797",
    "task_type" : "PREHEATING"
  }, {
    "url" : "http://www.example1.example2.com/web",
    "id" : "ff80808*******************4799",
    "status" : "processing",
    "create_time" : 1532867923942,
    "task_id" : "ff80808xxxxxxxxx64797",
    "task_type" : "PREHEATING"
  } ],
  "task_type" : "preheating",
  "total" : 2,
  "create_time" : 1532867923942,
  "file_type" : "file"
}