Conceptos de redes de la API

Una red virtual llega al servidor en uno de sus segmentos como una VLAN. Los bloques de IP están en una red y contienen las direcciones asignadas a servidores y su DNS inverso. Las redes están en /v1/networking/virtual-networks y los bloques en /v1/networking/ip-blocks.

Consulta Bloques de IP públicas para una guía de consola sobre cómo compartir un bloque entre servidores.

Redes virtuales

El type de una red es PUBLIC o PRIVATE:

• Una red pública transporta bloques de IP cuyas direcciones salen a Internet mediante la gateway de cada bloque.
• Una red privada solo transporta tráfico entre tus propios servidores, sin subred ni puerta de enlace proporcionadas por nosotros.

managedBy indica quién creó la red: CUSTOMER para las que creaste tú, SYSTEM para las redes de acceso a Internet que configura la plataforma. Listar redes virtuales omite las redes del sistema salvo que pases includeManaged=true y type lo limita a una clase. Obtener red virtual devuelve una red con sus ipBlocks. Actualizar red virtual solo cambia name y rechaza una red del sistema con 422 NETWORK_RENAME_BLOCKED.

Un servidor nuevo recibe su propia red de acceso a Internet, llamada "Internet Access" y aislada de tus demás servidores. Es la red nativa del primer segmento del servidor y contiene su bloque IPv4 /30 o mayor y su IPv6 /120. Un servidor contratado con ipv4PrefixLength e ipv6PrefixLength ambos null (Facturación) no recibe ninguna red y debes conectarle tus propias redes. La plataforma elimina una red de acceso a Internet cuando no tiene bloques de IP ni servidores conectados.

Una red privada une servidores de un centro de datos; la propia red no indica un centro de datos. Pronto estará disponible su extensión entre nuestros centros de datos, para que un servidor de un área metropolitana y otro de otra estén en la misma red de capa 2. Las redes privadas transportan tramas jumbo, con la interfaz privada del host configurada con una MTU de 9000. Las tramas con tus propias etiquetas VLAN 802.1Q también atraviesan la red, para dividirla en VLAN que definas.

Nada en una red privada está cifrado. El tráfico que necesite cifrado lo obtiene de tu propio TLS, WireGuard o IPsec.

ID de VLAN

Cada red que creas tiene un localVlanId entre 11 y 4094, único en la organización: la etiqueta VLAN que lleva la red en los puertos de tus servidores. Las etiquetas 2 a 10 están reservadas para la plataforma. Una red de acceso a Internet no tiene ID de VLAN (localVlanId es null), así que no usa ninguna de las tuyas. Obtener disponibilidad de VLAN devuelve las etiquetas usadas como usedVlanIds y la siguiente libre como nextFreeVlanId, que es null cuando todas están ocupadas. No reserva nada, por lo que una creación aún puede encontrar su etiqueta ocupada para entonces.

Una red conectada a un servidor también muestra un provisioningVlanId: la etiqueta con la que llega mientras los puertos del servidor están en nuestra red de aprovisionamiento, durante un arranque por red o una operación. Es el localVlanId propio de la red o 10 para una red sin él. Scripts iPXE personalizados explica qué cambia en el puerto en ese modo.

Conectar un servidor

Un servidor se conecta a una red mediante un segmento: uno de sus puertos o dos agregados, que el host ve como una interfaz. El ID del segmento es segmentId dondequiera que aparezca: en Obtener capacidades de red, en las entradas de interfaces del servicio, en la respuesta de Crear segmento, en las listas de redes y en todas las llamadas de conexión y direcciones.

Conectar servicio acepta serviceId, segmentId e isNative:

Un segmento transporta una red nativa y varias etiquetadas, así que un servidor puede estar en su red de acceso a Internet y dos redes privadas a la vez. Una segunda red nativa en un segmento se rechaza con 409 NATIVE_NETWORK_ALREADY_EXISTS y una red sin ID de VLAN solo puede conectarse como nativa.

El cambio llega a los conmutadores después de responder la API, por lo que una conexión devuelve 202 Accepted o 204 si esa red ya está conectada en ese segmento. Mientras se aplica, Obtener estado del servicio muestra networkChange.status APPLYING. La conexión pasa de ATTACHING a ATTACHED o a ATTACH_FAILED en Listar redes virtuales del servicio y en Listar servicios conectados de la red. Desconectar servicio sigue el mismo patrón con DETACHING y DETACH_FAILED. Configurar redes virtuales explica las llamadas.

Un servidor también puede funcionar sin red pública, accesible solo por una privada. No puede reinstalarse así: un despliegue necesita una IPv4 principal en una red nativa y de lo contrario se rechaza con 422 PRIMARY_IPV4_REQUIRED. Tampoco hay puerta de enlace NAT. Eliminar la red pública de un servidor explica ambos aspectos.

Direcciones

Las direcciones están en bloques de IP. Un bloque es un intervalo en una red de un centro de datos, IPv4 o IPv6 (ipVersion V4 o V6), e indica su intervalo como cidr junto con su gateway, subnetMask y prefixLength. Listar bloques de IP devuelve cada bloque de tus redes con cuántas direcciones están usadas y libres. Obtener bloque de IP añade las propias direcciones, cada una en uno de cuatro estados: FREE, RESERVED, GATEWAY o ASSIGNED. La puerta de enlace es la primera dirección utilizable del bloque y nunca se entrega.

Una dirección sale del conjunto libre de dos formas. Reservar la aparta sin vincularla a un servidor. Asignar la vincula a un servidor conectado a la red del bloque, en el segmento que usa esa conexión. Una dirección reservada no puede asignarse hasta liberarla. Ambas familias usan un conjunto de llamadas, con el ID del bloque y la dirección en la ruta; Gestionar direcciones IP las contiene.

El DNS inverso solo se establece en IPv4 y primero se comprueba el directo: el nombre debe resolver ya mediante un registro A a la dirección en la que se establece. Un nombre sin ese registro se rechaza con 422 RDNS_A_RECORD_NOT_FOUND y uno que apunta a otro lugar con 422 RDNS_A_RECORD_MISMATCH.

Bloques de IP

Un bloque de IP añade espacio de direcciones a una red pública. Listar planes de bloques de IP tiene un plan por tamaño, con su precio por ciclo y existencias por centro de datos; pasa datacenter para ver una ubicación. Dos llamadas añaden un bloque:

• Por periodo, es un elemento IP_BLOCK de Crear pedido, añadido a la red cuando se paga la factura del pedido (Facturación).
• Con facturación por hora, Crear bloque de IP lo añade dentro de la petición y responde 201 con el bloque. Necesita la facturación por hora activada para la organización.

Ambas aceptan el ID del plan como plan, el datacenter como código, por ejemplo ams1, o como ID y el networkId al que añadir el bloque.

Eliminar bloque de IP cancela la suscripción de un bloque contratado por separado y lo libera de inmediato, siempre que ninguna dirección esté asignada a un servidor. Los bloques incluidos con un servidor se facturan en su suscripción: eliminar uno se rechaza con 422 BUNDLED_ITEM_CANCELLATION_BLOCKED y se liberan después de eliminar el servidor.

Análisis de seguridad

Nuestro analizador funciona en producción sobre las direcciones de AS55285, incluidas las tuyas, y la API informa de lo que encuentra. Obtener resumen de seguridad da el status del analizador (lastScan, nextScan, isScanRunning) y un summary de hallazgos por gravedad, con data en null hasta que termina el primer análisis. Listar hallazgos de seguridad enumera cada hallazgo con filtros de severity, plugin, ip y serviceId, y Listar destinos de análisis da los recuentos por dirección. Volver a analizar destino analiza de nuevo una dirección indicada en la ruta y responde con su nuevo resumen. Obtener análisis de seguridad devuelve un informe por dirección asignada al servidor, con sus puertos abiertos y hallazgos.

Consulta Análisis de seguridad para el flujo de consola, la interpretación de hallazgos y los nuevos análisis.