# Gravação automática no Amazon S3
<a name="create-channel-auto-r2s3"></a>

Você tem a opção de habilitar a gravação de um canal. Se o recurso de registro automático no S3 estiver ativado, todas as transmissões do canal serão gravadas e salvas em um bucket de armazenamento do Amazon S3 de sua propriedade. Posteriormente, a gravação fica disponível para reprodução sob demanda.

*Configurar isso é uma opção avançada.* Por padrão, a gravação é desabilitada quando um canal é criado.

Para configurar um canal para gravação, é necessário criar uma *recording-configuration*. Este é um recurso que especifica um local do Amazon S3 em que as transmissões gravadas para o canal são armazenadas. É possível criar e gerenciar configurações de gravação usando o console ou a CLI; os dois procedimentos são apresentados abaixo. Depois de criar a configuração de gravação, associe-a a um canal ao criar o canal (conforme descrito abaixo) ou posteriormente, atualizando um canal existente. (Na API, consulte [CreateChannel](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_CreateChannel.html) e [UpdateChannel](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_UpdateChannel.html).) Você pode associar vários canais à mesma configuração de gravação. É possível excluir uma configuração de gravação que não esteja mais associada a nenhum canal.

Lembre-se das seguintes restrições:
+ É necessário ser proprietário do bucket do S3. Ou seja, a conta que configura um canal a ser gravado deve ser proprietária do bucket do S3 onde as gravações serão armazenadas.
+ O canal, a configuração de gravação e o local do S3 devem estar na mesma região da AWS. Se você criar canais em outras regiões e quiser gravá-los, também deverá configurar as configurações de gravação e os buckets do S3 nessas regiões.

Para gravar em seu bucket do S3, é necessária autorização com suas credenciais da AWS. Para conceder ao IVS o acesso necessário, uma [função vinculada a serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html) (SLR) do AWS IAM é criada automaticamente quando a configuração de gravação é criada: o SLR é limitado para conceder permissão de gravação ao IVS somente no bucket específico.

Observe que problemas de rede entre o local de streaming e a AWS ou na AWS podem resultar em alguma perda de dados durante a gravação do seu stream. Em casos como este, o Amazon IVS prioriza o stream ao vivo em relação à gravação. Para obter redundância, grave de forma local por meio da sua ferramenta de streaming.

Para obter mais informações (inclusive como configurar o pós-processamento ou a reprodução de VOD em seus arquivos gravados), consulte [Gravação automática do IVS no Amazon S3 \$1 Streaming de baixa latência](record-to-s3.md).

## Como desabilitar a gravação
<a name="getting-started-disable-recording"></a>

Para desabilitar a gravação do Amazon S3 em um canal existente:
+ No console: na página de detalhes do canal relevante, na seção referente à **gravação e armazenamento** de streams, selecione **Disabled** (Desabilitado) e, em seguida, **Save Channel** (Salvar canal). Isso suspende a associação da configuração de gravação do canal; os streams nesse canal não serão mais gravados.
+ Na CLI: execute o comando `update-channel` e o submeta no ARN de configuração de gravação como uma string vazia:

  ```
  aws ivs update-channel --arn "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh" --recording-configuration-arn ""
  ```

  Isso retorna um objeto de canal com uma string vazia para `recordingConfigurationArn`, indicando que a gravação está desabilitada.