Consulta del resumen del 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, pero se permiten intervalos exactos de una hora o un día (00:00:00). Si el lapso de tiempo es inferior a 7 días, 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 lapso de tiempo es superior a 7 días pero inferior a 31 días, 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 información resumida sobre nombres de dominio específicos dentro de un intervalo de tiempo.
URI
GET /v1.0/cdn/statistics/domain-summary
Solicitud
Parámetros de solicitud
Tabla 1 describe los 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 |
Sí |
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. |
|
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), 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 fallos 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?start_time=1513094400000&end_time=1513180799346&domain_name=example3.example2.example1.com&interval=300&stat_type=flux&enterprise_project_id=0
Respuesta
Parámetros de respuesta
Tabla 2 describe el parámetro de respuesta.
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
domain_summary |
Object |
Especifica el total de los objetos de datos consultados. Para más detalles, consulte Tabla 3. |
descripción de parámetro de domain_summary
|
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). |
|
value |
Integer |
Especifica el valor total de una métrica (unidad de tráfico: byte; unidad de ancho de banda: 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. |
{
"domain_summary": {
"value": 835038584,
"start_time": 1513094400000,
"end_time": 1513180799346,
"stat_type": "flux",
"service_area": "mainland_china"
}
}
Código de estado
Consulte Códigos de estado.
Código de error
Consulte Códigos de error.
