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