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/ Out-of-Date APIs/ Análisis de estadísticas/ Consulta de detalles de consumo

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

Ver PDF

Consulta de detalles de consumo

Puede consultar datos en los últimos 90 días.

El lapso de tiempo varía de 1 hora a 31 días.

Puede especificar hasta 100 nombres de dominio en una consulta.

La hora de inicio y la hora de finalización deben especificarse al mismo tiempo. Sus valores deben ser precisos hasta el milisegundo. Si el intervalo de muestreo es inferior o igual a 1 hora, la granularidad del tiempo debe ser de una hora, por ejemplo, 2020-07-01 08:00:00 y 2020-07-01 09:00:00. Si el intervalo de muestreo es superior a 1 hora, la granularidad del tiempo debe ser de un día entero, por ejemplo, 2020-07-01 00:00:00 y 2020-07-02 00:00:00.

Si la hora de inicio y la hora de finalización no cumplen con los requisitos, los datos devueltos pueden ser diferentes de lo esperado.

Función

Esta API se utiliza para consultar detalles de consumo sobre nombres de dominio específicos dentro de un intervalo de tiempo.

URI

GET /v1.0/cdn/statistics/domain-summary-detail

Solicitud

Parámetros de solicitud

Tabla 1 describe los parámetros de solicitud.

**Tabla 1** Parámetros de solicitud
Parámetro	Obligatorio	Tipo	Descripción
start_time	No	Integer	Especifica la hora de inicio de una consulta (marca de tiempo, en milisegundos).
end_time	No	Integer	Especifica la hora de finalización de una consulta (marca de tiempo, en milisegundos).
domain_name	Yes	String	Especifica una lista de nombres de dominio. Utilice comas (,) para separar nombres de dominio, por ejemplo, www.test1.com,www.test2.com. El valor ALL indica que se consultan todos los nombres de dominio de un inquilino. Se puede consultar un máximo de 100 nombres de dominio a la vez.
interval	No	Integer	Especifica el intervalo de muestreo. interval se mide en segundos, y sus valores se describen como sigue: Para un lapso de tiempo de 1 día, los intervalos de muestreo pueden ser de 5 minutos, 1 hora, 4 horas y 8 horas. Es decir, los valores pueden ser 300, 3600, 14400, y 28800. Para un lapso de tiempo de 2 a 7 días, los intervalos de muestreo pueden ser de 5 minutos, 1 hora, 4 horas, 8 horas y 1 día. Es decir, los valores pueden ser 300, 3600, 14400, 28800, y 86400. Para un lapso de tiempo de 8 a 31 días, los intervalos de muestreo pueden ser de 4 horas, 8 horas y 1 día. Es decir, los valores pueden ser 14400, 28800, y 86400. Si no especifica un valor para el interval, el sistema utiliza el valor más pequeño correspondiente al intervalo de tiempo consultado de forma predeterminada.
stat_type	Sí	String	Especifica los tipos de estadísticas: bw (ancho de banda), flux (tráfico), bs_bw (ancho de banda de recuperación), bs_flux (tráfico de recuperación), bs_num (número total de solicitudes de recuperación), bs_fail_num (número total de recuperaciones fallidas), req_num (número total de solicitudes), req_hit_rate (ratio de aciertos de caché), flux_hit_rate (ratio de aciertos de tráfico), bs_fail_rate (tasa de fallo de recuperación), qps (solicitudes por segundo), http_code_2xx (código de estado 2xx), http_code_3xx (código de estado 3xx), http_code_4xx (código de estado 4xx), y http_code_5xx (código de estado 5xx).
service_area	No	String	Los valores válidos son mainland_china y outside_mainland_china. El valor predeterminado es mainland_china. No puede consultar las métricas de recuperación, incluidas bs_flux, bs_bw, y bs_fail_rate por área de servicio.
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.

Solicitud de ejemplo

Ruta de acceso solicitada

GET https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/domain-summary-detail?start_time=1498838400000&end_time=1502380500000&domain_name=www.example.com&interval=300&stat_type=bs_flux&enterprise_project_id=0

Respuesta

Parámetros de respuesta

Tabla 2 describe el parámetro de respuesta.

**Tabla 2** Parámetro de respuesta
Parámetro	Tipo	Descripción
domain_summary_detail	Object	Especifica los datos detallados. Para más detalles, consulte Tabla 3.

descripción de parámetro de domain_summary_detail

Tabla 3 describe los parámetros.

**Tabla 3** descripción de parámetro de domain_summary_detail
Parámetro	Tipo	Descripción
start_time	Integer	Especifica la hora de inicio de una consulta (marca de tiempo, en milisegundos).
end_time	Integer	Especifica la hora de finalización de una consulta (marca de tiempo, en milisegundos).
interval	Integer	Especifica el intervalo de muestreo, medido por segundos.
values	Array of integers	Especifica la matriz de puntos de muestreo. Cada punto de muestreo se genera en cada intervalo de muestreo. El tipo de cada punto de muestreo es largo. La unidad de tráfico es byte. La unidad de ancho de banda es bit/s.
stat_type	String	Especifica el tipo de estadísticas.
service_area	String	Los valores válidos son mainland_china (China continental) y outside_mainland_china (fuera de China continental). No puede consultar métricas de recuperación por área de servicio.

Ejemplo de respuesta

{
  "domain_summary_detail": {
        "interval": 300,
        "values": [835038583,835038584],
        "start_time": 1498838400000,
        "end_time": 1502380500000,
        "stat_type": "bs_flux",
        "service_area": "outside_example_china"
   }
}