Tarea

Artículo
07/19/2023

Una tarea es una operación individual de trabajo en un recurso, y se define en un trabajo.

En este tema encontrará un resumen de la entidad Task y una demostración de cómo ejecutar distintas operaciones con la API de REST de Media Services.

Importante

Al obtener acceso a las entidades de Media Services, debe establecer los campos de encabezado específicos y los valores en las solicitudes HTTP.
Para obtener más información, consulte Configuración del desarrollo de la API de REST de Media Services y Conexión a Media Services con la API de REST de Media Services.

Propiedades de la entidad Tarea

Propiedad	Tipo	Descripción
`Id` Solo lectura. Se establece por Media Services en el momento de la creación.	Edm.String	Identificador único.
`Configuration` Opcional.	Edm.String	Valor predefinido que define las acciones de procesamiento, como la codificación, protección, etc., que realizará la tarea. La longitud máxima es 100000.
`EndTime` Solo lectura. Establecido por Servicios multimedia.	Edm.DateTime	Fecha y hora en que se completó, interrumpió o canceló la tarea.
`ErrorDetails` Solo lectura. Establecido por Servicios multimedia.	Collection(ErrorDetail)	Colección de códigos y mensajes detallados que describen los errores que se producen al ejecutarse una tarea.
`HistoricalEvents` Solo lectura. Establecido por Servicios multimedia.	Collection(TaskHistoricalEvent)	Colección de objetos TaskHistoricalEvent que describen los eventos asociados a la ejecución de tareas.
`MediaProcessorId` Necesario.	Edm.String	Identificador del MediaProcessor que se usará en la tarea. Para recuperar los valores válidos, puede realizar una solicitud GET en /API/MediaProcessors.
`Name` Opcional.	Edm.String	Opcional. Nombre descriptivo de la tarea. La longitud máxima es 4000.
`PerfMessage` Solo lectura. Establecido por Servicios multimedia.	Edm.String	Contiene información de rendimiento de la tarea.
`Priority` Opcional.	Edm.Int32	Prioridad de la tarea. Un valor más alto indica una prioridad más alta en relación con otras tareas. . Por ejemplo, una tarea con Prioridad = 40 se procesará antes de una tarea con Prioridad = 30. El límite superior es igual a MaxInt.
`Progress` Solo lectura. Establecido por Servicios multimedia.	Edm.Double	Valor que indica cero al 100 %.
`RunningDuration` Solo lectura. Establecido por Servicios multimedia.	Edm.Double	Tiempo transcurrido (en segundos) para la tarea.
`StartTime` Solo lectura. Establecido por Servicios multimedia.	Edm.DateTime	Fecha y hora en que se inició la tarea.
`State` Solo lectura. Establecido por Servicios multimedia.	Edm.Int32	Estado de la tarea. Los valores válidos son: - Ninguno = 0 - Activo = 1 - En ejecución = 2 - Completado = 3
`TaskBody` Necesario.	Edm.String	Documento XML que contiene información sobre los recursos de entrada y salida en que debe ejecutarse la tarea. Una tarea debe tener al menos un recurso de entrada y un recurso de salida. El documento XML tiene el siguiente formato. `<taskBody> <inputAsset> JobInputAsset(0)</inputAsset> <inputAsset> JobInputAsset(1)</inputAsset> <outputAsset assetCreationOptions=”1” assetName=”output” storageAccountName=”mystoreagename”> JobOutputAsset(0) </outputAsset> <taskBody>` El <elemento outputAsset> puede tener los atributos siguientes: - assetCreationOptions (o AssetCreationOptions). Estos atributos pueden tener uno de los siguientes valores: None=0x0, StorageEncrypted=0x1, CommonEncryptionProtected=0x2, EnvelopeEncryptionProtected=0x4. El valor predeterminado es StorageEncrypted. - assetName (o AssetName). Si no se especifica ninguno, Media Services establece un nombre con el formato siguiente: el elemento outputAsset primario sufijo por el nombre del trabajo (o el identificador de trabajo, si el nombre del trabajo está vacío. - storageAccountName (o StorageAccountName). Es el nombre de la cuenta de almacenamiento donde residirá el recurso de salida. Si no se especifica, se usa la cuenta de almacenamiento predeterminada del usuario. Una tarea puede depender de varias tareas y tener también varios elementos dependientes. Por ejemplo, si la tarea A tiene un <outputAsset> al que se hace referencia como inputAsset <> por la tarea B, la tarea B depende de la tarea A. Como resultado, Media Services tiene que finalizar el procesamiento de la tarea A antes de poder procesar la tarea B.
`Options` Necesario. Solo lectura después de la creación.	Edm.Int32	Valor de enumeración que describe las opciones de cifrado con las que se puede crear una tarea. Los valores válidos son: - Ninguno = 0 - ProtectedConfiguration = 1
`EncryptionKeyId` Opcional.	Edm.String	Identificador de clave cifrado.
`EncryptionScheme` Opcional.	Edm.String	EncryptionScheme que se usa con el archivo de configuración. El valor válido es "ConfigurationEncryption".
`EncryptionVersion` Opcional.	Edm.String	La versión del cifrado de configuración que se usará. La versión que se admite actualmente es la "1.0".
`InitializationVector` Opcional.	Edm.String	InitializationVector del archivo de configuración. La longitud máxima es 4000.
`OutputMediaAssets` Solo lectura. Establecido por Servicios multimedia.	Conjunto de entidades de recursos	Propiedad de navegación a la que se puede acceder haciendo referencia a una tarea específica por valor de identificador. El conjunto de entidades devuelto contiene todas las entidades OutputMediaAsset vinculadas a la tarea especificada.
`InputMediaAssets` Solo lectura. Establecido por Servicios multimedia.	Conjunto de entidades de recursos	Propiedad de navegación a la que se puede acceder haciendo referencia a una tarea específica por valor de identificador. El conjunto de entidades devuelto contiene todas las entidades InputMediaAsset vinculadas a la tarea especificada.
`TaskNotificationSubscriptions` Necesario.	Conjunto de entidades TaskNotificationSubscription	Define los cambios de estado de tarea del punto de conexión de notificación. Además, indica si se debe incluir el progreso de la tarea para el que se notificará.

Crear una tarea

Para crear una tarea, se crea un trabajo. Para obtener un ejemplo, consulte Codificación de un recurso mediante Media Encoder Standard.

Enumerar tareas

Para recuperar Tasks, se realiza una solicitud HTTP GET.

Método	URI de solicitud	Versión HTTP
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Tasks>	HTTP/1.1

Método	URI de solicitud	Versión HTTP
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Jobs>('jobid')/Tasks	HTTP/1.1

Solicitud de ejemplo

Para obtener la versión más reciente x-ms-version:, consulte REST de 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

Consulte también

AccessPolicy
Recurso
ContentKey
Trabajo
Trabajo
JobTemplate
Localizador
MediaProcessor
TaskTemplate
Cuotas y limitaciones

Share via