Routers

Crear un router

Declara un nuevo router, cortafuegos, conmutador o punto de acceso.

Scope requerido infrastructure:add

post/routers

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.

Cuerpo de la solicitudapplication/json

namestringobligatorio

Nombre del equipo.

typeenum<string>obligatorio

Tipo del recurso.

Valores posibles: router, firewall, switch, access_point

ipAddressstring

Dirección de administración del equipo.

locationstring

Ubicación física.

descriptionstring

Breve descripción libre.

internetConnectionstring

Enlace a Internet que lleva el equipo.

Respuesta201 · application/json

El equipo se ha creado.

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.

curl --request POST \ --url https://app.kabeen.io/public/v1/routers \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "name": "<string>", "type": "router", "ipAddress": "<string>", "location": "<string>", "description": "<string>", "internetConnection": "<string>" }'

{ "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 } ] }