Partilhar via


Tarefa

Uma Tarefa é uma operação individual de trabalho num Recurso e é definida numa Tarefa.

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

Importante

Ao aceder a entidades nos Serviços de Multimédia, tem de definir campos e valores de cabeçalho específicos nos seus pedidos HTTP.
Para obter mais informações, veja Setup for Media Services REST API Development and Connecting to Media Services with the Media Services REST API ( Configurar o Desenvolvimento da API REST dos Serviços de Multimédia e Ligar aos Serviços de Multimédia com a API REST dos Serviços de Multimédia).

Propriedades da Entidade da Tarefa

Propriedade Tipo Description
Id

Só de leitura. Definido pelos Serviços de Multimédia no momento da criação.
Edm.String Identificador exclusivo.
Configuration

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

Só de leitura. Definido pelos Serviços de Multimédia.
Edm.DateTime O datetime em que a tarefa foi concluída, falhou ou foi cancelada.
ErrorDetails

Só de leitura. Definido pelos Serviços de Multimédia.
Coleção(ErrorDetail) Uma coleção de códigos e mensagens detalhadas que descrevem quaisquer erros que ocorram quando uma Tarefa está em execução.
HistoricalEvents

Só de leitura. Definido pelos Serviços de Multimédia.
Collection(TaskHistoricalEvent) Uma coleção de objetos TaskHistoricalEvent que descrevem eventos associados à execução de tarefas.
MediaProcessorId

Obrigatório.
Edm.String ID do MediaProcessor que será utilizado na Tarefa. Os valores válidos podem ser obtidos ao realizar um pedido GET em /API/MediaProcessors.
Name

Opcional.
Edm.String Opcional. Nome amigável para a Tarefa. O comprimento máximo é 4000.
PerfMessage

Só de leitura. Definido pelos Serviços de Multimédia.
Edm.String Contém informações de desempenho sobre a Tarefa.
Priority

Opcional.
Edm.Int32 A prioridade da tarefa. Um valor mais elevado indica uma prioridade superior relativamente a 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

Só de leitura. Definido pelos Serviços de Multimédia.
Edm.Double Valor que indica zero a 100 por cento.
RunningDuration

Só de leitura. Definido pelos Serviços de Multimédia.
Edm.Double O tempo decorrido (em segundos) da Tarefa.
StartTime

Só de leitura. Definido pelos Serviços de Multimédia.
Edm.DateTime O datetime quando a Tarefa começou.
State

Só de leitura. Definido pelos Serviços de Multimé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ório.
Edm.String Documento XML que contém informações sobre os recursos de entrada e saída em que a Tarefa deve ser executada. Uma Tarefa tem de ter, pelo menos, 1 recurso de entrada e 1 recurso de saída.

O documento XML tem o seguinte formato.

<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). Estes atributos podem ter um dos seguintes valores: None=0x0, StorageEncrypted=0x1, CommonEncryptionProtected=0x2, EnvelopeEncryptionProtected=0x4. A predefinição é StorageEncrypted.

- assetName (ou AssetName). Se nenhum for especificado, os Serviços de Multimédia definem um nome no seguinte formato: o elemento principal OutputAsset sufixado pelo Nome da Tarefa (ou o ID da Tarefa, se o Nome da Tarefa estiver vazio.

- storageAccountName (ou StorageAccountName). O nome da conta de armazenamento onde o recurso de saída irá residir. Se não for especificado, é utilizada a conta de armazenamento predefinida do utilizador.

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 uma <entradaAsset> pela Tarefa B, a Tarefa B depende da Tarefa A. Como resultado, os Serviços de Multimédia têm de concluir o processamento da Tarefa A antes de poderem processar a Tarefa B.
Options

Obrigatório. Só de leitura após a criação.
Edm.Int32 Um valor de enumeração que descreve as opções de encriptação com as quais uma Tarefa pode ser criada. Os valores válidos são:

- Nenhum = 0

- ProtectedConfiguration = 1
EncryptionKeyId

Opcional.
Edm.String O ID da Chave encriptada.
EncryptionScheme

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

Opcional.
Edm.String A versão da encriptação de configuração a utilizar. A versão atualmente suportada é "1.0".
InitializationVector

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

Só de leitura. Definido pelos Serviços de Multimédia.
Conjunto de entidades de ativos Propriedade de navegação que pode ser acedida ao referenciar uma tarefa específica por valor de ID. O conjunto de entidades devolvido contém todas as entidades OutputMediaAsset que estão ligadas à tarefa especificada.
InputMediaAssets

Só de leitura. Definido pelos Serviços de Multimédia.
Conjunto de entidades de ativos Propriedade de navegação que pode ser acedida ao referenciar um valor de Tarefa por ID específico. O conjunto de entidades devolvido contém todas as entidades InputMediaAsset que estão ligadas à Tarefa especificada.
TaskNotificationSubscriptions

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

Criar uma Tarefa

As tarefas são criadas através da criação de uma Tarefa. Por exemplo, veja How to encode an asset using Media Encoder Standard (Como codificar um recurso com Media Encoder Standard).

Listar Tarefas

As tarefas são obtidas com um pedido GET HTTP.

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

Pedido de Amostra

Para obter as versões mais recentes x-ms-version:, veja Serviços de Multimédia REST.

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
Recurso
ContentKey
Tarefa
Tarefa
JobTemplate
Localizador
MediaProcessor
TaskTemplate
Quotas e Limitações