Die Administration stellt Betriebszustände und Befehle bereit. Behandeln Sie sie auch dann als privilegierte Oberfläche, wenn eine Aktion über einen gewöhnlichen GET-Aufruf erfolgt. Browser, Monitoring oder kopierte URLs können sonst unbeabsichtigt Änderungen auslösen.
Vor einer Änderung den Zustand lesen
Die festgelegte Implementierung registriert stats, listmounts, listclients und managerelays. XML-Antworten und XSLT-Ansichten bedienen unterschiedliche Verbraucher. /admin/streams liefert Informationen für Relays und ist keine allgemeine öffentliche Statusseite.
Dieses lesende Shell-Beispiel fragt das Administratorkennwort interaktiv ab. Ersetzen Sie den Beispieldomainnamen und verwenden Sie den eingerichteten geschützten Endpunkt:
curl --fail --silent --show-error --user admin 'https://stream.example.org/admin/listclients?mount=%2Flive.ogg'Kennwörter gehören weder in Befehl noch URL, Shell-Verlauf oder exportierte Antwort. Antworten können Höreradressen und Kontokennungen enthalten. Bewahren Sie erfasste XML-Daten geschützt und zeitlich begrenzt auf.
Den tatsächlichen Befehl auswählen
| Aufgabe | Befehl im festgelegten Stand | Vorher prüfen |
|---|---|---|
| Relay ansehen oder aktivieren | managerelays | Lokaler Mount und gewünschter Zustand |
| Hörer ansehen | listclients | Exakter Mount und Berechtigung |
| Metadaten senden | metadata | Format, Modus und URL-Kodierung |
| Fallback ändern | fallback | Kompatibilität und Zugriffsregeln des Ziels |
| Hörer verschieben | moveclients | Zielkapazität und vorhandene Quelle |
| Einzelnen Hörer trennen | killclient | Aktuelle Hörer-ID und Mount |
| Quelle trennen | killsource | Wiederanlauf und Fallback-Verhalten |
| Unterstützte Benutzerkonten pflegen | manageauth | Ausgewähltes Authentifizierungsverfahren |
Das alte Administrationsdokument schreibt fallbacks. Die aktuelle Befehlstabelle registriert den Singular fallback. Bauen Sie Automatisierung nicht auf dem veralteten Pfad auf. function nimmt eine perform-Operation entgegen. Das ist keine unbeschränkte oder automatisch sichere Reload-API. Prüfen Sie die benannte Implementierung vor ihrer Verwendung.
Das Ergebnis unabhängig prüfen
Führen Sie verändernde Anfragen nur an einer entbehrlichen Instanz durch. Prüfen Sie neben dem HTTP-Status den Antwortinhalt, rufen Sie anschließend den Zustand erneut ab und beobachten Sie den betroffenen Hörer. Eine Antwort allein beweist keine unterbrechungsfreie Wiedergabe. Dieser Artikel beschreibt registrierte Schnittstellen; er behauptet keine ausgeführten Befehle an einem laufenden KH-Dienst.