Attività

Un'entità Task è una singola operazione di lavoro eseguita su un asset ed è definita in un'entità Job.

Questo argomento presenta informazioni generali sull'entità Task e mostra come eseguire varie operazioni con l'API REST di Servizi multimediali.

• Proprietà dell'entità Task

• Creare un'entità Task

• Elencare le attività

Importante

Quando si accede alle entità in Servizi multimediali, è necessario impostare valori e campi di intestazione specifici nelle richieste HTTP.
Per altre informazioni, vedere Configurazione per lo sviluppo di API REST di Servizi multimediali e connessione a Servizi multimediali con l'API REST di Servizi multimediali.

Proprietà dell'entità Task

Proprietà	Type	Descrizione
Id Di sola lettura. Impostato da Servizi multimediali in fase di creazione.	Edm.String	Identificatore univoco.
Configuration Facoltativa.	Edm.String	Set di impostazioni che definisce le azioni di elaborazione, ad esempio codifica, protezione e così via, che verranno eseguite dall'entità Task. La lunghezza massima è 100.000.
EndTime Di sola lettura. Impostata da Servizi multimediali.	Edm.DateTime	Data e ora in cui l'attività è stata completata, ha avuto esito negativo o è stata annullata.
ErrorDetails Di sola lettura. Impostata da Servizi multimediali.	Collection(ErrorDetail)	Raccolta di codici e messaggi dettagliati che descrivono gli eventuali errori che si verificano durante l'esecuzione di un'entità Task.
HistoricalEvents Di sola lettura. Impostata da Servizi multimediali.	Collection(TaskCollectionEvent)	Insieme di oggetti TaskCollectionEvent che descrivono gli eventi associati all'esecuzione dell'attività.
MediaProcessorId Obbligatorio.	Edm.String	ID del processore di contenuti multimediali che verrà usato nell'entità Task. I valori validi possono essere recuperati eseguendo una richiesta GET su /API/MediaProcessors.
Name Facoltativa.	Edm.String	Facoltativa. Nome descritto dell'entità Task. La lunghezza massima è 4000.
PerfMessage Di sola lettura. Impostata da Servizi multimediali.	Edm.String	Include informazioni sulle prestazioni dell'attività.
Priority Facoltativa.	Edm.Int32	Priorità dell'attività. Un valore più elevato indica una priorità più alta rispetto ad altre attività. . Ad esempio, un'attività con Priority = 40 verrà elaborata prima di un'attività con Priority = 30. Il limite superiore è uguale a MaxInt.
Progress Di sola lettura. Impostata da Servizi multimediali.	Edm.Double	Valore che indica una percentuale da zero a 100.
RunningDuration Di sola lettura. Impostata da Servizi multimediali.	Edm.Double	Tempo trascorso, in secondi, per l'attività.
StartTime Di sola lettura. Impostata da Servizi multimediali.	Edm.DateTime	Data e ora in cui è iniziata l'attività.
State Di sola lettura. Impostata da Servizi multimediali.	Edm.Int32	Stato dell'attività. I valori validi sono: - Nessuno = 0 - Attivo = 1 - Esecuzione = 2 - Completato = 3
TaskBody Obbligatorio.	Edm.String	Documento XML contenente informazioni relative agli asset di input e output su cui deve essere eseguita l'entità Task. Un'entità Task deve contenere almeno 1 asset di input e 1 asset di output. Il formato del documento XML corrisponde a quanto segue. <taskBody> <inputAsset> JobInputAsset(0)</inputAsset> <inputAsset> JobInputAsset(1)</inputAsset> <outputAsset assetCreationOptions=”1” assetName=”output” storageAccountName=”mystoreagename”> JobOutputAsset(0) </outputAsset> <taskBody> L'elemento <outputAsset> può avere gli attributi seguenti: - assetCreationOptions (o AssetCreationOptions). Questi attributi possono avere uno dei valori seguenti: None=0x0, StorageEncrypted=0x1, CommonEncryptionProtected=0x2, EnvelopeEncryptionProtected=0x4. Il valore predefinito è StorageEncrypted. - assetName (o AssetName). Se non specificato, Servizi multimediali imposta un nome nel formato seguente: l'elemento outputAsset padre suffisso in base al nome del processo (o l'ID processo, se il nome del processo è vuoto). - storageAccountName (o StorageAccountName). Nome dell'account di archiviazione in cui risiederà l'asset di output. Se non è specificato, verrà usato l'account di archiviazione predefinito dell'utente. Un'entità Task può dipendere da più entità Task e può contenere più elementi dipendenti. Ad esempio, se Task A ha un <outputAsset a cui viene fatto riferimento come <inputAsset>> by Task B, l'attività B dipende dall'attività A. Di conseguenza, Servizi multimediali deve completare l'elaborazione attività A prima di poter elaborare l'attività B.
Options Obbligatorio. Di sola lettura dopo la creazione.	Edm.Int32	Valore di enumerazione che descrive le opzioni di crittografia con cui può essere creata un'entità Task. I valori validi sono: - Nessuno = 0 - ProtectedConfiguration = 1
EncryptionKeyId Facoltativa.	Edm.String	Id della chiave crittografata.
EncryptionScheme Facoltativa.	Edm.String	Schema di crittografia usato con il file di configurazione. Il valore valido è "ConfigurationEncryption".
EncryptionVersion Facoltativa.	Edm.String	Versione della crittografia di configurazione da usare. La versione attualmente supportata è "1.0".
InitializationVector Facoltativa.	Edm.String	Vettore di inizializzazione del file di configurazione. La lunghezza massima è 4000.
OutputMediaAssets Di sola lettura. Impostata da Servizi multimediali.	Set di entità asset	Proprietà di navigazione a cui è possibile accedere facendo riferimento a un'entità Task specifica in base al valore ID. Set di entità restituito contenente tutte le entità OutputMediaAsset collegate all'entità Task specificata.
InputMediaAssets Di sola lettura. Impostata da Servizi multimediali.	Set di entità asset	Proprietà di navigazione a cui è possibile accedere facendo riferimento a un'entità Task specifica in base al valore ID. Set di entità restituito contenente tutte le entità InputMediaAsset collegate all'entità Task specificata.
TaskNotificationSubscriptions Obbligatorio.	Set di entità TaskNotificationSubscription	Definisce lo stato dell'attività dell'endpoint di notifica cambia. Indica anche se includere lo stato di avanzamento dell'attività per cui ricevere una notifica.

Creare un'entità Task

Per creare le entità Task è necessario creare un'entità Job. Per un esempio, vedere Come codificare un asset usando Media Encoder Standard.

Elencare le attività

Le entità Task vengono recuperate usando una richiesta HTTP GET.

Metodo	URI richiesta	Versione HTTP
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Tasks>	HTTP/1.1

Metodo	URI richiesta	Versione HTTP
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Jobs>('jobid')/Tasks	HTTP/1.1

Richiesta di esempio

Per ottenere l'ultima versione x-ms-version:, vedere REST servizi multimediali.

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  

Vedere anche

AccessPolicy
Asset
ContentKey
Processo
Processo
JobTemplate
Locator
MediaProcessor
TaskTemplate
Quote e limitazioni