Consulta de estadísticas sobre nombres de dominio en una región o una operadora
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. El tiempo de inicio y el tiempo de finalización deben ser precisos hasta el milisegundo, pero solo se permiten intervalos de muestreo exactos. Por ejemplo, si el intervalo de muestreo es de 5 minutos, la hora de inicio y la hora de finalización pueden ser 2020-07-01 08:05:00 y 2020-07-01 08:10: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 las estadísticas de nombres de dominio bajo un operador especificado en una región especificada y un período de tiempo especificado.
URI
GET /v1.0/cdn/statistics/region-carrier-detail
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, incluidos flux (tráfico), bw (ancho de banda) y req_num (total de solicitudes). |
region |
Sí |
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:
El valor ALL indica que se consultan todas las regiones. |
carrier |
Sí |
String |
Especifica la lista de operadores. Los nombres abreviados de los portadores se utilizan aquí. Actualmente, los valores válidos son CTCC (China Telecom), CUCC (Unicom), ENET (Red China de Educación e Investigación), CMCC (Móvil China) y CRC (Tietong). Los nombres de los portadores están separados por comas (,). Por ejemplo, CTCC,CMCC. El valor ALL indica que se consultan todas las operadores. region y carrier no se pueden establecer en ALL. |
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, el valor puede ser de 5 minutos, 1 hora, 4 horas u 8 horas. Para un lapso de tiempo de 2 a 7 días, el valor puede ser de 5 minutos, 1 hora, 4 horas, 8 horas o 1 día. Para un lapso de tiempo de 8 a 31 días, el valor puede ser de 4 horas, 8 horas o 1 día. 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. Si necesita especificarlo en la solicitud, convierta el intervalo en segundos. |
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-carrier-detail?start_time=1559318400000&end_time=1559577600000&domain_name=www.test1.com,www.test2.com,www.test3.com,www.test4.com&stat_type=req_num®ion=beijing&carrier=CMCC&interval=86400&enterprise_project_id=0
Respuesta
Parámetros de respuesta
Tabla 2 describe los parámetros de respuesta.
Parámetro |
Tipo |
Descripción |
---|---|---|
region |
Array of strings |
Especifica la región. |
carrier |
Array of strings |
Especifica el operador. |
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). |
stat_type |
String |
Especifica los tipos de estadísticas, incluidos flux (tráfico), bw (ancho de banda) y req_num (total de solicitudes). |
interval |
Integer |
Especifica el intervalo de muestreo. |
values |
Array of integers |
Especifica el valor devuelto de una consulta. Los datos de un cierto período de tiempo se muestran basándose en la granularidad del tiempo de consulta. Los valores están separados por comas (,). La unidad de tráfico es byte. La unidad de ancho de banda es bit/s.
NOTA:
Si se consultan varios nombres de dominio, el valor devuelto es el resultado total de la consulta de todos los nombres de dominio. |
{ "region": [ "beijing" ], "carrier": [ "all" ], "start_time": 1559318400000, "end_time": 1559577600000, "stat_type": "req_num", "values": [ 66, 64, 68 ], "interval": 86400 }
Código de estado
Consulte Códigos de estado.
Código de error
Consulte Códigos de error.