Delen via

Taak

  • Artikel

Een taak is een afzonderlijke bewerking van het werk op een asset en wordt gedefinieerd in een taak.

In dit onderwerp vindt u een overzicht van de Task entiteit en ziet u ook hoe u verschillende bewerkingen uitvoert met de Media Services REST API.

Belangrijk

Bij het openen van entiteiten in Media Services moet u specifieke headervelden en -waarden instellen in uw HTTP-aanvragen.
Zie Setup for Media Services REST API Development and Connect to Media Services with the Media Services REST API (Verbinding maken met Media Services met de Media Services REST API) voor meer informatie.

Eigenschappen van taakentiteit

Eigenschap Type Beschrijving
Id

Alleen-lezen. Ingesteld door Media Services tijdens het maken.		 Edm.String Unieke id.
Configuration

Optioneel.		 Edm.String Voorinstelling die verwerkingsacties definieert, zoals codering, beveiliging, enzovoort, die door de taak worden uitgevoerd. De maximale lengte is 100000.
EndTime

Alleen-lezen. Ingesteld door Media Services.		 Edm.DateTime De datum/tijd waarop de taak is voltooid, mislukt of geannuleerd.
ErrorDetails

Alleen-lezen. Ingesteld door Media Services.		 Collection(ErrorDetail) Een verzameling codes en gedetailleerde berichten met een beschrijving van eventuele fouten die optreden wanneer een taak wordt uitgevoerd.
HistoricalEvents

Alleen-lezen. Ingesteld door Media Services.		 Collection(TaskHistoricalEvent) Een verzameling TaskHistoricalEvent-objecten die gebeurtenissen beschrijven die zijn gekoppeld aan de uitvoering van taken.
MediaProcessorId

Vereist.		 Edm.String Id van de MediaProcessor die wordt gebruikt in de taak. Geldige waarden kunnen worden opgehaald door get-aanvraag uit te voeren op /API/MediaProcessors.
Name

Optioneel.		 Edm.String Optioneel. Beschrijvende naam voor de taak. De maximale lengte is 4000.
PerfMessage

Alleen-lezen. Ingesteld door Media Services.		 Edm.String Bevat prestatie-informatie over de taak.
Priority

Optioneel.		 Edm.Int32 De prioriteit van de taak. Een hogere waarde geeft een hogere prioriteit aan ten opzichte van andere taken. . Een taak met Prioriteit = 40 wordt bijvoorbeeld verwerkt vóór een taak met Prioriteit = 30. De bovengrens is gelijk aan MaxInt.
Progress

Alleen-lezen. Ingesteld door Media Services.		 Edm.Double Waarde die nul tot 100 procent aangeeft.
RunningDuration

Alleen-lezen. Ingesteld door Media Services.		 Edm.Double De verstreken tijd (in seconden) voor de taak.
StartTime

Alleen-lezen. Ingesteld door Media Services.		 Edm.DateTime De datum/tijd waarop de taak is gestart.
State

Alleen-lezen. Ingesteld door Media Services.		 Edm.Int32 De status van de taak. Geldige waarden zijn:

- Geen = 0

- Actief = 1

- Uitvoeren = 2

- Voltooid = 3
TaskBody

Vereist.		 Edm.String XML-document met informatie over de invoer- en uitvoerassets waarvoor de taak moet worden uitgevoerd. Een taak moet ten minste één invoerasset en 1 uitvoerasset hebben.

Het XML-document heeft de volgende indeling.

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

Het <element outputAsset> kan de volgende kenmerken hebben:

- assetCreationOptions (of AssetCreationOptions). Deze kenmerken kunnen een van de volgende waarden hebben: None=0x0, StorageEncrypted=0x1, CommonEncryptionProtected=0x2, EnvelopeEncryptionProtected=0x4. De standaardwaarde is StorageEncrypted.

- assetName (of AssetName). Als er geen is opgegeven, stelt Media Services een naam in de volgende indeling in: het bovenliggende element outputAsset achtervoegsel door de taaknaam (of de taak-id, als de taaknaam leeg is).

- storageAccountName (of StorageAccountName). De naam van het opslagaccount waarin de uitvoerasset zich bevindt. Als dit niet is opgegeven, wordt het standaardopslagaccount van de gebruiker gebruikt.

Een taak kan afhankelijk zijn van meerdere taken en kan ook meerdere afhankelijkheden hebben. Als taak A bijvoorbeeld een <outputAsset> heeft waarnaar wordt verwezen als een <inputAsset> door taak B, is taak B afhankelijk van taak A. Als gevolg hiervan moet Media Services de verwerking van taak A voltooien voordat taak B kan worden verwerkt.
Options

Vereist. Alleen-lezen na het maken.		 Edm.Int32 Een opsommingswaarde die de versleutelingsopties beschrijft waarmee een taak kan worden gemaakt. Geldige waarden zijn:

- Geen = 0

- ProtectedConfiguration = 1
EncryptionKeyId

Optioneel.		 Edm.String De versleutelde sleutel-id.
EncryptionScheme

Optioneel.		 Edm.String De EncryptionScheme die wordt gebruikt met het configuratiebestand. De geldige waarde is ConfigurationEncryption.
EncryptionVersion

Optioneel.		 Edm.String De versie van configuratieversleuteling die moet worden gebruikt. De momenteel ondersteunde versie is '1.0'.
InitializationVector

Optioneel.		 Edm.String De InitializationVector van het configuratiebestand. De maximale lengte is 4000.
OutputMediaAssets

Alleen-lezen. Ingesteld door Media Services.		 Entiteitsset activa Navigatie-eigenschap die kan worden geopend door te verwijzen naar een specifieke taak op id-waarde. De geretourneerde entiteitenet bevat alle OutputMediaAsset-entiteiten die zijn gekoppeld aan de opgegeven taak.
InputMediaAssets

Alleen-lezen. Ingesteld door Media Services.		 Entiteitsset activa Navigatie-eigenschap die kan worden geopend door te verwijzen naar een specifieke taak per id-waarde. De geretourneerde entiteitsset bevat alle InputMediaAsset-entiteiten die zijn gekoppeld aan de opgegeven taak.
TaskNotificationSubscriptions

Vereist.		 Entiteitsset TaskNotificationSubscription Hiermee definieert u de status van de meldingseindpunttaakwijzigingen. Geeft ook aan of taakvoortgang moet worden opgenomen waarvoor een melding moet worden ontvangen.

Een taak maken

Taken worden gemaakt door een taak te maken. Zie Een asset coderen met behulp van Media Encoder Standard voor een voorbeeld.

Taken weergeven

Taken worden opgehaald met behulp van een GET HTTP-aanvraag.

Methode Aanvraag-URI HTTP-versie
GET <https:// accountnaam.restv2>.<location.media.azure.net/api/Tasks> HTTP/1.1
Methode Aanvraag-URI HTTP-versie
GET <https:// accountnaam.restv2>.<location.media.azure.net/api/Jobs>('jobid')/Tasks HTTP/1.1

Voorbeeldaanvraag

Zie Media Services REST voor de nieuwste x-ms-version:versie.

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

Zie ook

AccessPolicy
Asset
ContentKey
Taak
Taak
JobTemplate
Locator
MediaProcessor
TaskTemplate
Quota en beperkingen