Exportar (0) Imprimir
Expandir todo

Tarea

Actualizado: febrero de 2015

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 Servicios multimedia.

ImportantImportante
Al trabajar con la API de REST de Servicios multimedia, tenga en cuenta las consideraciones siguientes:

 

Propiedad Tipo Descripción

Id

De solo lectura. Definida 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

De solo lectura. Definida por Media Services.

Edm.DateTime

Fecha y hora en que se completó, interrumpió o canceló la tarea.

ErrorDetails

De solo lectura. Definida por Media Services.

Colección(ErrorDetail)

Colección de códigos y mensajes detallados que describen los errores que se producen al ejecutarse una tarea.

HistoricalEvents

De solo lectura. Definida por Media Services.

Colección(TaskHistoricalEvent)

Colección de objetos TaskHistoricalEvent que describen los eventos asociados a la ejecución de la tarea.

MediaProcessorId

Requerido.

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

De solo lectura. Definida por Media Services.

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 el valor Priority = 40 se procesará antes de una tarea con el valor Priority = 30. El límite superior es igual a MaxInt.

Progress

De solo lectura. Definida por Media Services.

Edm.Double

Valor que indica cero al 100 %.

RunningDuration

De solo lectura. Definida por Media Services.

Edm.Double

Tiempo transcurrido (en segundos) para la tarea.

StartTime

De solo lectura. Definida por Media Services.

Edm.DateTime

Fecha y hora en que se inició la tarea.

State

De solo lectura. Definida por Media Services.

Edm.Int32

Estado de la tarea. Los valores válidos son:

  • None = 0

  • Activo = 1

  • En ejecución = 2

  • Completado = 3

TaskBody

Requerido.

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 siguientes atributos:

  1. assetCreationOptions (o AssetCreationOptions). Este atributo puede tener uno de estos dos valores: None=0x0, StorageEncrypted=0x1, CommonEncryptionProtected=0x2, EnvelopeEncryptionProtected=0x4. El valor predeterminado es StorageEncrypted.

  2. assetName (o AssetName). Si no se especifica ninguno, Media Services establece un nombre con el siguiente formato: el elemento principal outputAsset con el nombre de trabajo como sufijo (o el identificador de trabajo, si el nombre de trabajo está vacío).

  3. 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 la tarea B hace referencia como un <inputAsset>, la tarea B depende de la tarea A. Como resultado, Media Services debe acabar de procesar la tarea A antes de procesar la tarea B.

Options

Requerido. 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:

  • None = 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

De solo lectura. Definida por Media Services.

Conjunto de entidades Activo

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

De solo lectura. Definida por Media Services.

Conjunto de entidades Activo

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.

Para crear una tarea, se crea un trabajo. Vea un ejemplo en Crear un trabajo.

Para recuperar Tasks, se realiza una solicitud HTTP GET.

 

Método URI de solicitud Versión de HTTP

GET

https://media.windows.net/API/Tasks

HTTP/1.1

 

Método URI de solicitud Versión de HTTP

GET

https://media.windows.net/API/Jobs('jobid')/Tasks

HTTP/1.1

ImportantImportante
Después de conectarse correctamente a https://media.windows.net, recibirá una redirección 301 que especifica otro URI de Servicios multimedia. Debe realizar llamadas subsecuentes a la nueva URI.

GET https://media.windows.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.7
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=youraccountname&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1337212980&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=kK7PbPM3lTAEJYIx5OTWeaSY7zvia358UjPiuvSFHz0%3d
Host: media.windows.net

Vea también

Mostrar:
© 2015 Microsoft