media server logo
PreiseAnmeldenAuf AWS startenEmpfohlene Region: Frankfurt.
API-DokumentationÜbersicht
Allgemeine Einstellungen
Ports
Cluster-Knoten
Zusätzliche Dienstprogramme
Speicherziele
Dokumentationsnavigation ein- oder ausblenden
Callaba-Startseite

Speicherziele

Verwenden Sie Speicherziele, um wiederverwendbare S3-kompatible Ziele für Aufzeichnungen, kopierte Dateien und exportierte Medien zu registrieren.

FunktionExternes Speicherziel registrieren

Geeignet, wennSie möchten ein S3-kompatibles Ziel registrieren, in das ein anderes Modul schreibt.

Anderes Modul verwenden, wennVerwenden Sie Dateien oder Aufzeichnungen, um Medien zu erzeugen beziehungsweise zu kopieren; Speicherziele registrieren nur das Ziel.

1Ziel registrieren2Berechtigungen testen3Im Medienworkflow verwenden
POST /api/storages/create
6 Endpunkte

Voraussetzungen

Alle Methoden erfordern einen administrativen x-access-token. Bereiten Sie einen kompatiblen Bucket-Endpunkt und Zugangsdaten vor, die nur über die für den Workflow erforderlichen Berechtigungen verfügen. Access Key und Secret Key sind schreibgeschützt und werden von Lesemethoden nicht zurückgegeben.

Funktionen

  • create und update registrieren oder ändern ein Speicherziel.
  • getAll, getCount und getById inspizieren konfigurierte Ziele.
  • remove löscht einen Zieldatensatz.

Beispiel-Workflow

{
  "name": "Event archive",
  "type": "STORAGE_TYPE_S3",
  "bucket_url": "https://media.example.s3.amazonaws.com",
  "access_key": "ACCESS_KEY_ID",
  "secret_key": "SECRET_ACCESS_KEY",
  "meta_data": {}
}
  1. Erstellen Sie das Speicherziel vor dem Ereignis.
  2. Kopieren Sie eine kleine Testdatei in das Speicherziel.
  3. Überprüfen Sie das Objekt und die Zugriffsrichtlinie am Zielort.
  4. Verweisen Sie auf die Speicherkennung aus dem Workflow für die Produktionsübertragung.

Typische Anwendungsfälle

  • Archivieren Sie abgeschlossene Aufzeichnungen in AWS S3 oder einem kompatiblen Objektspeicher.
  • Trennen Sie die redaktionelle Übergabe von Buckets für die langfristige Aufbewahrung.
  • Rotieren Sie die Zugangsdaten des Ziels, ohne Workflows zu ändern, die auf das Speicherziel verweisen.

Einschränkungen und Fehlerbehebung

Lesemethoden können gespeicherte Secret-Werte nicht wiederherstellen. Falsche Endpunkte, Bucket-Richtlinien, Regionen, Zugangsdaten oder Netzwerkregeln können Übertragungen verhindern, obwohl der Zieldatensatz vorhanden ist. Prüfen Sie nach jeder Änderung eine kleine Testübertragung.

Nächste Schritte

Verwenden Sie Dateien, um Medien an dieses Ziel zu kopieren und den Übertragungsfortschritt zu überwachen.

REST-Lösungsrezept

Wiederverwendbaren Object Storage registrieren

Erstellen Sie ein S3-kompatibles Ziel einmal und referenzieren Sie seine ID in Datei- und Aufbewahrungs-Workflows.

  1. Ziel registrierenSpeichern Sie Provider-Typ, Bucket-URL und Zugangsdaten.POST /api/storages/create
  2. Ressource bestätigenLesen Sie die gespeicherte nicht geheime Konfiguration vor Nutzung der ID.POST /api/storages/getById

Behandeln Sie Access- und Secret-Key als nicht lesbare Zugangsdaten. Prüfen Sie Bucket-Richtlinie und minimale Berechtigung.

POST
/api/storages/create
Admin-Token erforderlich

Verwenden Sie diese Methode, bevor ein Aufzeichnungs-, Archiv- oder Dateiübertragungs-Workflow auf den externen Speicher verweist.

Sie registriert das Ziel, prüft Bucket- und Metadateneinstellungen und macht das Speicherziel für Produktions-Workflows verfügbar. Die Voreinstellungen zeigen die schnellste Konfiguration für gängige S3-kompatible Anbieter wie AWS S3 oder Backblaze.

AWS-S3-Speicherziel

Verwenden Sie diese Voreinstellung, wenn Aufnahmen oder kopierte Dateien in einem AWS S3-Bucket landen sollen.

AWS-S3-Speicherziel
Code kopieren
curl --request POST \
  --url http://localhost/api/storages/create \
  --header 'x-access-token: <your_api_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "AWS media archive",
  "type": "STORAGE_TYPE_S3",
  "bucket_url": "https://my-media-bucket.s3.us-east-1.amazonaws.com",
  "access_key": "AWS_ACCESS_KEY_ID",
  "secret_key": "AWS_SECRET_ACCESS_KEY",
  "redis_meta_data_url": "redis://localhost:6379/2",
  "meta_data": {}
}'
Backblaze-Speicherziel

Verwenden Sie diese Voreinstellung, wenn das Speicher-Backend Backblaze ist und die Bucket-URL dem S3-kompatiblen Backblaze-Endpunktmuster folgt.

Backblaze-Speicherziel
Code kopieren
curl --request POST \
  --url http://localhost/api/storages/create \
  --header 'x-access-token: <your_api_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Backblaze media archive",
  "type": "STORAGE_TYPE_BACKBLAZE",
  "bucket_url": "https://s3.us-east-005.backblazeb2.com/my-media-bucket",
  "access_key": "B2_KEY_ID",
  "secret_key": "B2_APPLICATION_KEY",
  "redis_meta_data_url": "redis://localhost:6379/2",
  "meta_data": {}
}'
Parameter im Request-Body
Identität
name
string
Direktlink kopieren

Dashboard-Bezeichnung: Name des Speicherziels.

Der eindeutige Speichername. Das Backend validiert ein eingeschränktes Namensmuster und eine eingeschränkte Länge, bevor das Speicherobjekt erstellt wird.

Standort
type
string
Direktlink kopieren

Dashboard-Bezeichnung: Speichertyp.

Unterstützte Werte sind STORAGE_TYPE_S3, STORAGE_TYPE_BACKBLAZE, sowie ein interner Laufwerkstyp, der als Modellstandard verwendet wird.

bucket_url
string
Direktlink kopieren

Dashboard-Bezeichnung: Bucket URL.

Vollständige Bucket-URL für das Speicherziel.

Zugangsdaten
access_key
string
Direktlink kopieren

Dashboard-Bezeichnung: Zugriffsschlüssel (Key-ID).

Nur schreibbares Feld für die Zugriffsschlüssel-ID, die beim Erstellen oder Aktualisieren des Speicherziels verwendet wird.

secret_key
string
Direktlink kopieren

Dashboard-Bezeichnung: Geheimschlüssel (App-Schlüssel).

Nur schreibbares Feld für den Geheimschlüssel, der beim Erstellen oder Aktualisieren des Speicherziels verwendet wird.

Metadaten-Backend
redis_meta_data_url
string
Direktlink kopieren

Dashboard-Bezeichnung: Metadaten-URL.

Redis-Metadaten-Backend, das von der Speicheranbindung verwendet wird.

meta_data
object
Direktlink kopieren

Optionales Metadatenobjekt, das mit dem Speicherziel gespeichert wird.

Speicherziel erstellen
Code kopieren
curl --request POST \
  --url http://localhost/api/storages/create \
  --header 'x-access-token: <your_api_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "AWS media archive",
  "type": "STORAGE_TYPE_S3",
  "bucket_url": "https://my-media-bucket.s3.us-east-1.amazonaws.com",
  "access_key": "AWS_ACCESS_KEY_ID",
  "secret_key": "AWS_SECRET_ACCESS_KEY",
  "redis_meta_data_url": "redis://localhost:6379/2",
  "meta_data": {}
}'
Antwort
Identität
_id / id / name
mixed
Direktlink kopieren

Speicherobjekt-Kennungen und der gespeicherte Speichername.

Standort
type / bucket_url / folder_name
mixed
Direktlink kopieren

Speichertyp, Bucket-URL und der vom Speichernamen abgeleitete normalisierte Ordnername.

Metadaten-Backend
redis_meta_data_url / meta_data
mixed
Direktlink kopieren

Gespeicherte Felder des Metadaten-Backends für das Speicherobjekt.

Laufzeit
created
string
Direktlink kopieren

Erstellungszeitstempel, der vom Backend verwaltet wird.

Sicherheit
credential material
not returned in later lookups
Direktlink kopieren

Die Erstellungs- und Aktualisierungsabläufe akzeptieren Zugangsdaten, aber Listen- und Abrufmethoden geben geheime Felder bewusst nicht an den Client zurück.

Antwort: Speicherziel erstellen
JSON
Code kopieren
{
  "_id": "6a0011223344556677889900",
  "id": "6a0011223344556677889900",
  "name": "AWS media archive",
  "type": "STORAGE_TYPE_S3",
  "bucket_url": "https://my-media-bucket.s3.us-east-1.amazonaws.com",
  "redis_meta_data_url": "redis://localhost:6379/2",
  "meta_data": {},
  "folder_name": "aws-media-archive",
  "created": "2026-03-24T18:00:00.000Z",
  "success": true
}
POST
/api/storages/getCount
Admin-Token erforderlich
POST
/api/storages/getAll
Admin-Token erforderlich
POST
/api/storages/getById
Admin-Token erforderlich
POST
/api/storages/update
Admin-Token erforderlich
DELETE
/api/storages/remove
Admin-Token erforderlich
Zurück zuVideoanrufe