Utilisation du stockage S3 avec l'archivage de la Video API Vonage

Utiliser le Video API Account pour indiquer votre point de terminaison compatible S3 ou votre conteneur Windows Azure vers lequel les archives finalisées doivent être transférées. Pour plus d'informations sur Windows Azure, consultez Utilisation d'un conteneur Windows Azure avec l'archivage de la Video API Vonage.

Vous pouvez créer un compte Amazon S3 à l'adresse suivante http://aws.amazon.com/s3/.

Remarque : Vous pouvez également utiliser un fournisseur de stockage compatible S3 autre qu'Amazon S3. Nous prenons en charge Cloudian et Google Cloud Storage (accessible via l'API AWS S3) en tant que solutions de stockage compatibles S3. D'autres services compatibles S3 peuvent présenter des limitations de fonctionnalités.

Vous devrez fournir les informations suivantes pour le compte de la Video API :

  • Le nom du seau S3
  • L'ID de la clé d'accès
  • La clé d'accès secrète
  • Le point de terminaison (facultatif) - Définissez cette valeur si vous souhaitez utiliser un fournisseur de stockage compatible S3 autre qu'Amazon. Définissez l'URL de base du point d'accès, y compris le protocole (http ou https), par exemple https://s3.cloudianhyperstore.com ou https://storage.googleapis.com. Le point de terminaison par défaut est https://s3.amazonaws.com (l'URL du point de terminaison Amazon S3).

Vous pouvez créer un seau Amazon S3 (ou trouver les noms des seaux existants) à l'adresse suivante Console Amazon S3.

Remarque : Le service d'archivage OpenTok ne prend pas en charge les compartiments S3 dans la région Chine (Pékin).

Pour obtenir un identifiant de clé d'accès Amazon S3 et une clé d'accès secrète :

  1. Aller à la console de gestion Amazon Web Services et se connecter.
  2. Aller à la page des identifiants de sécurité d'Amazon Web Services.
  3. Sous Clés d'accès (ID de la clé d'accès et clé d'accès secrète), cliquez sur le bouton Créer une nouvelle clé d'accès bouton.
  4. Dans le cadre de la Créer une clé d'accès Dans la fenêtre affichée, cliquez sur Afficher la clé d'accès.
  5. Notez l'ID de la clé d'accès et les valeurs de la clé d'accès secrète. Ou cliquez sur le bouton Télécharger le fichier de clés pour télécharger le fichier rootkey.csv qui contient les valeurs de l'ID de la clé d'accès et de la clé d'accès secrète.

Si vous souhaitez utiliser un utilisateur IAM, attribuez-lui la politique d'utilisation suivante :

{
    "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"
            ]
        }
    ]
}

(Remplacer <bucketName> avec le nom de votre seau).

Maintenant, allez à la page Video API Account et suivre les étapes suivantes :

  1. Cliquez sur un Projet dans le menu de navigation de gauche, qui contiendra les sessions que vous archivez.
  2. Dans la section « Archivage », cliquez sur le Configurez dès maintenant votre espace de stockage dans le cloud bouton, puis cliquez sur Amazon S3.
  3. Saisissez l'ID de clé d'accès S3, la clé d'accès secrète et le nom du compartiment dans lequel vous souhaitez que les archives soient téléchargées.
  4. Si vous utilisez un fournisseur de stockage compatible S3 autre qu'Amazon, saisissez l'URL de base du point de terminaison, y compris le protocole (http ou https), par exemple https://s3.cloudianhyperstore.com ou https://storage.googleapis.com.
  5. Cliquez sur le bouton Se connecter au stockage dans le cloud bouton.
  6. Décidez si vous souhaitez mettre en place une solution de secours pour le stockage des archives (activée par défaut).

Remarque : Vous pouvez également définir une cible de téléchargement d'archives à l'aide de la fonction API REST d'OpenTok.

Les archives enregistrées sont transférées vers le compartiment Amazon S3 que vous indiquez.

Toutes les archives sont enregistrées dans un sous-répertoire de votre compartiment S3 dont le nom correspond à votre clé API OpenTok, et chaque archive est enregistrée dans un sous-répertoire dont le nom correspond à l'identifiant de l'archive. Le nom du fichier d'archive est archive.mp4 (pour une archive composite) ou archive.zip (pour une archive de flux individuel). (Voir Archives individuelles de flux et composées.)

Prenons, par exemple, une archive disposant de la clé API et de l'identifiant suivants :

  • Clé API 123456
  • Identifiant d'archive : ab0baa3d-2539-43a6-be42-b41ff1488af3

Le fichier de cette archive est téléchargé dans le répertoire suivant de votre panier S3.

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

A l'occasion de la Console Amazon S3 Vous pouvez rendre public un fichier d'archive que vous avez téléchargé. Accédez au fichier d'archive dans la console, cliquez dessus avec le bouton droit de la souris, puis sélectionnez l'option Rendre public commande. Vous pouvez obtenir l'URL publique du fichier dans le panneau « Propriétés » correspondant à ce fichier dans la console Amazon S3.

Pour plus d'informations, voir Stockage d'archives.