Görev

Görev, bir Varlık üzerindeki tek bir çalışma işlemidir ve bir İş içinde tanımlanır.

Bu konu, varlığa genel bir bakış Task sağlar ve ayrıca Media Services REST API'siyle çeşitli işlemlerin nasıl yürütüleceklerini gösterir.

Önemli

Media Services'teki varlıklara erişirken, HTTP isteklerinizde belirli üst bilgi alanlarını ve değerlerini ayarlamanız gerekir.
Daha fazla bilgi için bkz. Media Services REST API Geliştirme kurulumu ve Media Services REST API ile Media Services'a Bağlanma.

Görev Varlığı Özellikleri

Özellik Tür Description
Id

Salt okunur. Media Services tarafından oluşturma zamanında ayarlanır.
Edm.String Benzersiz tanımlayıcı.
Configuration

İsteğe bağlı.
Edm.String Görevin gerçekleştireceği kodlama, koruma vb. işleme eylemlerini tanımlayan ön ayar. Maksimum uzunluk 100000'dir.
EndTime

Salt okunur. Media Services tarafından ayarlanır.
Edm.DateTime Görevin tamamlandığı, başarısız olduğu veya iptal edildiği tarih saat.
ErrorDetails

Salt okunur. Media Services tarafından ayarlanır.
Collection(ErrorDetail) Bir Görev çalışırken oluşan hataları açıklayan kodlar ve ayrıntılı iletiler koleksiyonu.
HistoricalEvents

Salt okunur. Media Services tarafından ayarlanır.
Collection(TaskHistoricalEvent) Görev yürütmeyle ilişkili olayları açıklayan TaskHistoricalEvent nesneleri koleksiyonu.
MediaProcessorId

Gereklidir.
Edm.String Görevde kullanılacak MediaProcessor kimliği. /API/MediaProcessors üzerinde GET isteği gerçekleştirilerek geçerli değerler alınabilir.
Name

İsteğe bağlı.
Edm.String İsteğe bağlı. Görevin kolay adı. Maksimum uzunluk 4000'dir.
PerfMessage

Salt okunur. Media Services tarafından ayarlanır.
Edm.String Görev hakkında performans bilgilerini içerir.
Priority

İsteğe bağlı.
Edm.Int32 Görevin önceliği. Daha yüksek bir değer, diğer görevlere göre daha yüksek bir önceliğe işaret eder. . Örneğin, Öncelik = 40 olan bir görev, Öncelik = 30 olan bir görevden önce işlenir. Üst sınır MaxInt'e eşittir.
Progress

Salt okunur. Media Services tarafından ayarlanır.
Edm.Double Sıfırdan yüzde 100'e kadar olan değeri gösterir.
RunningDuration

Salt okunur. Media Services tarafından ayarlanır.
Edm.Double Görev için geçen süre (saniye cinsinden).
StartTime

Salt okunur. Media Services tarafından ayarlanır.
Edm.DateTime Görevin başladığı tarih saat.
State

Salt okunur. Media Services tarafından ayarlanır.
Edm.Int32 Görevin durumu. Geçerli değerler:

- Yok = 0

- Etkin = 1

- Çalışıyor = 2

- Tamamlandı = 3
TaskBody

Gereklidir.
Edm.String Görevin hangi giriş ve çıkış varlıklarına karşı çalışması gerektiği hakkında bilgi içeren XML belgesi. Bir Görevin en az 1 giriş varlığı ve 1 çıkış varlığı olmalıdır.

XML belgesi aşağıdaki biçimdedir.

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

<outputAsset> öğesi aşağıdaki özniteliklere sahip olabilir:

- assetCreationOptions (veya AssetCreationOptions). Bu öznitelikler şu değerlerden birine sahip olabilir: None=0x0, StorageEncrypted=0x1, CommonEncryptionProtected=0x2, EnvelopeEncryptionProtected=0x4. Varsayılan değer StorageEncrypted'dir.

- assetName (veya AssetName). Belirtilmemişse, Media Services şu biçimde bir ad ayarlar: İş Adı (veya İş Adı boşsa İş Kimliği) ile ekli üst outputAsset öğesi.

- storageAccountName (veya StorageAccountName). Çıkış varlığının bulunacağı depolama hesabının adı. Belirtilmezse kullanıcının varsayılan depolama hesabı kullanılır.

Bir görev birden çok göreve bağımlı olabilir ve ayrıca birden çok bağımlıya sahip olabilir. Örneğin, Görev A'nın B Görevi tarafından inputAsset> olarak başvuruda bulunılan bir <<outputAsset> değeri varsa, B Görevi A Görevine bağımlıdır. Sonuç olarak, Media Services'ın Görev B'yi işleyebilmesi için önce Görev A'yı işlemeyi bitirmesi gerekir.
Options

Gereklidir. Oluşturulduktan sonra salt okunur.
Edm.Int32 Bir Görevin oluşturulabileceği şifreleme seçeneklerini açıklayan bir numaralandırma değeri. Geçerli değerler:

- Yok = 0

- ProtectedConfiguration = 1
EncryptionKeyId

İsteğe bağlı.
Edm.String Şifrelenmiş Anahtar Kimliği.
EncryptionScheme

İsteğe bağlı.
Edm.String Yapılandırma dosyasıyla kullanılan EncryptionScheme. Geçerli değer "ConfigurationEncryption" değeridir.
EncryptionVersion

İsteğe bağlı.
Edm.String Kullanılacak yapılandırma şifrelemesi sürümü. Şu anda desteklenen sürüm "1.0"dır.
InitializationVector

İsteğe bağlı.
Edm.String Yapılandırma dosyasının InitializationVector'i. Maksimum uzunluk 4000'dir.
OutputMediaAssets

Salt okunur. Media Services tarafından ayarlanır.
Varlık varlık kümesi Kimlik değerine göre belirli bir göreve başvurarak erişilebilen gezinti özelliği. Döndürülen varlık kümesi, belirtilen göreve bağlı tüm OutputMediaAsset varlıklarını içerir.
InputMediaAssets

Salt okunur. Media Services tarafından ayarlanır.
Varlık varlık kümesi Belirli bir Göreve kimlik değerine başvurarak erişilebilen gezinti özelliği. Döndürülen varlık kümesi, belirtilen Göreve bağlı olan tüm InputMediaAsset varlıklarını içerir.
TaskNotificationSubscriptions

Gereklidir.
TaskNotificationSubscription varlık kümesi Bildirim uç noktası görev durumu değişikliklerini tanımlar. Ayrıca, bildirilecek görev ilerleme durumunun eklenip eklenmeyeceğini gösterir.

Görev Oluşturma

Görevler, bir İş oluşturularak oluşturulur. Örnek için bkz. Media Encoder Standard kullanarak bir varlığı kodlama.

Liste Görevleri

Görevler GET HTTP isteği kullanılarak alınır.

Yöntem İstek URI'si HTTP Sürümü
GET <https:// accountname.restv2>.<location.media.azure.net/api/Tasks> HTTP/1.1
Yöntem İstek URI'si HTTP Sürümü
GET <https:// accountname.restv2>.<location.media.azure.net/api/Jobs>('jobid')/Görevler HTTP/1.1

Örnek İstek

En son x-ms-version:sürümü edinmek için bkz. 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  

Ayrıca Bkz.

AccessPolicy
Varlık
ContentKey
İş
İş
JobTemplate
Konumlandırıcı
MediaProcessor
Görev Şablonu
Kotalar ve Sınırlamalar