Tâche

Article
08/05/2023

Une tâche est une opération individuelle de travail sur une ressource et elle est définie dans un travail.

Cette rubrique offre une vue d'ensemble de l'entité Task, et montre comment exécuter diverses opérations avec l'API REST Media Services.

Important

Lors de l’accès aux entités dans Media Services, vous devez définir les valeurs et les champs d’en-tête spécifiques dans vos requêtes HTTP.
Pour plus d’informations, consultez Configuration du développement d’API REST Media Services et Connexion à Media Services avec l’API REST Media Services.

Propriétés de l'entité Task

Propriété	Type	Description
`Id` Lecture seule. Défini par Media Services au moment de la création.	Edm.String	Identificateur unique.
`Configuration` Optionnel.	Edm.String	Présélection qui définit les actions de traitement (encodage, protection, etc.) effectuées par la tâche. La longueur maximale est 1000000.
`EndTime` Lecture seule. Défini par Media Services.	Edm.DateTime	Date et heure de la fin, de l'échec ou de l'annulation de la tâche.
`ErrorDetails` Lecture seule. Défini par Media Services.	Collection(ErrorDetail)	Collection de codes et de messages détaillés décrivant les erreurs qui se produisent quand une tâche est en cours d'exécution.
`HistoricalEvents` Lecture seule. Défini par Media Services.	Collection(TaskHistoricalEvent)	Collection d’objets TaskHistoricalEvent qui décrivent les événements associés à l’exécution de tâche.
`MediaProcessorId` Obligatoire.	Edm.String	ID du processeur multimédia qui sera utilisé dans la tâche. Les valeurs valides peuvent être récupérées via une requête GET sur /API/MediaProcessors.
`Name` Optionnel.	Edm.String	Optionnel. Nom convivial de la tâche. La longueur maximale est de 4 000.
`PerfMessage` Lecture seule. Défini par Media Services.	Edm.String	Contient des informations de performance sur la tâche.
`Priority` Optionnel.	Edm.Int32	Priorité de la tâche. Une valeur plus élevée indique une priorité plus élevée par rapport aux autres tâches. . Par exemple, une tâche avec Priorité = 40 sera traitée avant une tâche avec Priorité = 30. La limite supérieure est égale à MaxInt.
`Progress` Lecture seule. Défini par Media Services.	Edm.Double	Valeur indiquant zéro à 100 pour cent.
`RunningDuration` Lecture seule. Défini par Media Services.	Edm.Double	Temps écoulé (en secondes) pour la tâche.
`StartTime` Lecture seule. Défini par Media Services.	Edm.DateTime	Date et heure de début de la tâche.
`State` Lecture seule. Défini par Media Services.	Edm.Int32	État de la tâche. Les valeurs autorisées sont : - Aucun = 0 - Actif = 1 - En cours d’exécution = 2 - Terminé = 3
`TaskBody` Obligatoire.	Edm.String	Document XML qui contient des informations sur les ressources en entrée et en sortie utilisées pour l'exécution de la tâche. Une tâche doit avoir au moins 1 ressource en entrée et 1 ressource en sortie. Le document XML a le format suivant. `<taskBody> <inputAsset> JobInputAsset(0)</inputAsset> <inputAsset> JobInputAsset(1)</inputAsset> <outputAsset assetCreationOptions=”1” assetName=”output” storageAccountName=”mystoreagename”> JobOutputAsset(0) </outputAsset> <taskBody>` L’élément <outputAsset> peut avoir les attributs suivants : - assetCreationOptions (ou AssetCreationOptions). Ces attributs peuvent avoir l’une des valeurs suivantes : None=0x0, StorageEncrypted=0x1, CommonEncryptionProtected=0x2, EnvelopeEncryptionProtected=0x4. La valeur par défaut est StockageChiffré. - assetName (ou AssetName). Si aucun n’est spécifié, Media Services définit un nom au format suivant : l’élément outputAsset parent avec le suffixe Nom du travail (ou l’ID du travail, si le nom du travail est vide. - storageAccountName (ou StorageAccountName). Nom du compte de stockage où se trouvera la ressource en sortie. S'il n'est pas spécifié, le compte de stockage par défaut de l'utilisateur est utilisé. Une tâche peut dépendre de plusieurs tâches et peut aussi avoir plusieurs tâches dépendantes. Par exemple, si la tâche A a un <outputAsset> référencé en tant qu’inputAsset><par la tâche B, la tâche B dépend de la tâche A. Par conséquent, Media Services doit terminer le traitement de la tâche A avant de pouvoir traiter la tâche B.
`Options` Obligatoire. En lecture seule après la création.	Edm.Int32	Valeur d'énumération qui décrit les options de chiffrement avec lesquelles une tâche peut être créée. Les valeurs autorisées sont : - Aucun = 0 - ProtectedConfiguration = 1
`EncryptionKeyId` Optionnel.	Edm.String	ID de clé chiffrée.
`EncryptionScheme` Optionnel.	Edm.String	EncryptionScheme utilisé avec le fichier de configuration. La valeur « ConfigurationEncryption » est valide.
`EncryptionVersion` Optionnel.	Edm.String	Version du chiffrement de la configuration à utiliser. La version « 1.0 » est actuellement prise en charge.
`InitializationVector` Optionnel.	Edm.String	InitializationVector du fichier de configuration. La longueur maximale est de 4 000.
`OutputMediaAssets` Lecture seule. Défini par Media Services.	Jeu d’entités de ressources	Propriété de navigation accessible en référençant une tâche spécifique par la valeur de l'ID. L'ensemble d'entités retourné contient toutes les entités OutputMediaAsset liées à la tâche spécifiée.
`InputMediaAssets` Lecture seule. Défini par Media Services.	Jeu d’entités de ressources	Propriété de navigation accessible en référençant une tâche spécifique par la valeur de l'ID. L'ensemble d'entités retourné contient toutes les entités InputMediaAsset liées à la tâche spécifiée.
`TaskNotificationSubscriptions` Obligatoire.	Jeu d’entités TaskNotificationSubscription	Définit les changements d’état de tâche du point de terminaison de notification. Indique également s’il faut inclure la progression de la tâche pour laquelle être averti.

Créer une tâche

Les tâches sont créés via la création d'un travail. Pour obtenir un exemple, consultez Comment encoder une ressource à l’aide de Media Encoder Standard.

Liste des tâches

Les tâches sont récupérées à l'aide d'une requête HTTP GET.

Méthode	URI de demande	Version HTTP
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Tasks>	HTTP/1.1

Méthode	URI de demande	Version HTTP
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Jobs>('jobid')/Tasks	HTTP/1.1

Exemple de demande

Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.

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

Voir aussi

AccessPolicy
Asset
ContentKey
Travail
Travail
JobTemplate
Locator
MediaProcessor
TaskTemplate
Quotas et limitations

Partager via