Uppgift

Artikel
07/19/2023

En aktivitet är en enskild arbetsåtgärd för en tillgång och definieras i ett jobb.

Det här avsnittet ger en översikt över entiteten Task och visar även hur du kör olika åtgärder med Media Services REST API.

Viktigt

När du kommer åt entiteter i Media Services måste du ange specifika rubrikfält och värden i dina HTTP-begäranden.
Mer information finns i Setup for Media Services REST API Development and Connecting to Media Services with the Media Services REST API (Installation för Media Services REST API Development and Connecting to Media Services with the Media Services REST API).

Egenskaper för aktivitetsentitet

Egenskap	Typ	Description
`Id` Skrivskyddad. Anges av Media Services vid skapandetillfället.	Edm.String	Unik identifierare.
`Configuration` Valfritt.	Edm.String	Förinställning som definierar bearbetningsåtgärder, till exempel kodning, skydd och så vidare, som aktiviteten ska utföra. Maximal längd är 100000.
`EndTime` Skrivskyddad. Anges av Media Services.	Edm.DateTime	Datetime när aktiviteten slutfördes, misslyckades eller avbröts.
`ErrorDetails` Skrivskyddad. Anges av Media Services.	Collection(ErrorDetail)	En samling koder och detaljerade meddelanden som beskriver eventuella fel som inträffar när en aktivitet körs.
`HistoricalEvents` Skrivskyddad. Anges av Media Services.	Collection(TaskHistoricalEvent)	En samling TaskHistoricalEvent-objekt som beskriver händelser som är associerade med aktivitetskörning.
`MediaProcessorId` Krävs.	Edm.String	ID för mediaprocessorn som ska användas i aktiviteten. Giltiga värden kan hämtas genom att utföra GET-begäran på /API/MediaProcessors.
`Name` Valfritt.	Edm.String	Valfritt. Eget namn för aktiviteten. Maxlängden är 4 000.
`PerfMessage` Skrivskyddad. Anges av Media Services.	Edm.String	Innehåller prestandainformation om aktiviteten.
`Priority` Valfritt.	Edm.Int32	Uppgiftens prioritet. Ett högre värde anger en högre prioritet i förhållande till andra aktiviteter. . Till exempel bearbetas en aktivitet med Prioritet = 40 före en aktivitet med Prioritet = 30. Den övre gränsen är lika med MaxInt.
`Progress` Skrivskyddad. Anges av Media Services.	Edm.Double	Värde som anger noll till 100 procent.
`RunningDuration` Skrivskyddad. Anges av Media Services.	Edm.Double	Den förflutna tiden (i sekunder) för aktiviteten.
`StartTime` Skrivskyddad. Anges av Media Services.	Edm.DateTime	Datetime när aktiviteten startades.
`State` Skrivskyddad. Anges av Media Services.	Edm.Int32	Status för aktiviteten. Giltiga värden är: - Ingen = 0 - Aktiv = 1 - Körs = 2 - Slutförd = 3
`TaskBody` Krävs.	Edm.String	XML-dokument som innehåller information om vilka indata- och utdatatillgångar som aktiviteten ska köras mot. En aktivitet måste ha minst en indatatillgång och en utdatatillgång. XML-dokumentet har följande format. `<taskBody> <inputAsset> JobInputAsset(0)</inputAsset> <inputAsset> JobInputAsset(1)</inputAsset> <outputAsset assetCreationOptions=”1” assetName=”output” storageAccountName=”mystoreagename”> JobOutputAsset(0) </outputAsset> <taskBody>` Elementet <outputAsset> kan ha följande attribut: - assetCreationOptions (eller AssetCreationOptions). De här attributen kan ha något av följande värden: None=0x0, StorageEncrypted=0x1, CommonEncryptionProtected=0x2, EnvelopeEncryptionProtected=0x4. Standardvärdet är StorageEncrypted. – assetName (eller AssetName). Om inget anges anger Media Services ett namn i följande format: det överordnade outputAsset-elementet suffixet med jobbnamnet (eller jobb-ID: om jobbnamnet är tomt. – storageAccountName (eller StorageAccountName). Namnet på lagringskontot där utdatatillgången ska finnas. Om inget anges används användarens standardlagringskonto. En aktivitet kan vara beroende av flera aktiviteter och kan även ha flera beroenden. Om aktivitet A till exempel har en <outputAsset> som refereras till som inputAsset <> av aktivitet B, är aktivitet B beroende av aktivitet A. Därför måste Media Services slutföra bearbetningen av uppgift A innan den kan bearbeta uppgift B.
`Options` Krävs. Skrivskyddad när den har skapats.	Edm.Int32	Ett uppräkningsvärde som beskriver de krypteringsalternativ som en uppgift kan skapas med. Giltiga värden är: - Ingen = 0 – ProtectedConfiguration = 1
`EncryptionKeyId` Valfritt.	Edm.String	Det krypterade nyckel-ID:t.
`EncryptionScheme` Valfritt.	Edm.String	EncryptionScheme som används med konfigurationsfilen. Det giltiga värdet är "ConfigurationEncryption".
`EncryptionVersion` Valfritt.	Edm.String	Den version av konfigurationskryptering som ska användas. Den version som stöds för närvarande är "1.0".
`InitializationVector` Valfritt.	Edm.String	InitieringVector för konfigurationsfilen. Maxlängden är 4 000.
`OutputMediaAssets` Skrivskyddad. Anges av Media Services.	Tillgångsentitetsuppsättning	Navigeringsegenskap som kan nås genom att referera till en viss aktivitet efter ID-värde. Den returnerade entitetsuppsättningen innehåller alla OutputMediaAsset-entiteter som är länkade till den angivna aktiviteten.
`InputMediaAssets` Skrivskyddad. Anges av Media Services.	Tillgångsentitetsuppsättning	Navigeringsegenskap som kan nås genom att referera till ett specifikt värde för Aktivitet efter ID. Den returnerade entitetsuppsättningen innehåller alla InputMediaAsset-entiteter som är länkade till den angivna aktiviteten.
`TaskNotificationSubscriptions` Krävs.	TaskNotificationSubscription-entitetsuppsättning	Definierar statusändringar för meddelandeslutpunktsaktiviteten. Anger också om uppgiftsstatus ska tas med som ska meddelas.

Skapa en uppgift

Aktiviteter skapas genom att ett jobb skapas. Ett exempel finns i Koda en tillgång med hjälp av Media Encoder Standard.

Visa en lista över aktiviteter

Uppgifter hämtas med hjälp av en GET HTTP-begäran.

Metod	URI för förfrågan	HTTP-version
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Tasks>	HTTP/1.1

Metod	URI för förfrågan	HTTP-version
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Jobs>('jobid')/Tasks	HTTP/1.1

Exempelförfrågan

Information om hur du får det senaste x-ms-version:finns i 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

Se även

AccessPolicy
Tillgång
ContentKey
Jobb
Jobb
JobTemplate
Locator
MediaProcessor
TaskTemplate
Kvoter och begränsningar

Dela via