Consulta del consumo de cada nombre de dominio
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 de resumen sobre cada nombre de dominio dentro de un intervalo de tiempo.
URI
GET /v1.0/cdn/statistics/domain
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 |
Yes |
String |
Especifica una lista de nombres de dominio. Utilice comas (,) para separar los nombres de dominio. Por ejemplo, www.test1.com,www.test2.com. El número máximo de nombres de dominio es 20. |
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 4 xx), 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?start_time=1513094400000&end_time=1513180799346&domain_name=example1.example2.com,example3.example4.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 |
Object |
Especifica las estadísticas del nombre de dominio. Para más detalles, consulte Tabla 3. |
descripción del parámetro de dominio
Tabla 3 describe los parámetros.
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 tráfico total consultado. 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. |
domain_name |
String |
Especifica el nombre de dominio. |
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": [ { "value": 197400, "start_time": 1513094400000, "end_time": 1513180799346, "stat_type": "flux", "domain_name": "example1.example2.com", "service_area": "mainland_china" }, { "value": 42825, "start_time": 1513094400000, "end_time": 1513180799346, "stat_type": "flux", "domain_name": "example3.example4.com", "service_area": "mainland_china" } ] }
Código de estado
Consulte Códigos de estado.
Código de error
Consulte Códigos de error.