匯出 (0) 列印
全部展開

工作

更新日期: 2014年11月

工作 (Task) 是操作資產的個別作業,在工作 (Job) 中定義。

本主題概述 Task 實體,也會示範如何使用 Media Services REST API 執行各種作業。

Important重要事項
使用媒體服務 REST API 時,適用下列考量:

 

屬性 型別 描述

Id

唯讀。在建立時間由 媒體服務 設定。

Edm.String

唯一識別碼。

Configuration

選擇性。

Edm.String

定義 Task 將會執行之編碼、保護等處理動作的預設值。最大長度為 100000。

EndTime

唯讀。由 媒體服務 設定。

Edm.DateTime

工作 (Task) 完成、失敗或取消時的日期時間。

ErrorDetails

唯讀。由 媒體服務 設定。

Collection(ErrorDetail)

程式碼與詳細訊息的集合,說明在執行工作 (Task) 時發生的任何錯誤。

HistoricalEvents

唯讀。由 媒體服務 設定。

Collection(TaskHistoricalEvent)

描述與工作執行相關聯之事件的 TaskHistoricalEvent 物件集合。

MediaProcessorId

必要項。

Edm.String

將在工作 (Task) 中使用之 MediaProcessor 的識別碼。可藉由在 /API/MediaProcessors 上執行 GET 來擷取有效值。

Name

選擇性。

Edm.String

選擇性。工作 (Task) 的好記名稱。最大長度為 4000。

PerfMessage

唯讀。由 媒體服務 設定。

Edm.String

包含關於工作 (Task) 的效能資訊。

Priority

選擇性。

Edm.Int32

工作的優先順序。值越大代表相對於其他工作的優先順序越高。. 例如,具有優先順序 = 40 的工作會在優先順序 = 30 的工作之前進行處理。大小上限等於 MaxInt。

Progress

唯讀。由 媒體服務 設定。

Edm.Double

指出 0 到 100% 的值。

RunningDuration

唯讀。由 媒體服務 設定。

Edm.Double

工作 (Task) 的經過時間 (以秒為單位)。

StartTime

唯讀。由 媒體服務 設定。

Edm.DateTime

工作 (Task) 開始的日期時間。

State

唯讀。由 媒體服務 設定。

Edm.Int32

工作 (Task) 的狀態。有效的值為:

  • 無 = 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> 元素可以有以下屬性:

  1. assetCreationOptions (或 AssetCreationOptions)。此屬性必須是下列其中一個值:None=0x0、StorageEncrypted=0x1、CommonEncryptionProtected=0x2、EnvelopeEncryptionProtected=0x4。預設值為 StorageEncrypted。

  2. assetName (或 AssetName)。若並未指定,媒體服務 會以下列格式設定名稱:上層 outputAsset 元素會依工作 (Job) 名稱加上尾碼 (若工作名稱為空時,則為工作識別碼)。

  3. storageAccountName (或 StorageAccountName)。輸出資產所在之儲存體帳戶名稱。若並未指定,會使用使用者的預設儲存體帳戶。

工作可相依於多個工作,也可以有多個相依性。例如,若工作 A 具有工作 B 參照為 <inputAsset> 的 <outputAsset>,則工作 B 會和工作 A 相依。結果,媒體服務 必須先處理工作 A 才能處理工作 B。

Options

必要項。建立之後為唯讀。

Edm.Int32

描述可以建立工作 (Task) 之加密選項的列舉值。有效的值為:

  • 無 = 0

  • ProtectedConfiguration = 1

EncryptionKeyId

選擇性。

Edm.String

加密金鑰識別嗎。

EncryptionScheme

選擇性。

Edm.String

與組態檔案搭配使用的 EncryptionScheme。有效值為 "ConfigurationEncryption"。

EncryptionVersion

選擇性。

Edm.String

要使用的組態加密版本。目前支援的版本為「1.0」。

InitializationVector

選擇性。

Edm.String

組態檔案的 InitializationVector。最大長度為 4000。

OutputMediaAssets

唯讀。由 媒體服務 設定。

資產 實體集

導覽屬性,可以依識別碼值參考特定的工作 (Task) 來存取。傳回的實體集包含連結到指定之工作 (Task) 的所有 OutputMediaAsset 實體。

InputMediaAssets

唯讀。由 媒體服務 設定。

資產 實體集

導覽屬性,可以依識別碼值參考特定的工作 (Task) 來存取。傳回的實體集包含連結到指定之工作 (Task) 的所有 InputMediaAsset 實體。

利用建立工作 (Job) 來建立工作 (Task)。如需範例,請參閱建立工作 (Job)

使用 GET HTTP 要求來擷取工作 (Task)。

 

方法 要求 URI HTTP 版本

GET

https://media.windows.net/API/Tasks

HTTP/1.1

 

方法 要求 URI HTTP 版本

GET

https://media.windows.net/API/Jobs('jobid')/Tasks

HTTP/1.1

Important重要事項
順利連接到 https://media.windows.net 後,您將會收到指定另一個媒體服務 URI 的 301 重新導向。您必須針對新的 URI 進行後續呼叫。

GET https://media.windows.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.7
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=youraccountname&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1337212980&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=kK7PbPM3lTAEJYIx5OTWeaSY7zvia358UjPiuvSFHz0%3d
Host: media.windows.net

另請參閱

Microsoft 正展開一份線上問卷調查,了解您對於 MSDN 網站的看法。 如果您選擇參加,您離開 MSDN 網站時即會顯示線上問卷調查。

您是否想要參加?
顯示:
© 2014 Microsoft