Consulta de Consumo de Dominio por Región
Puede consultar datos en los últimos 90 días.
El lapso de tiempo de los datos consultados no puede exceder los 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 5 minutos, 1 hora o 4 horas. Si el intervalo de tiempo es menor o igual a un día, la granularidad de tiempo es de 5 minutos, por ejemplo, 2020-07-01 08:05:00 y 2020-07-01 08:10:00. Si el lapso de tiempo es mayor que 1 día pero menor que o igual a 7 días, la granularidad de tiempo es de 1 hora. Si el lapso de tiempo es superior a 7 días, la granularidad del tiempo es de 4 horas.
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 el consumo de nombres de dominio por región dentro de un intervalo de tiempo.
URI
GET /v1.0/cdn/statistics/region-detail-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 |
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. |
stat_type |
Sí |
String |
Especifica los tipos de estadísticas, incluidos flux (tráfico), bw (ancho de banda) y req_num (total de solicitudes). |
region |
No |
String |
Especifica la lista de regiones, que abarca las 34 divisiones de nivel provincial (incluidos Hong Kong, Macao y Taiwán) de China y las regiones fuera de China y otras. Separar estas regiones con comas (,). Por ejemplo, beijing, neimenggu.
NOTA:
Si este parámetro se establece en ALL o no se incluye en una solicitud, se consultan todas las regiones. |
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/region-detail-summary?start_time=1511366400000&end_time=1511452799640&domain_name=ALL&stat_type=req_num®ion=beijing,neimenggu&enterprise_project_id=0
Respuesta
Parámetros de respuesta
Tabla 2 describe el parámetro de respuesta.
Parámetro |
Tipo |
Descripción |
---|---|---|
region_data |
Array of objects |
Especifica la lista de datos detallada de la región. Para más detalles, consulte Tabla 3. |
descripción de parámetro de region_data
Tabla 3 describe los parámetros.
Parámetro |
Tipo |
Descripción |
---|---|---|
region |
String |
Especifica la región. |
value |
Integer |
Especifica el valor de la métrica consultada. La unidad de tráfico es byte. La unidad de ancho de banda es bit/s. |
{ "region_data": [ { "region": "beijing", "value": 586 }, { "region": "neimenggu", "value": 862 } ] }
Código de estado
Consulte Códigos de estado.
Código de error
Consulte Códigos de error.