Routers

Obtener un router

La ficha completa de un equipo, con sus redes y sus etiquetas.

Scope requerido infrastructure:read

get/routers/{id}

Autenticación

Authorizationstringobligatorio

Cabecera Authorization con una clave de API del espacio de trabajo, con la forma «Bearer kbn_live_…». La cabecera X-Api-Key se acepta de forma equivalente.

Parámetros de ruta

idstring<uuid>obligatorio

Identificador del recurso objetivo.

Respuesta200 · application/json

La ficha del equipo.

idstring<uuid>obligatorio

Identificador único.

namestringobligatorio

Nombre del equipo.

typeenum<string>obligatorio

Tipo de equipo.

Valores posibles: router, firewall, switch, access_point

ipAddressstring | null

Dirección de administración del equipo.

locationstring | null

Ubicación física.

descriptionstring | null

Breve descripción libre.

internetConnectionstring | null

Enlace a Internet que lleva el equipo.

criticalitystring | null

Criticidad de negocio asignada.

tagsany[]

Etiquetas vinculadas al recurso.

networksobject[]

Redes a las que está conectado el equipo.

customFieldsany[]

Campos personalizados del espacio de trabajo y sus valores.

{ "id": "3f9c9f2e-8a71-4e2a-9b0d-2c5f6a1d7e44", "name": "<string>", "type": "router", "ipAddress": "<string>", "location": "<string>", "description": "<string>", "internetConnection": "<string>", "criticality": "<string>", "tags": [ { "id": "3f9c9f2e-8a71-4e2a-9b0d-2c5f6a1d7e44", "name": "<string>" } ], "networks": [ { "id": "3f9c9f2e-8a71-4e2a-9b0d-2c5f6a1d7e44", "name": "<string>", "role": "<string>", "interfaceAddress": "<string>" } ], "customFields": [ { "id": "3f9c9f2e-8a71-4e2a-9b0d-2c5f6a1d7e44", "name": "<string>", "type": "text", "description": "<string>", "value": null } ] }