media server logo
PreciosIniciar sesiónLanzar en AWS
Documentación APIDescripción general
Ajustes generales
Puertos
Nodos del clúster
Utilidades adicionales
Almacenamientos
Mostrar u ocultar la navegación
Inicio de Callaba

Puertos

Usa Puertos para consultar los puertos de red asignados a recursos de Callaba y liberar una asignación que ya no se utilice.

Qué haceConsultar o liberar un puerto

Elige este módulo cuandoNecesitas revisar o liberar de forma segura un puerto al provisionar o resolver un conflicto de listener.

Usa otro módulo cuandoConfigura el listener en su módulo SRT, RTMP o de rutas; Puertos solo consulta y libera asignaciones.

1Lista las asignaciones2Identifica el propietario3Libera si es seguro
POST /api/ports/getAll
3 endpoints

Antes de empezar

Todos los métodos requieren un x-access-token válido. Antes de liberar un puerto, confirma que ningún proceso multimedia activo depende de él.

Qué puedes hacer

  • getAll enumera los puertos asignados con filtros y paginación.
  • getCount devuelve el número de asignaciones coincidentes.
  • releasePort libera una asignación apta para ello.

Flujo de ejemplo

  1. Enumera las asignaciones y filtra por puerto o por el recurso propietario.
  2. Comprueba si el proceso SRT, RTMP, de ruta o de reproductor asociado está activo.
  3. Detén y elimina el recurso obsoleto si es necesario.
  4. Libera el puerto y confirma que ya no aparece en el inventario.

Casos de uso habituales

  • Resolver el fallo al crear un listener SRT debido a un puerto ocupado.
  • Auditar qué puertos multimedia deben permitirse en el firewall.
  • Recuperar asignaciones obsoletas después de desmontar el entorno de un evento.

Límites y resolución de problemas

Liberar un puerto utilizado por un proceso en ejecución puede interrumpir la señal. Una asignación libre en la aplicación también debe estar libre en el sistema operativo y en la red. El inventario no sustituye las comprobaciones del firewall o de los sockets.

Siguientes pasos

Vuelve al servidor SRT, servidor RTMP o ruta afectados y repite su operación de creación o actualización.

Receta de solución REST

Auditar los puertos asignados antes de liberar uno

Lista el inventario, confirma que ningún módulo activo depende del objetivo y libera solo la asignación revisada.

  1. Listar asignacionesIdentifica el módulo propietario y la asignación antes de limpiar.POST /api/ports/getAll
  2. Liberar el puerto revisadoLibera el puerto solo tras detener los procesos dependientes.POST /api/ports/releasePort

Liberar un puerto en uso puede romper la ingesta o entrega. Detén y separa primero el recurso propietario.

POST
/api/ports/getAll
Requiere token de API

Consulta el inventario actual de puertos de escucha. Úsalo antes de iniciar un módulo o para diagnosticar una colisión de puertos.

La respuesta relaciona cada puerto y transporte con el módulo y el recurso que lo utilizan.

Parámetros del cuerpo de la solicitud
limit
integer
Copiar enlace directo

Tamaño de página opcional para la consulta de inventario de puertos.

skip
integer
Copiar enlace directo

Desplazamiento opcional para recorrer el listado paginado.

sort
object
Copiar enlace directo

Descriptor de ordenación opcional. El estado del panel utiliza { created: 1 } de forma predeterminada.

Listar puertos
Copiar código
curl --request POST \
  --url http://localhost/api/ports/getAll \
  --header 'x-access-token: <your_api_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "sort": {
    "created": 1
  },
  "limit": 20,
  "skip": 0
}'
Respuesta
array of port objects
array
Copiar enlace directo

El backend devuelve los servicios de escucha visibles, junto con su puerto, protocolo de transporte, entidad propietaria y módulo propietario.

Respuesta: Listar puertos
JSON
Copiar código
[
  {
    "id": "681200000000000000000001",
    "port": 1935,
    "transport": "UDP",
    "entity_name": "Main SRT ingest",
    "module_name": "MODULE_SRT_SERVERS",
    "success": true
  }
]
POST
/api/ports/getCount
Requiere token de API
POST
/api/ports/releasePort
Requiere token de API
AnteriorAjustes generalesSiguienteNodos del clúster