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> Análisis estadístico> Consulta de las 100 principales URLs

Actualización más reciente 2023-12-18 GMT+08:00

Ver PDF

Consulta de las 100 principales URLs

Función

Esta API se utiliza para consultar las 100 URL principales.
Puede consultar datos en los últimos 90 días.
El lapso de tiempo de consulta no puede exceder los 31 días.
La hora de inicio y la hora de finalización deben especificarse. Por ejemplo, si la hora de inicio es 2021-10-24 00:00:00 y la hora de finalización es 2021-10-25 00:00:00, las estadísticas en [2021-10-24 00:00:00, 2021-10-25 00:00:00) son consultados.
La hora de inicio y la hora de finalización deben ser marcas de tiempo en milisegundos. Deben ser las 00:00:00. De lo contrario, los datos devueltos pueden no ser los datos esperados.
Las métricas de tráfico se miden por byte, y las métricas de solicitud se miden por el número de veces. Puede consultar estadísticas sobre nombres de dominio específicos por métricas específicas.
Un solo inquilino puede llamar a esta API cinco veces por segundo.

URI

GET /v1.0/cdn/statistics/top-url

**Tabla 1** 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.
start_time	Sí	Long	Especifica la hora de inicio de la consulta (marca de tiempo, en milisegundos). La información horaria convertida desde la marca de tiempo debe tener el formato XXXX-XX-XX 00:00:00.
end_time	Sí	Long	Especifica la hora de finalización de la consulta (marca de tiempo, en milisegundos). La información horaria convertida desde la marca de tiempo debe tener el formato XXXX-XX-XX 00:00:00.
domain_name	Sí	String	Especifica la lista de nombres de dominio. Los nombres de dominio están separados por comas (,), por ejemplo, www.test1.com,www.test2.com. El valor ALL indica que se consultan todos los nombres de dominio de su cuenta.
service_area	No	String	Valores posibles: mainland_china y outside_mainland_china. El valor predeterminado es mainland_china.
stat_type	Sí	String	Especifica los tipos de estadísticas. Valores posibles: flux (tráfico) y req_num (peticiones totales).

Parámetros de solicitud

Ninguno

Parámetros de respuesta

Código de estado: 200

**Tabla 2** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
service_area	String	Especifica el área de servicio.
top_url_summary	Array of TopUrlSummary objects	Especifica los datos detallados.

**Tabla 3** TopUrlSummary
Parámetro	Tipo	Descripción
url	String	Especifica el nombre de la dirección URL.
value	Long	Especifica el valor devuelto de una consulta. Unidad de tráfico: byte.
start_time	Long	Especifica la hora de inicio de la consulta (marca de tiempo).
end_time	Long	Especifica la hora de finalización de la consulta (marca de tiempo).
stat_type	String	Especifica los tipos de estadísticas. Valores posibles: flux (tráfico) y req_num (peticiones totales).

Solicitudes de ejemplo

Ninguno

Ejemplo de respuestas

Código de estado: 200

{
  "top_url_summary" : [ {
    "url" : "www.test01.com",
    "value" : 888,
    "start_time" : 1511366400000,
    "end_time" : 1511452799640,
    "stat_type" : "req_num"
  }, {
    "url" : "www.yyy.com",
    "value" : 666,
    "start_time" : 1511366400000,
    "end_time" : 1511452799640,
    "stat_type" : "req_num"
  } ],
  "service_area" : "mainland"
}