Tarefa

  • Artigo

Uma Tarefa é uma operação isolada de trabalho em um Ativo e é definida em um Trabalho.

Este tópico oferece uma visão geral da entidade Task e também demonstra como executar várias operações com a API REST dos Serviços de Mídia.

Importante

Ao acessar entidades nos serviços de mídia, você deve definir valores e campos de cabeçalho específicos nas suas solicitações HTTP.
Para obter mais informações, consulte Instalação para desenvolvimento de API REST dos Serviços de Mídia e Conexão aos Serviços de Mídia com a API REST dos Serviços de Mídia.

Propriedades de entidade Tarefa

Propriedade Tipo Descrição
Id

Somente leitura. Definido pelos Serviços de Mídia no momento da criação.		 Edm.String Identificador exclusivo.
Configuration

Opcional.		 Edm.String Predefinição que define as ações de processamento, como codificação, proteção e assim por diante, que a Tarefa realizará. O comprimento máximo é 100000.
EndTime

Somente leitura. Configurada pelos Serviços de Mídia.		 Edm.DateTime A data e hora de conclusão, falha ou cancelamento da tarefa.
ErrorDetails

Somente leitura. Configurada pelos Serviços de Mídia.		 Collection(ErrorDetail) Uma coleção de códigos e mensagens detalhadas descrevendo todos os erros que aconteceram durante a execução de uma Tarefa.
HistoricalEvents

Somente leitura. Configurada pelos Serviços de Mídia.		 Collection(TaskHistoricalEvent) Uma coleção de objetos TaskHistoricalEvent que descrevem eventos associados à execução da tarefa.
MediaProcessorId

Obrigatórios.		 Edm.String ID do MediaProcessor que será usado na Tarefa. Os valores válidos podem ser recuperados realizando uma solicitação GET em /API/MediaProcessors.
Name

Opcional.		 Edm.String Opcional. O nome amigável da Tarefa. O comprimento máximo é 4000.
PerfMessage

Somente leitura. Configurada pelos Serviços de Mídia.		 Edm.String Contém informações de desempenho da Tarefa.
Priority

Opcional.		 Edm.Int32 A prioridade da tarefa. Um valor mais alto indica uma prioridade maior em relação às outras tarefas. . Por exemplo, uma tarefa com Prioridade = 40 será processada antes de uma tarefa com Prioridade = 30. O limite superior é igual a MaxInt.
Progress

Somente leitura. Configurada pelos Serviços de Mídia.		 Edm.Double Valor que indica 0 a 100%.
RunningDuration

Somente leitura. Configurada pelos Serviços de Mídia.		 Edm.Double O tempo decorrido (em segundos) durante a Tarefa.
StartTime

Somente leitura. Configurada pelos Serviços de Mídia.		 Edm.DateTime Data e hora de início da Tarefa.
State

Somente leitura. Configurada pelos Serviços de Mídia.		 Edm.Int32 O estado da Tarefa. Os valores válidos são:

- Nenhum = 0

- Ativo = 1

- Em execução = 2

- Concluído = 3
TaskBody

Obrigatórios.		 Edm.String Documento XML que contém informações sobre em quais ativos de entrada e saída a Tarefa deve ser executada. A Tarefa deve ter pelo menos 1 ativo de entrada e 1 ativo de saída.

O documento XML tem o formato a seguir.

<taskBody> <inputAsset> JobInputAsset(0)</inputAsset> <inputAsset> JobInputAsset(1)</inputAsset> <outputAsset assetCreationOptions=”1” assetName=”output” storageAccountName=”mystoreagename”> JobOutputAsset(0) </outputAsset> <taskBody>

O <elemento outputAsset> pode ter os seguintes atributos:

– assetCreationOptions (ou AssetCreationOptions). Esses atributos podem ter um dos seguintes valores: None=0x0, StorageEncrypted=0x1, CommonEncryptionProtected=0x2, EnvelopeEncryptionProtected=0x4. O padrão é StorageEncrypted.

– assetName (ou AssetName). Se nenhum for especificado, os Serviços de Mídia definirão um nome no seguinte formato: o elemento outputAsset pai sufixo pelo Nome do Trabalho (ou a ID do Trabalho, se o Nome do Trabalho estiver vazio.

– storageAccountName (ou StorageAccountName). Nome da conta de armazenamento em que o ativo de saída residirá. Caso não seja especificado, a conta de armazenamento padrão do usuário será usada.

Uma tarefa pode depender de várias tarefas e também pode ter vários dependentes. Por exemplo, se a Tarefa A tiver um <outputAsset> referenciado como um <inputAsset> pela Tarefa B, a Tarefa B dependerá da Tarefa A. Como resultado, os Serviços de Mídia precisam concluir o processamento da Tarefa A antes que ela possa processar a Tarefa B.
Options

Obrigatórios. Somente leitura depois da criação.		 Edm.Int32 Um valor de enumeração que descreve as opções de criptografia com as quais uma Tarefa pode ser criada. Os valores válidos são:

- Nenhum = 0

- ProtectedConfiguration = 1
EncryptionKeyId

Opcional.		 Edm.String A ID de chave criptografada.
EncryptionScheme

Opcional.		 Edm.String O EncryptionScheme usado com o arquivo de configuração. O valor válido é "ConfigurationEncryption".
EncryptionVersion

Opcional.		 Edm.String A versão da criptografia de configuração a ser usada. A versão com suporte atualmente é a "1.0".
InitializationVector

Opcional.		 Edm.String O InitializationVector do arquivo de configuração. O comprimento máximo é 4000.
OutputMediaAssets

Somente leitura. Configurada pelos Serviços de Mídia.		 Conjunto de entidades de ativos A propriedade de navegação que pode ser acessada referenciando uma tarefa específica pelo valor da ID. O conjunto de entidades retornado contém todas as entidades OutputMediaAsset que estão vinculadas à tarefa especificada.
InputMediaAssets

Somente leitura. Configurada pelos Serviços de Mídia.		 Conjunto de entidades de ativos A propriedade de navegação que pode ser acessada referenciando uma Tarefa específica pelo valor da ID. O conjunto de entidades retornado contém todas as entidades InputMediaAsset que estão vinculadas à Tarefa especificada.
TaskNotificationSubscriptions

Obrigatórios.		 Conjunto de entidades TaskNotificationSubscription Define as alterações de estado da tarefa do ponto de extremidade de notificação. Além disso, indica se o progresso da tarefa deve ser notificado.

Criar uma Tarefa

As Tarefas são criadas ao criar um Trabalho. Para obter um exemplo, consulte Como codificar um ativo usando Media Encoder Standard.

Listar Tarefas

As tarefas são recuperadas usando uma solicitação HTTP GET.

Método URI da solicitação Versão de HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Tasks> HTTP/1.1
Método URI da solicitação Versão de HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Jobs>('jobid')/Tasks HTTP/1.1

Solicitação de Exemplo

Para obter o mais recente x-ms-version:, consulte REST dos Serviços de Mídia.

GET https://<accountname>.restv2.<location>.media.azure.net/api/Jobs('nb:jid:UUID:b1f956b3-774c-bb44-a3f7-ee47e23add31')/Tasks HTTP/1.1  
Content-Type: application/json;odata=verbose  
Accept: application/json;odata=verbose  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
x-ms-version: 2.19
Authorization: Bearer <token value>  
Host: media.windows.net

Consulte Também

AccessPolicy
Ativo
ContentKey
Trabalho
Trabalho
JobTemplate
Localizador
MediaProcessor
TaskTemplate
Cotas e limitações