Condividi tramite

IngestManifestFile

  • Articolo

Un'entità IngestManifestFile corrisponde a un file del manifesto di inserimento e rappresenta un effettivo oggetto BLOB video o audio che verrà caricato durante l'inserimento in blocco. Per altre informazioni sull'inserimento in blocco, vedere Inserimento di asset in blocco con l'API REST. Un'entità IngestManifestFile è sempre associata a un'entità IngestManifest e a un'entità IngestManifestAsset.

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

Importante

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

Proprietà dell'entità IngestManifestFile

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 sono state apportate modifiche alle proprietà. Rappresenta il numero di millisecondi trascorsi dalla mezzanotte del 1° gennaio 1970.
Name

Obbligatorio.		 Edm.String Nome file effettivo che verrà caricato nel contenitore BLOB a cui fa riferimento la proprietà BlobStorageUriForUpload di IngestManifest. Servizi multimediali controlla il caricamento di file nel contenitore in base al nome.

Il nome del file non deve essere vuoto o composto da spazi vuoti. Deve essere univoco nell'entità IngestManifest. La lunghezza massima è 4000.
State

Di sola lettura. Impostata da Servizi multimediali.		 Edm.Int32 Stato corrente dell'entità IngestManifestFile. I valori validi sono i seguenti:

- In sospeso = 0: il file non è ancora stato caricato per completare la creazione dell'asset. Servizi multimediali è in attesa del caricamento del file.
- Completato = 1: il caricamento del file è stato rilevato e l'asset associato è stato aggiornato.
- Errore = 2: Errore durante l'elaborazione del file. Per informazioni sugli errori, vedere la proprietà ErrorDetails.
ParentIngestManifestId

Obbligatorio.		 Edm.String ID del manifesto di inserimento contenente il file.
ParentIngestManifestAssetId

Obbligatorio.		 Edm.String ID dell'entità IngestManifestAsset a cui è associato il file.
ErrorDetail

Di sola lettura. Impostata da Servizi multimediali.		 Edm.String Dettagli di un errore verificatosi durante l'elaborazione del file.
MimeType

Facoltativa.		 Edm.String Servizi multimediali non verifica alcun oggetto BLOB caricato, pertanto è necessario impostare manualmente il tipo MIME. Ad esempio, "text/plain" o "video/x-ms-wmv" sono valori validi da usare.
IsPrimary

Facoltativa.		 Edm.Boolean Determina se quest'entità IngestManifestFile è il file primario in un asset con più file.
EncryptionVersion

Facoltativa.		 Edm.String La versione attualmente supportata per StorageEncryption, CommonEncryption ed EnvelopeEncryption è "1.0".
EncryptionScheme

Facoltativa.		 Edm.String Schema di crittografia usato per il file. I valori validi sono: "StorageEncryption", "CommonEncryption" o "EnvelopeEncryption".
IsEncrypted

Facoltativa.		 Edm.Boolean Questo valore deve essere impostato su true se per il file è stata applicata la crittografia di archiviazione.
EncryptionKeyId

Facoltativa.		 Edm.String ID della chiave simmetrica crittografata.
InitializationVector

Facoltativa.		 Edm.String Vettore di inizializzazione usato per la crittografia di archiviazione.

Creare un'entità IngestManifestFile

Le entità IngestManifestFile possono essere create tramite una richiesta HTTP POST. È necessario passare un corpo della richiesta contenente il nome Name della nuova entità IngestManifestFile insieme ai valori ParentIngestManifestId e ParentIngestManifestAssetId.

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

Richiesta di esempio

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

POST https://<accountname>.restv2.<location>.media.azure.net/api/IngestManifestFiles 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: 200  
Expect: 100-continue  
  
{ "Name" : "REST_Example_File.wmv", "ParentIngestManifestId" : "nb:mid:UUID:bfe2d76c-17bd-884a-b9be-21bdfda65984", "ParentIngestManifestAssetId" : "nb:maid:UUID:9c6e7256-fefd-c541-aa69-fd04cf1cc1a6" }

Elencare le entità IngestManifestFile

Le entità IngestManifestFile possono essere recuperate tramite una richiesta HTTP GET. È possibile richiedere un'entità IngestManifestFile in base al relativo ID oppure richiedere tutte le entità IngestManifestFiles omettendo l'ID.

Metodo URI richiesta Versione HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifestFiles> HTTP/1.1
GET <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifestFiles>('IngestManifestFile Id') 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/IngestManifestFiles('nb:mfid:UUID:030ef5ef-c5b3-2c4a-86da-217d4d2170de') 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

Eliminare un'entità IngestManifestFile

Le entità IngestManifestFile 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/IngestManifestFiles>('IngestManifestFile Id') HTTP/1.1

Richiesta di esempio

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

DELETE https://<accountname>.restv2.<location>.media.azure.net/api/IngestManifestFiles('nb:mfid:UUID:030ef5ef-c5b3-2c4a-86da-217d4d2170de') 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

AssetFile
IngestManifest
IngestManifestAsset
IngestManifestStatistics
Quote e limitazioni