Task
工作 (Task) 是操作資產的個別作業，在工作 (Job) 中定義。
本主題概述 Task 實體，也會示範如何使用 Media Services REST API 執行各種作業。
重要
在媒體服務中存取實體時，您必須在 HTTP 要求中設定特定的標頭欄位和值。
如需詳細資訊，請參閱媒體服務 REST API 開發和使用媒體服務 REST API 連線到媒體服務。
Task 實體屬性
| 屬性 | 類型 | 說明 |
|---|---|---|
Id唯讀。 在建立時由媒體服務設定。 |
Edm.String | 唯一識別碼。 |
Configuration選擇性。 |
Edm.String | 定義 Task 將會執行之編碼、保護等處理動作的預設值。 最大長度為 100000。 |
EndTime唯讀。 由 Media Services 設定。 |
Edm.DateTime | 工作 (Task) 完成、失敗或取消時的日期時間。 |
ErrorDetails唯讀。 由 Media Services 設定。 |
集合 (ErrorDetail) | 程式碼與詳細訊息的集合，說明在執行工作 (Task) 時發生的任何錯誤。 |
HistoricalEvents唯讀。 由 Media Services 設定。 |
集合 (TaskHistoricalEvent) | TaskHistoricalEvent物件的集合，描述與工作執行相關聯的事件。 |
MediaProcessorId必要。 |
Edm.String | 將在工作 (Task) 中使用之 MediaProcessor 的識別碼。 可藉由在 /API/MediaProcessors 上執行 GET 來擷取有效值。 |
Name選擇性。 |
Edm.String | 選擇性。 工作 (Task) 的好記名稱。 最大長度為 4000。 |
PerfMessage唯讀。 由 Media Services 設定。 |
Edm.String | 包含關於工作 (Task) 的效能資訊。 |
Priority選擇性。 |
Edm.Int32 | 工作的優先順序。 值越大代表相對於其他工作的優先順序越高。 . 例如，優先順序 = 40 的工作會在優先順序 = 30 的工作之前處理。 上限等於 MaxInt。 |
Progress唯讀。 由 Media Services 設定。 |
Edm.Double | 指出 0 到 100% 的值。 |
RunningDuration唯讀。 由 Media Services 設定。 |
Edm.Double | 工作 (Task) 的經過時間 (以秒為單位)。 |
StartTime唯讀。 由 Media Services 設定。 |
Edm.DateTime | 工作 (Task) 開始的日期時間。 |
State唯讀。 由 Media Services 設定。 |
Edm.Int32 | 工作 (Task) 的狀態。 有效值為： - None = 0 - 作用中 = 1 - 執行 = 2 - 已完成 = 3 |
TaskBody必要。 |
Edm.String | XML 文件，包含應對哪些輸入與輸出資產執行工作 (Task) 的相關資訊。 工作 (Task) 必須至少有 1 個輸入資產和 1 個輸出資產。 XML 文件為以下格式。 <taskBody> <inputAsset> JobInputAsset(0)</inputAsset> <inputAsset> JobInputAsset(1)</inputAsset> <outputAsset assetCreationOptions=”1” assetName=”output” storageAccountName=”mystoreagename”> JobOutputAsset(0) </outputAsset> <taskBody><outputAsset > 元素可以有下列屬性： - assetCreationOptions (或 AssetCreationOptions) 。 此屬性可以有下列其中一個值：None=0x0、StorageEncrypted=0x1、CommonEncryptionProtected=0x2、EnvelopeEncryptionProtected=0x4。 預設值為 StorageEncrypted。 - assetName (或 AssetName) 。 如果未指定任何名稱，則媒體服務會以下列格式設定名稱：如果 [作業名稱] 是空的，則為 [作業名稱] 尾碼的父 outputAsset 元素 (或作業識別碼。 - storageAccountName (或 StorageAccountName) 。 輸出資產所在之儲存體帳戶名稱。 若並未指定，會使用使用者的預設儲存體帳戶。 工作可相依於多個工作，也可以有多個相依性。 例如，如果工作 A 具有 < 由工作 B 參考為 < inputAsset 的 outputAsset >> ，則工作 B 相依于工作 A。因此，媒體服務必須先完成處理工作 A，才能處理工作 B。 |
Options必要。 建立之後為唯讀。 |
Edm.Int32 | 描述可以建立工作 (Task) 之加密選項的列舉值。 有效值為： - None = 0 - ProtectedConfiguration = 1 |
EncryptionKeyId選擇性。 |
Edm.String | 加密金鑰識別嗎。 |
EncryptionScheme選擇性。 |
Edm.String | 與組態檔案搭配使用的 EncryptionScheme。 有效值為 "ConfigurationEncryption"。 |
EncryptionVersion選擇性。 |
Edm.String | 要使用的組態加密版本。 目前支援的版本為「1.0」。 |
InitializationVector選擇性。 |
Edm.String | 組態檔案的 InitializationVector。 最大長度為 4000。 |
OutputMediaAssets唯讀。 由 Media Services 設定。 |
資產 實體集 | 導覽屬性，可以依識別碼值參考特定的工作 (Task) 來存取。 傳回的實體集包含連結到指定之工作 (Task) 的所有 OutputMediaAsset 實體。 |
InputMediaAssets唯讀。 由 Media Services 設定。 |
資產 實體集 | 導覽屬性，可以依識別碼值參考特定的工作 (Task) 來存取。 傳回的實體集包含連結到指定之工作 (Task) 的所有 InputMediaAsset 實體。 |
TaskNotificationSubscriptions必要。 |
TaskNotificationSubscription 實體集 | 定義通知端點工作狀態變更。 此外，指出是否要包含要通知的工作進度。 |
建立工作
利用建立工作 (Job) 來建立工作 (Task)。 如需範例，請參閱如何使用 媒體編碼器標準來編碼資產。
列出工作 (Task)
使用 GET HTTP 要求來擷取工作 (Task)。
| 方法 | 要求 URI | HTTP 版本 |
|---|---|---|
| GET | HTTPs:// < accountname.restv2 > 。 <location.media.azure.net/api/Tasks > | HTTP/1.1 |
| 方法 | 要求 URI | HTTP 版本 |
|---|---|---|
| GET | HTTPs:// < accountname.restv2 > 。 <location.media.azure.net/api/Jobs ('jobid > ') /Tasks | HTTP/1.1 |
範例要求
若要取得最新的 x-ms-version: ，請參閱 媒體服務 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
另請參閱
AccessPolicy
資產
ContentKey
工作 (Job)
工作 (Job)
JobTemplate
定位
MediaProcessor
TaskTemplate
配額和限制