Zadanie

  • Artykuł

Zadanie jest indywidualną operacją pracy nad zasobem i jest definiowane w zadaniu.

Ten temat zawiera omówienie Task jednostki, a także pokazuje, jak wykonywać różne operacje za pomocą interfejsu API REST usługi Media Services.

Ważne

Podczas uzyskiwania dostępu do jednostek w usłudze Media Services należy ustawić określone pola nagłówka i wartości w żądaniach HTTP.
Aby uzyskać więcej informacji, zobacz Konfigurowanie tworzenia interfejsu API REST usługi Media Services i nawiązywanie połączenia z usługą Media Services przy użyciu interfejsu API REST usługi Media Services.

Właściwości jednostki zadania

Właściwość Typ Opis
Id

Tylko do odczytu. Ustaw przez usługę Media Services w czasie tworzenia.		 Edm.String Unikatowy identyfikator.
Configuration

Opcjonalny.		 Edm.String Ustawienie wstępne definiujące akcje przetwarzania, takie jak kodowanie, ochrona itd., wykonywane przez zadanie. Maksymalna długość to 100000.
EndTime

Tylko do odczytu. Ustaw przez usługę Media Services.		 Edm.DateTime Data/godzina ukończenia, niepowodzenia lub anulowania zadania.
ErrorDetails

Tylko do odczytu. Ustaw przez usługę Media Services.		 Collection(ErrorDetail) Kolekcja kodów i szczegółowych komunikatów opisujących wszelkie błędy występujące podczas uruchamiania zadania.
HistoricalEvents

Tylko do odczytu. Ustaw przez usługę Media Services.		 Collection(TaskHistoricalEvent) Kolekcja obiektów TaskHistoricalEvent opisujących zdarzenia skojarzone z wykonywaniem zadań.
MediaProcessorId

Wymagane.		 Edm.String Identyfikator obiektu MediaProcessor, który będzie używany w zadaniu. Prawidłowe wartości można pobrać, wykonując żądanie GET dla /API/MediaProcessors.
Name

Opcjonalny.		 Edm.String Opcjonalny. Przyjazna nazwa zadania. Maksymalna długość to 4000.
PerfMessage

Tylko do odczytu. Ustaw przez usługę Media Services.		 Edm.String Zawiera informacje o wydajności zadania.
Priority

Opcjonalny.		 Edm.Int32 Priorytet zadania. Wyższa wartość wskazuje wyższy priorytet względem innych zadań. . Na przykład zadanie z priorytetem = 40 zostanie przetworzone przed zadaniem z priorytetem = 30. Górna granica jest równa MaxInt.
Progress

Tylko do odczytu. Ustaw przez usługę Media Services.		 Edm.Double Wartość wskazująca zero do 100 procent.
RunningDuration

Tylko do odczytu. Ustaw przez usługę Media Services.		 Edm.Double Upłynął czas (w sekundach) zadania.
StartTime

Tylko do odczytu. Ustaw przez usługę Media Services.		 Edm.DateTime Data/godzina rozpoczęcia zadania.
State

Tylko do odczytu. Ustaw przez usługę Media Services.		 Edm.Int32 Stan zadania. Prawidłowe wartości:

- Brak = 0

- Aktywny = 1

- Uruchomione = 2

- Ukończono = 3
TaskBody

Wymagane.		 Edm.String Dokument XML zawierający informacje o zasobach wejściowych i wyjściowych, względem których zadanie ma być uruchamiane. Zadanie musi mieć co najmniej 1 element zawartości wejściowej i 1 zasób wyjściowy.

Dokument XML ma następujący format.

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

Element <outputAsset> może mieć następujące atrybuty:

— assetCreationOptions (lub AssetCreationOptions). Te atrybuty mogą mieć jedną z następujących wartości: None=0x0, StorageEncrypted=0x1, CommonEncryptionProtected=0x2, EnvelopeEncryptionProtected=0x4. Wartość domyślna to StorageEncrypted.

- assetName (lub AssetName). Jeśli żadna z nich nie zostanie określona, usługa Media Services ustawi nazwę w następującym formacie: nadrzędny element outputAsset sufiksowany przez nazwę zadania (lub identyfikator zadania, jeśli nazwa zadania jest pusta).

- storageAccountName (lub StorageAccountName). Nazwa konta magazynu, na którym będzie znajdować się element zawartości wyjściowej. Jeśli nie zostanie określone, zostanie użyte domyślne konto magazynu użytkownika.

Zadanie może zależeć od wielu zadań, a także mieć wiele zależności. Jeśli na przykład zadanie A zawiera <element outputAsset> , <do którego odwołuje się element inputAsset> według zadania B, zadanie B jest zależne od zadania A. W związku z tym usługa Media Services musi zakończyć przetwarzanie zadania A, zanim będzie mogła przetworzyć zadanie B.
Options

Wymagane. Tylko do odczytu po utworzeniu.		 Edm.Int32 Wartość wyliczenia opisując opcje szyfrowania, za pomocą których można utworzyć zadanie. Prawidłowe wartości:

- Brak = 0

- ProtectedConfiguration = 1
EncryptionKeyId

Opcjonalny.		 Edm.String Zaszyfrowany identyfikator klucza.
EncryptionScheme

Opcjonalny.		 Edm.String Element EncryptionScheme używany z plikiem konfiguracji. Prawidłową wartością jest "ConfigurationEncryption".
EncryptionVersion

Opcjonalny.		 Edm.String Wersja szyfrowania konfiguracji do użycia. Obecnie obsługiwana wersja to "1.0".
InitializationVector

Opcjonalny.		 Edm.String InicjalizacjaVector pliku konfiguracji. Maksymalna długość to 4000.
OutputMediaAssets

Tylko do odczytu. Ustawiane przez usługę Media Services.		 Zestaw jednostek zasobów Właściwość nawigacji, do którego można uzyskać dostęp, odwołując się do określonego zadania według wartości identyfikatora. Zwrócony zestaw jednostek zawiera wszystkie jednostki OutputMediaAsset połączone z określonym zadaniem.
InputMediaAssets

Tylko do odczytu. Ustawiane przez usługę Media Services.		 Zestaw jednostek zasobów Właściwość nawigacji, do którego można uzyskać dostęp, odwołując się do określonej wartości Task by Id. Zwrócony zestaw jednostek zawiera wszystkie jednostki InputMediaAsset połączone z określonym zadaniem.
TaskNotificationSubscriptions

Wymagane.		 Zestaw jednostek TaskNotificationSubscription Definiuje zmiany stanu zadania punktu końcowego powiadomień. Ponadto wskazuje, czy należy uwzględnić postęp zadania, dla którego ma zostać powiadomiony.

Tworzenie zadania

Zadania są tworzone przez utworzenie zadania. Przykład można znaleźć w temacie How to encode an asset using Media Encoder Standard (Jak kodować zasób przy użyciu Media Encoder Standard).

Lista zadań

Zadania są pobierane przy użyciu żądania HTTP GET.

Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Tasks> HTTP/1.1
Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Jobs>('jobid')/Tasks HTTP/1.1

Przykładowe żądanie

Aby uzyskać najnowszą wersję x-ms-version:, zobacz Artykuł Usługa 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

Zobacz też

AccessPolicy
Zasób
ContentKey
Zadanie
Zadanie
JobTemplate
Lokalizator
MediaProcessor
TaskTemplate
Limity przydziału i ograniczenia