Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda> Content Delivery Network> Referencia de la API> API> Actualización y precalentamiento de caché> Consulta de una tarea de actualización o precalentamiento de caché

Actualización más reciente 2022-11-03 GMT+08:00

Ver PDF

Consulta de una tarea de actualización o precalentamiento de caché

Función

Esta API se utiliza para consultar una tarea de actualización o precalentamiento de caché.

URI

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

**Tabla 1** Parámetros de path
Parámetro	Obligatorio	Tipo	Descripción
history_tasks_id	Sí	String	Especifica el ID de la tarea.

**Tabla 2** Parámetros de Query
Parámetro	Obligatorio	Tipo	Descripción
enterprise_project_id	No	String	Proyecto de empresa al que pertenece el recurso. Este parámetro sólo es válido cuando la función de proyecto de empresa está habilitada. El valor all indica todos los proyectos. Este parámetro es obligatorio cuando se utiliza un usuario de IAM para llamar a esta API.
page_size	No	Integer	Especifica el número máximo de direcciones URL para actualizar o precalentar en cada página. El valor oscila entre 1 y 10,000. Valor predeterminado: 30. Los valores de page_size y page_number deben pasarse juntos.
page_number	No	Integer	Especifica el número de la página que se va a consultar. El valor oscila entre 1 y 65,535. Valor predeterminado: 1.
status	No	String	Especifica el estado de la dirección URL. Valores posibles: processing, succeed, failed, waiting, refreshing, y preheating.
url	No	String	Especifica la dirección URL.
create_time	No	Long	Especifica la hora a la que se creó una tarea de precalentamiento. Si no se pasa este parámetro, las tareas de los últimos siete días se consultan de forma predeterminada. Los datos de los últimos 15 días se pueden consultar.

Parámetros de solicitud

**Tabla 3** Parámetros de encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Especifica el token de usuario. 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 respuesta

Código de estado: 200

**Tabla 4** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
id	String	Especifica el ID de la tarea.
task_type	String	Tipo de tarea. Valores posibles: REFRESH (refrescamiento en caché) y PREHEATING (precalentamiento en caché).
status	String	Resultado de ejecución de tareas. Valores posibles: task_done (satisfactorio) y task_inprocess (procesamiento).
urls	Array of UrlObject objects	Especifica la lista de direcciones URL de la tarea.
create_time	Long	Especifica la hora en que se creó la tarea.
processing	Integer	Especifica el número de direcciones URL que se están procesando.
succeed	Integer	Especifica el número de direcciones URL procesadas.
failed	Integer	Especifica el número de direcciones URL que no se han procesado.
total	Integer	Especifica el número total de direcciones URL en las tareas históricas.
file_type	String	File type. Valores posibles: file (valor predeterminado) y directory.

**Tabla 5** UrlObject
Parámetro	Tipo	Descripción
id	String	Especifica el ID de URL.
url	String	Especifica la dirección URL.
status	String	Especifica el estado de la dirección URL. Valores posibles: processing, succeed, failed, waiting, refreshing, y preheating.
create_time	Long	Especifica la hora a la que se creó la dirección URL. El valor es el número de milisegundos desde la época UNIX (1 de enero de 1970).
task_id	String	Especifica el ID de la tarea.
task_type	String	Especifica el tipo de tarea. Valores posibles: REFRESH,PREHEATING y REFRESH_AFTER_PREHEATING.

Solicitudes de ejemplo

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

Ejemplo de respuestas

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