IngestManifest

Un'entità IngestManifest corrisponde a un manifesto di inserimento e rappresenta un set di asset da creare mediante l'inserimento in blocco insieme ai relativi file di asset associati. L'inserimento bulk consente di separare il processo di caricamento dei file dalla creazione dell'asset. Di conseguenza, un metodo di caricamento di file ad alte prestazioni può essere usato per set di file di grandi dimensioni durante la creazione di asset. Dopo aver creato un oggetto IngestManifestAssets, insieme alla relativa proprietà IngestManifestFiles associato, Servizi multimediali di Microsoft Azure controlla il contenitore di archiviazione BLOB associato all'IngestManifest tramite la proprietà BLOBStorageUriForUpload. Quando ogni caricamento di file nel contenitore di archiviazione BLOB viene completato, Servizi multimediali di Microsoft Azure completa un nuovo asset per i rispettivi IngestManifestAsset che contiene tale file.

Questo articolo offre una panoramica dell'entità e illustra anche come eseguire varie operazioni con l'API IngestManifest REST di Servizi multimediali.

• Proprietà dell'entità IngestManifest

• Creare un'entità IngestManifest

• Elencare le entità IngestManifest

• Aggiornare un'entità IngestManifest

• Eliminare un'entità IngestManifest

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.

Nota

Ogni IngestManifestAssetFile associato a un IngestManifest deve avere un nome file univoco nel manifesto.

Proprietà dell'entità IngestManifest

Proprietà	Type	Descrizione
Id Di sola lettura. Impostato da Servizi multimediali in fase di creazione.	Edm.String	Identificatore univoco.
Created Di sola lettura. Impostato da Servizi multimediali in fase di creazione.	Edm.DateTime	Rappresenta il numero di millisecondi trascorsi dalla mezzanotte del 1° gennaio 1970.
LastModified Di sola lettura. Impostata da Servizi multimediali.	Edm.DateTime	Questo valore viene aggiornato da Servizi multimediali dopo che vengono apportate modifiche alle proprietà. Rappresenta il numero di millisecondi trascorsi dalla mezzanotte del 1° gennaio 1970.
Name Facoltativa.	Edm.String	Nome descrittivo dell'entità IngestManifest.
State Di sola lettura. Impostata da Servizi multimediali.	Edm.Int32	Stato corrente del manifesto. I valori validi sono i seguenti: - Inattivo = 0: nessuna creazione di asset in sospeso rimane. Sono state tutte completate o si è verificato un errore. - Attivazione = 1: il manifesto non è ancora pronto per ricevere i file caricati nel contenitore BLOB. - Active = 2: sono presenti creazioni IngestManifestAssets in sospeso e il contenitore BLOB viene monitorato.
BlobStorageUriForUpload Di sola lettura. Impostata da Servizi multimediali.	Edm.String	Questo valore è impostato da Servizi multimediali. Questo valore specifica l'URI del contenitore di archiviazione BLOB, che riceve i caricamenti di file necessari per completare IngestManifestAssets.
Statistics Di sola lettura. Impostata da Servizi multimediali.	IngestManifestStatistics	Questo tipo complesso include informazioni statistiche utili per determinare lo stato di avanzamento corrente della creazione delle entità IngestManifestAsset in base a tutti i file di asset correlati al manifesto.
IngestManifestAssets Di sola lettura. Impostata da Servizi multimediali.	Set di entità IngestManifestAsset	Proprietà di navigazione a cui è possibile accedere facendo riferimento a un'entità IngestManifestAsset specifica in base al valore ID. Il set di entità restituito include tutte le entità IngestManifestAsset contenute nell'entità IngestManifest.
PendingIngestManifestAssets Di sola lettura. Impostata da Servizi multimediali.	Set di entità IngestManifestAsset	Proprietà di navigazione a cui è possibile accedere facendo riferimento a un'entità IngestManifestAsset specifica in base al valore ID. Il set di entità restituito include tutte le entità IngestManifestAsset in attesa del caricamento di file o della creazione di asset.
StorageAccountName Facoltativa. Impossibile eseguire l'aggiornamento dopo la creazione dell'entità.	Edm.String	Nome dell'account di archiviazione che include il contenitore BLOB in cui vengono caricati i file. Se non specificato in fase di creazione, Servizi multimediali imposta il nome dell'account di archiviazione predefinito. In IngestManifestAsset.Asset è necessario usare lo stesso account di archiviazione specificato nell'entità IngestManifest.
StorageAccount Di sola lettura. Impostata da Servizi multimediali.	Set di entità StorageAccount.	Set di entità restituito contenente tutte le entità StorageAccount collegate all'entità Asset specificata.

Creare un'entità IngestManifest

Le entità IngestManifest possono essere create usando una richiesta HTTP POST e passando un corpo della richiesta contenente il nome della nuova entità IngestManifest.

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

Richiesta di esempio

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

POST https:// media.windows.net/API/IngestManifests 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  
Content-Length: 36  
Expect: 100-continue  
  
{ "Name" : "ExampleManifestREST" }  
  

Elencare le entità IngestManifest

Le entità IngestManifest possono essere recuperate usando una richiesta HTTP GET. È possibile richiedere un manifesto di inserimento mediante il relativo ID oppure richiedere tutti i manifesti.

Metodo	URI richiesta	Versione HTTP
GET	<https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests>	HTTP/1.1
GET	<https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests>('IngestManifest Id')	HTTP/1.1

Richiesta di esempio

Per ottenere la versione più recente x-ms-version:, vedere Servizi multimediali REST.

GET https://<accountname>.restv2.<location>.media.azure.net/api/IngestManifests('nb:mid:UUID:a2f9a230-831e-5e40-bafa-fbf8decbee26') 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  
Content-Length: 0  

Aggiornare un'entità IngestManifest

IngestManifests può essere aggiornato facendo riferimento all'ID IngestManifest con una richiesta HTTP MERGE. Il corpo della richiesta include le proprietà da aggiornare.

Metodo	URI richiesta	Versione HTTP
MERGE	<https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests>('IngestManifest Id')	HTTP/1.1

Richiesta di esempio

Per ottenere la versione più recente x-ms-version:, vedere Servizi multimediali REST.

MERGE https:// media.windows.net /API/IngestManifests('nb:mid:UUID:076faa09-8f5d-ce41-9de3-32ba66190271') 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  
Content-Length: 43  
Expect: 100-continue  
  
{ "Name" : "ExampleManifestUpdated" }  
  

Eliminare un'entità IngestManifest

Le entità IngestManifest possono essere eliminate facendo riferimento al relativo valore ID con una richiesta HTTP DELETE.

Metodo	URI richiesta	Versione HTTP
DELETE	<https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests>('IngestManifest Id')	HTTP/1.1

Richiesta di esempio

Per ottenere la versione più recente x-ms-version:, vedere Servizi multimediali REST.

DELETE https://<accountname>.restv2.<location>.media.azure.net/api/IngestManifests('nb:mid:UUID:45ea3cd0-b3cf-994b-8e4d-03c9620c22da') 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  
Content-Length: 0  
  

Vedere anche

AccessPolicy
AssetFile
Asset
ContentKey
IngestManifestAsset
IngestManifestFile
IngestManifestStatistics
Processo
JobTemplate
Locator
MediaProcessor
Attività
TaskTemplate
Quote e limitazioni