Verwendung von S3-Speicher für die Archivierung mit der Vonage Video API

Verwenden Sie die Video API-Konto um Ihren S3-kompatiblen Endpunkt oder Windows Azure-Container anzugeben, in den die fertigen Archive hochgeladen werden sollen. Weitere Informationen zu Windows Azure finden Sie unter Verwendung eines Windows Azure-Containers mit der Vonage Video API zur Archivierung.

Sie können einen Amazon S3 Account erstellen unter http://aws.amazon.com/s3/.

Anmerkung: Sie können auch einen anderen S3-kompatiblen Speicheranbieter als Amazon S3 verwenden. Wir unterstützen Cloudian und Google Cloud Storage (Zugriff über die AWS S3 API) als S3-kompatible Speicherlösungen. Andere S3-kompatible Dienste können Funktionseinschränkungen aufweisen.

Sie geben die folgenden Informationen in Ihrem Video API Account an:

  • Der Name des S3-Buckets
  • Die Zugriffsschlüssel-ID
  • Der geheime Zugangsschlüssel
  • Der Endpunkt (optional) - Legen Sie diesen Wert fest, wenn Sie einen anderen S3-kompatiblen Speicheranbieter als Amazon verwenden möchten. Legen Sie die Basis-URL des Endpunkts fest, einschließlich des Protokolls (http oder https), z. B. https://s3.cloudianhyperstore.com oder https://storage.googleapis.com. Der Standardendpunkt ist https://s3.amazonaws.com (die Amazon S3-Endpunkt-URL).

Sie können einen Amazon S3-Bucket erstellen (oder die Namen bestehender Buckets finden) unter der Amazon S3-Konsole.

Anmerkung: Die OpenTok-Archivierung unterstützt keine S3-Buckets in der Region China (Peking).

So erhalten Sie eine Amazon S3-Zugangsschlüssel-ID und einen geheimen Zugangsschlüssel:

  1. Gehe zu die Amazon Web Services Management-Konsole und melden Sie sich an.
  2. Gehe zu die Seite mit den Sicherheitsanmeldeinformationen für Amazon Web Services.
  3. Unter Zugangsschlüssel (Zugangsschlüssel-ID und geheimer Zugangsschlüssel)klicken Sie auf die Neuen Zugangsschlüssel erstellen Taste.
  4. In der Zugangsschlüssel erstellen angezeigten Fenster, Klicken Sie auf Zugangsschlüssel anzeigen.
  5. Notieren Sie sich die Werte für die Zugangsschlüssel-ID und den geheimen Zugangsschlüssel. Oder klicken Sie auf die Schaltfläche Schlüsseldatei herunterladen, um die Datei rootkey.csv herunterzuladen, die die Werte für die Zugangsschlüssel-ID und den geheimen Zugangsschlüssel enthält.

Wenn Sie einen IAM-Benutzer verwenden möchten, weisen Sie ihm die folgende Benutzerrichtlinie zu:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "Stmt1427497452000",
            "Effect": "Allow",
            "Resource": [
                "arn:aws:s3:::*"
            ],
            "Action": [
                "s3:ListAllMyBuckets"
            ]
        },
        {
            "Effect": "Allow",
            "Resource": [
                "arn:aws:s3:::<bucketName>"
            ],
            "Action": [
                "s3:ListBucket"
            ]
        },
        {
            "Effect": "Allow",
            "Resource": [
                "arn:aws:s3:::<bucketName>/*"
            ],
            "Action": [
                "s3:PutObject"
            ]
        }
    ]
}

(Ersetzen <bucketName> mit Ihrem Eimernamen).

Gehen Sie nun zum Video API-Konto und führen Sie die folgenden Schritte aus:

  1. Klicken Sie auf ein Projekt in der linken Navigationsleiste, die die von Ihnen archivierten Sitzungen enthält.
  2. Klicken Sie im Abschnitt „Archivierung“ auf die Schaltfläche Richten Sie jetzt Ihren Cloud-Speicher ein Schaltfläche und klicken Sie anschließend auf Amazon S3.
  3. Geben Sie die S3-Zugriffs-ID, den geheimen Zugriffsschlüssel und den Bucket-Namen für den Bucket ein, in den die Archive hochgeladen werden sollen.
  4. Wenn Sie einen anderen S3-kompatiblen Speicheranbieter als Amazon verwenden, geben Sie die Basis-URL des Endpunkts ein, einschließlich des Protokolls (http oder https), beispielsweise https://s3.cloudianhyperstore.com oder https://storage.googleapis.com.
  5. Klicken Sie auf die Mit dem Cloud-Speicher verbinden Taste.
  6. Entscheiden Sie, ob Sie einen Archivspeicher-Fallback einrichten möchten (standardmäßig aktiviert).

Anmerkung: Sie können auch ein Ziel für den Archiv-Upload festlegen, indem Sie den OpenTok REST API.

Die aufgezeichneten Archive werden in den von Ihnen angegebenen Amazon S3-Bucket hochgeladen.

Alle Archive werden in einem Unterverzeichnis Ihres S3-Buckets gespeichert, dessen Name Ihrem OpenTok-API-Schlüssel entspricht, und jedes Archiv wird in einem Unterverzeichnis gespeichert, dessen Name der Archiv-ID entspricht. Der Name der Archivdatei lautet „archive.mp4“ (bei einem zusammengesetzten Archiv) bzw. „archive.zip“ (bei einem einzelnen Stream-Archiv). (Siehe Einzelne Streams und zusammengesetzte Archive.)

Betrachten wir zum Beispiel ein Archiv mit dem folgenden API-Schlüssel und der folgenden ID:

  • API-Schlüssel 123456
  • Archiv-ID ab0baa3d-2539-43a6-be42-b41ff1488af3

Die Datei für dieses Archiv wird in das folgende Verzeichnis Ihres S3-Buckets hochgeladen.

123456/ab0baa3d-2539-43a6-be42-b41ff1488af3/archive.mp4

In der Amazon S3-Konsole Sie können eine hochgeladene Archivdatei öffentlich machen. Navigieren Sie in der Konsole zu der Archivdatei, klicken Sie mit der rechten Maustaste darauf und wählen Sie die Option Öffentlich machen Befehl. Die öffentliche URL der Datei finden Sie im Eigenschaftenfenster der Datei in der Amazon S3-Konsole.

Weitere Informationen finden Sie unter Archivierung.