Sdílet prostřednictvím

Úkol

  • Článek

Úkol je jednotlivá operace práce na aktivu a je definována v úloze.

Toto téma poskytuje přehled Task entity a také ukazuje, jak provádět různé operace pomocí rozhraní REST API služby Media Services.

Důležité

Při přístupu k entitám ve službě Media Services musíte v požadavcích HTTP nastavit specifická pole hlaviček a hodnoty.
Další informace najdete v tématu Nastavení pro vývoj rozhraní REST API služby Media Services a připojení ke službě Media Services pomocí rozhraní REST API služby Media Services.

Vlastnosti entity úlohy

Vlastnost Typ Description
Id

Jen pro čtení. Nastaví se službou Media Services při vytváření.		 Edm.String Jedinečný identifikátor.
Configuration

Nepovinný parametr.		 Edm.String Předvolba, která definuje akce zpracování, jako je kódování, ochrana atd., které bude úloha provádět. Maximální délka je 10 0000.
EndTime

Jen pro čtení. Nastaveno službou Media Services.		 Edm.DateTime Datum a čas, kdy se úkol dokončil, selhal nebo byl zrušen.
ErrorDetails

Jen pro čtení. Nastaveno službou Media Services.		 Collection(ErrorDetail) Kolekce kódů a podrobných zpráv popisujících chyby, ke kterým dochází při spuštění úlohy.
HistoricalEvents

Jen pro čtení. Nastaveno službou Media Services.		 Collection(TaskHistoricalEvent) Kolekce TaskHistoricalEvent objekty, které popisují události spojené s prováděním úlohy.
MediaProcessorId

Povinná hodnota.		 Edm.String ID mediaprocesoru, který se použije v úloze. Platné hodnoty je možné načíst provedením požadavku GET na /API/MediaProcessors.
Name

Nepovinný parametr.		 Edm.String Nepovinný parametr. Popisný název úkolu Maximální délka je 4000.
PerfMessage

Jen pro čtení. Nastaveno službou Media Services.		 Edm.String Obsahuje informace o výkonu úlohy.
Priority

Nepovinný parametr.		 Edm.Int32 Priorita úkolu. Vyšší hodnota označuje vyšší prioritu vzhledem k jiným úkolům. . Například úkol s prioritou = 40 se zpracuje před úkolem s prioritou = 30. Horní mez se rovná hodnotě MaxInt.
Progress

Jen pro čtení. Nastaveno službou Media Services.		 Edm.Double Hodnota označující od nuly do 100 procent.
RunningDuration

Jen pro čtení. Nastaveno službou Media Services.		 Edm.Double Uplynulý čas úkolu (v sekundách).
StartTime

Jen pro čtení. Nastaveno službou Media Services.		 Edm.DateTime Datum a čas zahájení úkolu.
State

Jen pro čtení. Nastaveno službou Media Services.		 Edm.Int32 Stav úkolu. Platné hodnoty jsou:

- Žádné = 0

- Aktivní = 1

- Spuštění = 2

- Dokončeno = 3
TaskBody

Povinná hodnota.		 Edm.String Dokument XML, který obsahuje informace o tom, se kterými vstupními a výstupními prostředky by měla úloha běžet. Úkol musí mít alespoň 1 vstupní a 1 výstupní prostředek.

Dokument XML má následující formát.

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

Element <outputAsset> může mít následující atributy:

– assetCreationOptions (nebo AssetCreationOptions). Tento atribut může mít jednu z následujících hodnot: None=0x0, StorageEncrypted=0x1, CommonEncryptionProtected=0x2, EnvelopeEncryptionProtected=0x4. Výchozí hodnota je StorageEncrypted.

– assetName (nebo AssetName). Pokud není zadán žádný parametr, služba Media Services nastaví název v následujícím formátu: nadřazený element outputAsset s příponou názvu úlohy (nebo ID úlohy, pokud je název úlohy prázdný.

– storageAccountName (nebo StorageAccountName). Název účtu úložiště, ve kterém se bude nacházet výstupní prostředek. Pokud není zadaný, použije se výchozí účet úložiště uživatele.

Úkol může záviset na více úkolech a také může mít více závislých úkolů. Pokud například úkol A má <outputAsset> , na kterou úkol B odkazuje jako <inputAsset> , pak úkol B je závislý na úkolu A. V důsledku toho musí služba Media Services dokončit zpracování úlohy A, než může zpracovat úlohu B.
Options

Povinná hodnota. Po vytvoření je jen pro čtení.		 Edm.Int32 Hodnota výčtu, která popisuje možnosti šifrování, se kterými lze vytvořit úlohu. Platné hodnoty jsou:

- Žádné = 0

- ProtectedConfiguration = 1
EncryptionKeyId

Nepovinný parametr.		 Edm.String ID šifrovaného klíče.
EncryptionScheme

Nepovinný parametr.		 Edm.String EncryptionScheme použitý s konfiguračním souborem. Platná hodnota je ConfigurationEncryption.
EncryptionVersion

Nepovinný parametr.		 Edm.String Verze šifrování konfigurace, která se má použít. Aktuálně podporovaná verze je 1.0.
InitializationVector

Nepovinný parametr.		 Edm.String Inicializačnívector konfiguračního souboru. Maximální délka je 4000.
OutputMediaAssets

Jen pro čtení. Nastaveno službou Media Services.		 Sada entit prostředků Navigační vlastnost, ke které lze získat přístup odkazem na konkrétní úkol podle hodnoty ID. Vrácená sada entit obsahuje všechny entity OutputMediaAsset, které jsou propojené se zadaným úkolem.
InputMediaAssets

Jen pro čtení. Nastaveno službou Media Services.		 Sada entit prostředků Navigační vlastnost, ke které lze získat přístup odkazem na konkrétní hodnotu Task by Id. Vrácená sada entit obsahuje všechny entity InputMediaAsset, které jsou propojeny se zadaným úkolem.
TaskNotificationSubscriptions

Povinná hodnota.		 Sada entit TaskNotificationSubscription Definuje změny stavu úlohy koncového bodu oznámení. Určuje také, zda se má zahrnout průběh úkolu, o kterém se mají informovat.

Vytvoření úkolu

Úkoly se vytvářejí vytvořením úlohy. Příklad najdete v tématu Kódování prostředku pomocí Media Encoder Standard.

Vypsat úkoly

Úkoly se načítají pomocí požadavku GET HTTP.

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
GET <https:// název_účtu.restv2>.<umístění.media.azure.net/api/Tasks> HTTP/1.1
Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
GET <https:// název_účtu.restv2>.<location.media.azure.net/api/Jobs>('jobid')/Tasks HTTP/1.1

Ukázkový požadavek

Nejnovější verzi najdete v x-ms-version:tématu Media Services 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

Viz také

Zásady přístupu
Prostředek
Klíč obsahu
Úloha
Úloha
Pracovní pozice
Lokátor
MediaProcessor
TaskTemplate
Kvóty a omezení