

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Como executar trabalhos de coleta
<a name="harvest-jobs"></a>

Um trabalho de colheita representa uma solicitação para extrair um ativo live-to-VOD (vídeo sob demanda) de um endpoint em um período de tempo específico no passado. AWS Elemental MediaPackage usa informações do trabalho de colheita para determinar os horários de início e término do ativo e onde armazená-lo após a conclusão do trabalho de colheita.

Um trabalho de colheita é executado somente uma vez depois de ter sido criado. MediaPackage mantém um registro do trabalho em sua conta apenas para referência. Não é possível modificar nem excluir um registro depois de criar a tarefa de coleta. 

**Topics**
+ [Como criar um trabalho de coleta](hj-create.md)
+ [Como visualizar detalhes do trabalho de coleta](hj-view.md)
+ [Como editar um trabalho de coleta](hj-edit.md)
+ [Como excluir um trabalho de coleta](hj-delete.md)

# Como criar um trabalho de coleta
<a name="hj-create"></a>

Crie um trabalho de colheita para extrair um live-to-VOD ativo de um stream HLS ou DASH ao vivo criptografado ou claro (não criptografado).

**Importante**  
Para executar um trabalho de colheita e salvar o live-to-VOD ativo, é MediaPackage necessário ter permissões para acessar e gravar no bucket do Amazon S3 onde o ativo será armazenado. Para criar uma função que forneça MediaPackage as permissões corretas, consulte[AWS Elemental MediaPackage Permitindo acessar outros AWS serviços](setting-up-create-trust-rel.md).

Você pode usar o MediaPackage console AWS CLI, o ou a MediaPackage API para criar um trabalho de colheita. Para obter informações sobre como criar um trabalho por meio da MediaPackage API AWS CLI or, consulte a [Referência AWS Elemental MediaPackage da API](https://docs.aws.amazon.com/mediapackage/latest/apireference/).

Ao criar uma tarefa de coleta, não coloque informações confidenciais de identificação, como números de contas de clientes, em campos de formato livre, como o campo **ID**. Isso se aplica quando você está usando o MediaPackage console, a MediaPackage API ou AWS SDKs. AWS CLI Todos os dados que você inserir MediaPackage podem ser coletados para inclusão nos registros de diagnóstico ou nos CloudWatch Eventos da Amazon.

**Como criar uma tarefa de coleta (console)**

1. Abra o MediaPackage console em [https://console.aws.amazon.com/mediapackage/](https://console.aws.amazon.com/mediapackage/).

1. No painel de navegação, em **Live (Ao vivo)**, escolha **Harvest jobs (Tarefas de coleta)**. 

1. Na página **Trabalhos de coleta**, escolha **Criar trabalho de coleta**.

1. Na página **Create harvest job (Criar tarefa de coleta)**, preencha os campos conforme descrito nos seguintes tópicos:
   + [Campos de detalhes básicos](#hj-create-basic)
   + [Campos de data e hora de início e de término](#hj-create-time)
   + [Campos de destino](#hj-create-destination)

1. Escolha **Criar**.

## Campos de detalhes básicos
<a name="hj-create-basic"></a>

Os detalhes básicos de um trabalho de colheita definem seu identificador e a origem do live-to-VOD ativo.

1. Em **ID**, insira um nome que descreva a tarefa de coleta. O ID é o identificador principal da tarefa de coleta. Você poderá reutilizar o ID quando a tarefa de coleta expirar em sua conta. Os caracteres compatíveis são letras, números, sublinhados (\$1) e hifens (-).

1. Para o **endpoint Origin**, selecione o endpoint que serve a transmissão ao vivo da qual você está colhendo o live-to-VOD ativo.

    Observe as seguintes considerações. 
   + Seu trabalho de colheita deve estar dentro da janela **inicial** do seu MediaPackage endpoint. A janela de reinício determina o período no qual é possível coletar os ativos do seu endpoint. Por exemplo, se seu endpoint tiver uma janela de reinício de três dias, você poderá coletar seu ativo a qualquer momento dentro desse período.

      Um MediaPackage endpoint pode ter uma janela inicial entre zero e 14 dias. Para ajustar a janela de reinício do seu endpoint, consulte [Visualização de um único endpoint](endpoints-view-one.md). 
   + Seu live-to-VOD ativo coletado pode ter uma duração máxima de 24 horas. Para definir a duração do live-to-VOD ativo, consulte [Campos de data e hora de início e de término](#hj-create-time) neste capítulo.
   + Seu endpoint deve fornecer conteúdo HLS ou DASH limpo (não criptografado) ou criptografado.
   + MediaPackage Atualmente, o VOD não suporta a ingestão de ativos criptografados. Se você estiver usando seus ativos coletados em um fluxo de trabalho de MediaPackage vídeo sob demanda e seu endpoint estiver criptografado, crie um endpoint paralelo não criptografado no mesmo canal. Para fazer isso, **desmarque a opção Permitir originação** para que o novo endpoint não possa ser usado para reprodução. MediaPackage cria a URL para endpoints que não têm a originação ativada, mas MediaPackage responde com um erro às solicitações de reprodução enviadas a esse endpoint. Para obter mais informações, consulte [Criação de live-to-VOD ativos com AWS Elemental MediaPackage](ltov.md).

## Campos de data e hora de início e de término
<a name="hj-create-time"></a>

As informações de data e hora de início e término definem o intervalo de tempo para a tarefa de coleta. A duração máxima do trabalho de coleta é de 24 horas. Os horários são baseados na data e hora do programa (PDT) do codificador. Para garantir a sincronização entre o codificador e o dispositivo de reprodução, não se esqueça de incluir `EXT-X-PROGRAM-DATE-TIME` tags no endpoint do qual você está colhendo. Para instruções, consulte [Campos de configurações do empacotador](endpoints-hls-packager.md).

**nota**  
O tempo do live-to-VOD ativo é preciso até o segmento. Isso significa que, se você indicar uma hora de início ou término que se enquadre em um segmento, o MediaPackage incluirá todo o segmento no ativo. Se você tiver um segmento de 3 segundos e esse horário de início se enquadrar no terceiro segundo no segmento, o ativo começará dois segundos antes, no início do segmento.

1. Em **Formato de data e hora**, escolha o formato que você está usando para indicar os horários de início e término do live-to-VOD ativo.
   + **Hora local**: a data e a hora são formatadas de acordo com as configurações da sessão atual do navegador. O horário local usa o formato de 24 horas.
   + **Segundos de epoch)**: a data e a hora são formatadas em segundos desde o epoch.
   + **ISO-8601**: a data e a hora são formatadas de acordo com o padrão ISO-8601.

1. **Em Quando o live-to-VOD ativo começa**, insira quando o live-to-VOD ativo começa. O horário de início do ativo deve ser o mesmo em que o evento ao vivo foi iniciado ou após esse horário. O horário de início também deve estar dentro da janela de reinício no endpoint. Se o endpoint tiver uma janela de 5 horas e o horário de início for 6 horas atrás, a tarefa de coleta falhará.

1. **Em Quando o live-to-VOD ativo termina**, insira quando o live-to-VOD ativo termina. O tamanho do ativo não pode exceder a janela de reinício no endpoint. Se o endpoint tiver uma janela de 5 horas e sua hora de início for 2019/07/29 07:15:00, a hora de término não poderá ser posterior a 2019/07/29 12:15:00. O horário de término também deve estar no passado.

## Campos de destino
<a name="hj-create-destination"></a>

As informações de destino definem como o live-to-VOD ativo é MediaPackage salvo após a coleta da transmissão ao vivo.

1. Para **ARN da função do IAM**, insira o ARN da função do IAM que fornece MediaPackage acesso para leitura e gravação do seu bucket do Amazon S3 onde o ativo será armazenado. live-to-VOD Acesse a função criada em [AWS Elemental MediaPackage Permitindo acessar outros AWS serviços](setting-up-create-trust-rel.md).

1. Para o **nome do bucket do Amazon S3**, insira o bucket em que você MediaPackage deseja armazenar o live-to-VOD ativo. O nome do bucket do Amazon S3 deve estar na mesma região de onde a coleta MediaPackage está sendo feita.

1. Em **Chave de manifesto**, insira o caminho dentro do bucket até o live-to-VOD ativo, incluindo o nome do arquivo do manifesto principal do ativo. Se a estrutura de diretórios ainda não existir no bucket, MediaPackage crie-a. 
**Importante**  
A chave de manifesto deve ser exclusiva. Quando a mesma chave de manifesto é usada para várias tarefas de coleta, a lista de reprodução mais recente do ativo substitui as listas de reprodução existentes. A única vez que você deve reutilizar uma chave de manifesto é quando está coletando o mesmo conteúdo, por exemplo, se houve um problema com uma coleta anterior do conteúdo.

# Como visualizar detalhes do trabalho de coleta
<a name="hj-view"></a>

Visualize todas as tarefas de coleta que você criou nos últimos 90 dias. Após 90 dias, uma tarefa de coleta expira em sua conta.

Você pode usar o MediaPackage console AWS CLI, o ou a MediaPackage API para visualizar um trabalho de colheita. Para obter informações sobre como visualizar um trabalho por meio da MediaPackage API AWS CLI ou, consulte a [Referência AWS Elemental MediaPackage da API](https://docs.aws.amazon.com/mediapackage/latest/apireference/).

**Para visualizar detalhes da tarefa de coleta (console)**

1. Abra o MediaPackage console em [https://console.aws.amazon.com/mediapackage/](https://console.aws.amazon.com/mediapackage/).

1. No painel de navegação, em **Live (Ao vivo)**, escolha **Harvest jobs (Tarefas de coleta)**. 

1. Na página **Trabalho de coleta**, escolha o trabalho de coleta para visualizar seus detalhes.

# Como editar um trabalho de coleta
<a name="hj-edit"></a>

Não é possível editar uma tarefa de coleta. Para criar uma tarefa de coleta com configurações diferentes, consulte [Como criar um trabalho de coleta](hj-create.md).

# Como excluir um trabalho de coleta
<a name="hj-delete"></a>

Não é possível excluir uma tarefa de coleta.
+ Para criar uma tarefa de coleta com configurações diferentes, consulte [Como criar um trabalho de coleta](hj-create.md).
+ Para excluir um ativo de VOD MediaPackage criado com um trabalho de colheita, consulte [Excluir um objeto e um bucket](https://docs.aws.amazon.com/AmazonS3/latest/gsg/DeletingAnObjectandBucket.html) no *Guia de conceitos básicos do Amazon Simple Storage Service*.