Uso do armazenamento S3 com o recurso de arquivamento da Video API da Vonage

Use o Account da Video API para especificar seu endpoint compatível com S3 ou contêiner do Windows Azure para o qual os arquivos compactados concluídos serão enviados. Para obter mais informações sobre o Windows Azure, consulte Utilização de um contêiner do Windows Azure com o recurso de arquivamento da Video API da Vonage.

Você pode criar um Account no Amazon S3 em http://aws.amazon.com/s3/.

Observação: Você também pode usar um provedor de armazenamento compatível com S3 que não seja o Amazon S3. Oferecemos suporte ao Cloudian e ao Google Cloud Storage (acessado por meio da API do AWS S3) como soluções de armazenamento compatíveis com S3. Outros serviços compatíveis com S3 podem apresentar limitações de recursos.

Você deverá fornecer as seguintes informações à conta da Video API:

  • O nome do bucket do S3
  • O ID da chave de acesso
  • A chave de acesso secreta
  • O endpoint (opcional) — Defina esse valor se desejar usar um provedor de armazenamento compatível com o S3 que não seja a Amazon. Defina a URL base do endpoint, incluindo o protocolo (http ou https), como, por exemplo: https://s3.cloudianhyperstore.com ou https://storage.googleapis.com. O endpoint padrão é https://s3.amazonaws.com (a URL do endpoint do Amazon S3).

Você pode criar um bucket do Amazon S3 (ou encontrar nomes de buckets existentes) em Console do Amazon S3.

Observação: O serviço de arquivamento do OpenTok não oferece suporte a buckets do S3 na região da China (Pequim).

Para obter um ID de chave de acesso e uma chave secreta de acesso do Amazon S3:

  1. Acesse o Console de Gerenciamento da Amazon Web Services e faça login.
  2. Acesse a página de credenciais de segurança da Amazon Web Services.
  3. Sob Chaves de acesso (ID da chave de acesso e chave secreta de acesso), clique no Criar nova chave de acesso botão.
  4. No Criar chave de acesso janela exibida, clique em Mostrar tecla de acesso.
  5. Anote os valores do ID da chave de acesso e da chave secreta de acesso. Ou clique no botão “Baixar arquivo de chave” para baixar o arquivo rootkey.csv, que contém os valores do ID da chave de acesso e da chave secreta de acesso.

Se você quiser usar um usuário do IAM, atribua a ele a seguinte política de usuário:

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

(Substituir <bucketName> (com o nome do seu bucket.)

Agora, vá até o Account da Video API e siga as etapas a seguir:

  1. Clique em um Projeto na barra de navegação à esquerda, que conterá as sessões que você está arquivando.
  2. Na seção “Arquivamento”, clique no Configure agora seu armazenamento em nuvem botão e, em seguida, clique em Amazon S3.
  3. Insira o ID da chave de acesso do S3, a chave secreta de acesso e o nome do bucket para o qual você deseja enviar os arquivos.
  4. Se você estiver usando um provedor de armazenamento compatível com S3 que não seja a Amazon, insira a URL base do endpoint, incluindo o protocolo (http ou https), como, por exemplo, https://s3.cloudianhyperstore.com ou https://storage.googleapis.com.
  5. Clique no Conectar-se ao armazenamento em nuvem botão.
  6. Decida se deseja configurar o recurso de fallback para armazenamento em arquivo (ativado por padrão).

Observação: Você também pode definir um destino para o envio de arquivos usando o API REST do OpenTok.

Os arquivos gravados são enviados para o bucket do Amazon S3 que você especificar.

Todos os arquivos são salvos em um subdiretório do seu bucket do S3 cujo nome corresponde à sua chave de API do OpenTok, e cada arquivo é salvo em um subdiretório cujo nome corresponde ao ID do arquivo. O nome do arquivo é archive.mp4 (para um arquivo composto) ou archive.zip (para um arquivo de stream individual). (Veja Arquivos individuais e arquivos compostos.)

Por exemplo, considere um arquivo com a seguinte chave de API e ID:

  • Chave da API 123456
  • ID do arquivo ab0baa3d-2539-43a6-be42-b41ff1488af3

O arquivo deste repositório é enviado para o seguinte diretório do seu bucket do S3.

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

No Console do Amazon S3 Você pode tornar público um arquivo compactado enviado. Navegue até o arquivo compactado no console, clique com o botão direito do mouse nele e selecione a opção Tornar público comando. Você pode obter a URL pública do arquivo no painel “Propriedades” do arquivo no console do Amazon S3.

Para obter mais informações, consulte Armazenamento de arquivos.