Saltar a la navegación

Obtener telemetría de puerto

Ver como Markdown

Devuelve detalles de telemetría para el Puerto especificado.

El productUid es el identificador de producto único y es obligatorio.

Se pueden pasar múltiples tipos de telemetría. Por ejemplo, GET /v2/product/megaport/5624060e-32gb-4267-a340-c15e91bc0f82/telemetry?type=BITS&type=PACKETS&days=30. Cuando se pasan varios tipos de telemetría, el tipo de nivel superior se establece en null en la respuesta. La información clave para cada tipo de telemetría está en la sección {data} de la respuesta.

Se debe proporcionar un mínimo de un tipo de telemetría.

Los detalles de telemetría se pueden devolver por número de días en el pasado, o pasando un rango de fechas: ‘from’ y ‘to’. Si no se pasan days, o to y from, se devuelve la medición más reciente, que es aproximadamente cada 5 minutos.

El número máximo de días que se puede solicitar es 180 días.

Nota: El parámetro days es mutuamente excluyente con to y from. Si se pasan tanto days como from y to, se devuelve un error explicando que los campos son mutuamente excluyentes.

Puede devolver detalles de telemetría en formato CSV especificando el parámetro de encabezado text/csv.

Parámetros de ruta

productUidstringRequerido

Parámetros de consulta

typestringOpcional

Indica el tipo de métrica. Los valores incluyen BITS, PACKETS, ERRORS y OPTICAL. Se pueden pasar varios tipos de telemetría. (Obligatorio - cadena)

fromstringOpcional

Milisegundos desde la época. Cuando no se proporciona, devuelve la medición más reciente. Puede utilizar una herramienta como https://www.epochconverter.com/ para la conversión hacia y desde fechas. (Opcional - cadena)

tostringOpcional

Milisegundos desde la época. Cuando no se proporciona, devuelve la medición más reciente. Puede usar una herramienta como https://www.epochconverter.com/ para la conversión desde y hacia fechas. (Opcional - cadena)

daysstringOpcional

El número de días en el pasado desde hoy para los que se devolverán los detalles de telemetría. Este parámetro es mutuamente excluyente de "to" y "from". (Opcional - cadena)

Respuesta

Obtener Telemetría de Puerto - Tipo de Telemetría Único (Desde, Hasta) / Obtener Telemetría de Puerto - Tipo de Telemetría Único (Días) / Obtener Telemetría de Puerto - Múltiples Tipos de Telemetría (Días) / Obtener Telemetría de Puerto - CSV Tipo de Telemetría Único (Desde, Hasta) / Obtener Telemetría de Puerto - CSV Tipo de Telemetría Único (Días) / Obtener Telemetría de Puerto - CSV Múltiples Tipos de Telemetría (Días) / Obtener Telemetría de Puerto - Múltiples Tipos de Telemetría (Días) / Obtener Telemetría de Puerto - Tipo de Telemetría Único (Desde, Hasta) / Obtener Telemetría de Puerto - Tipo de Telemetría Único (Días) / Obtener Telemetría de Puerto - CSV Múltiples Tipos de Telemetría (Días) / Obtener Telemetría de Puerto - CSV Tipo de Telemetría Único (Desde, Hasta) / Obtener Telemetría de Puerto - CSV Tipo de Telemetría Único (Días)

datalist of objectsOpcional
serviceUidstringOpcional
timeFrameobjectOpcional
typestring or nullOpcional