Archiving using AWS S3

Use the Dashboard to specify your S3-compliant endpoint for completed archives to be uploaded to. (For more information on Windows Azure see Archiving using a Windows Azure container.)

You can create an Amazon S3 account at http://aws.amazon.com/s3.

Note: You can also use an S3-compliant storage provider other than Amazon S3. We support Cloudian and Google Cloud Storage (accessed using the AWS S3 API) as S3-compatible storage solutions. Other S3-compatible services may have feature limitations.

You will need to set the following in your Vonage video account:

• The name of the S3 bucket
• The access key ID
• The secret access key
• The endpoint (optional) — Set this value if you want to use an S3-compliant storage provider other than Amazon. Set the endpoint base URL, including the protocol (http or https), such as https://s3.cloudianhyperstore.com or https://storage.googleapis.com. The default endpoint is https://s3.amazonaws.com (the Amazon S3 endpoint URL).

You can create an Amazon S3 bucket (or find names of existing buckets) at the Amazon S3 console.

Note: Vonage video archives do not support S3 buckets in the China (Beijing) region.

To obtain an Amazon S3 access key ID and secret access key:

1. Go to the Amazon Web Services Management Console and sign in.
2. Go to the Amazon Web Services security credentials page.
3. Under Access Keys (Access Key ID and Secret Access Key), click the Create New Access Key button.
4. In the Create Access Key window displayed, Click Show Access Key.
5. Make a record of the Access Key ID and Secret Access Key values. Or click the Download Key File button to download the rootkey.csv file that contains the access key ID and Secret Access Key values.

If you want to use an IAM user, assign it the following user policy:

(Replace <bucketName> with your bucket name.)

Now, go to the Vonage Dashboard and complete the following steps:

1. Click on Integration in the dashboard left-hand navigation.
2. In the Integration section, click on the Amazon S3 option.
3. Provide a Name for the bucket setup
4. Enter the S3 Public Access Key ID, the Secret Access Key, and the Bucket Name for the bucket to which you want recordings uploaded.
5. If you are using a S3-compliant storage provider other than Amazon, enter the endpoint base URL, including the protocol (http or https), such as https://s3.cloudianhyperstore.com or https://storage.googleapis.com.
6. Click the Connect with Amazon S3 button to finish the setup.

Recordings are uploaded to the Amazon S3 bucket you specify.

All archives are saved to a subdirectory of your S3 bucket that has your Vonage Video App ID as its name, and each archive is saved to a subdirectory that has the archive's ID as its name. The name of the archive file is archive.mp4 (for a composed archives) or archive.zip (for an individual stream archive). (See Individual stream and composed archives.)

For example, consider an archive with the following App ID and Archive ID:

• App ID 123456
• Archive ID ab0baa3d-2539-43a6-be42-b41ff1488af3

The file for this archive is uploaded to the following directory your S3 bucket.

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

From the Amazon S3 console you can make an uploaded archive file public:

1. Navigate to the archive file in the console and right-click it.
2. Select the Make public command.
3. You can obtain the public URL for the file in the Properties panel for the file in the Amazon S3 console.