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