Compartir a través de

Tarea

  • Artículo

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