Ports
Verwenden Sie Ports, um die Netzwerk-Ports zu prüfen, die Callaba-Ressourcen zugewiesen sind, und geben Sie eine Zuweisung frei, die nicht mehr verwendet wird.
Geeignet, wennSie möchten eine Portzuweisung untersuchen oder bei der Bereitstellung beziehungsweise Fehlerbehebung sicher freigeben.
Anderes Modul verwenden, wennKonfigurieren Sie den Listener im SRT-, RTMP- oder Routenmodul; das Portmodul zeigt Zuweisungen an und gibt sie frei.
/api/ports/getAllVoraussetzungen
Alle Methoden erfordern einen gültigen x-access-token. Stellen Sie vor der Freigabe sicher, dass kein aktiver Medienprozess von dem Port abhängt.
Funktionen
getAlllistet zugewiesene Ports mit Filterung und Paginierung auf.getCountgibt die Anzahl der übereinstimmenden Zuweisungen zurück.releasePortgibt eine berechtigte Zuweisung frei.
Beispiel-Workflow
- Listen Sie Zuweisungen auf und filtern Sie nach dem Port oder der besitzenden Ressource.
- Überprüfen Sie, ob der zugehörige SRT-, RTMP-, Route- oder Player-Prozess aktiv ist.
- Stoppen und entfernen Sie die veraltete Ressource, wenn nötig.
- Geben Sie den Port frei und bestätigen Sie, dass er nicht mehr im Inventar erscheint.
Typische Anwendungsfälle
- Beheben Sie die fehlgeschlagene Erstellung eines SRT-Listeners, wenn der benötigte Port bereits belegt ist.
- Prüfen Sie, welche Medienports über eine Firewall erlaubt sein müssen.
- Geben Sie veraltete Zuweisungen frei, nachdem eine Veranstaltungsumgebung abgebaut wurde.
Einschränkungen und Fehlerbehebung
Wenn Sie einen Port freigeben, den ein laufender Prozess verwendet, kann der Medienfluss unterbrochen werden. Ein in der Anwendung freier Port muss auch auf Betriebssystem- und Netzwerkebene verfügbar sein. Das Portinventar ersetzt keine Prüfung von Firewall und Sockets.
Nächste Schritte
Kehren Sie zum betroffenen SRT-Server, RTMP-Server oder zur Route zurück und wiederholen Sie den Erstellungs- oder Aktualisierungsvorgang.
Belegte Ports vor der Freigabe prüfen
Listen Sie das Port-Inventar auf, bestätigen Sie, dass kein aktives Modul vom Ziel abhängt, und geben Sie nur die geprüfte Zuordnung frei.
- Zuordnungen auflistenErmitteln Sie vor der Bereinigung Modul und aktuelle Zuordnung.
POST /api/ports/getAll - Geprüften Port freigebenGeben Sie den Port erst nach Stoppen abhängiger Medienprozesse frei.
POST /api/ports/releasePort
Die Freigabe eines verwendeten Ports kann Ingest oder Ausgabe unterbrechen. Stoppen und lösen Sie zuerst die zugehörige Ressource.
Rufen Sie mit dieser Methode den aktuellen Bestand der Lauschports einer Instanz ab. Das ist besonders vor dem Start eines neuen Moduls oder bei der Analyse einer blockierenden Portkollision hilfreich.
Die Antwort ordnet jeden Port und sein Transportprotokoll dem Modul sowie der Ressource zu, die ihn derzeit belegt.
Optionale Seitengröße für die Port-Inventarabfrage.
Optionaler Offset für die paginierte Liste.
Das Dashboard sortiert standardmäßig nach { created: 1 }.
Das Backend gibt eine Liste der derzeit sichtbaren Listener mit Port, Transport, besitzender Ressource und zugehörigem Modul zurück.