IngestManifestFile

  • Artículo

Un IngestManifestFile representa un objeto blob de audio o vídeo real que se cargará como parte de la ingesta en bloque. Para obtener más información sobre la ingesta masiva, consulte Ingesta de recursos en masa con la API REST. Un IngestManifestFile siempre está asociado a un IngestManifest y a un IngestManifestAsset.

En este tema encontrará un resumen de la entidad IngestManifestFile 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 para el desarrollo de api REST de Media Services y conexión a Media Services con la API REST de Media Services.

Propiedades de la entidad IngestManifestFile

Propiedad Tipo Descripción
Id

Solo lectura. Establezca por Media Services en el momento de la creación.		 Edm.String Identificador único.
Created

Solo lectura. Establezca por Media Services en el momento de la creación.		 Edm.DateTime Representa el número de milisegundos desde la medianoche del 1 de enero de 1970.
LastModified

Solo lectura. Establecido por Servicios multimedia.		 Edm.DateTime Media Services actualiza este valor después de realizar cualquier cambio de propiedad. Representa el número de milisegundos desde la medianoche del 1 de enero de 1970.
Name

Necesario.		 Edm.String Nombre de archivo real que se cargará en el contenedor de blobs al que hace referencia la propiedad BlobStorageUriForUpload de IngestManifest. Media Services busca la carga de archivos en ese contenedor por nombre.

El nombre del archivo no puede estar en blanco ni contener espacios en blanco. Único en IngestManifest. La longitud máxima es de 4000.
State

Solo lectura. Establecido por Servicios multimedia.		 Edm.Int32 Estado actual de IngestManifestFile. Este valor puede ser uno de los siguientes:

- Pendiente = 0: el archivo aún no se ha cargado para completar la creación del recurso. Media Services está esperando la carga de archivos.
- Finalizado = 1: se detectó la carga de archivos y se actualizó el recurso asociado.
- Error = 2: Error al procesar este archivo. Consulte la propiedad ErrorDetails para obtener información sobre el error.
ParentIngestManifestId

Necesario.		 Edm.String Identificador de IngestManifest del manifiesto que contiene el archivo.
ParentIngestManifestAssetId

Necesario.		 Edm.String Identificador del IngestManifestAsset al que está asociado el archivo.
ErrorDetail

Solo lectura. Establecido por Servicios multimedia.		 Edm.String Detalles de errores detectados al procesar el archivo.
MimeType

Opcional.		 Edm.String Media Services no inspecciona los blobs que se cargan, de modo que debe definir el tipo MIME manualmente. Por ejemplo, "text/plain" o "video/x-ms-wmv" son valores válidos que se pueden usar.
IsPrimary

Opcional.		 Edm.Boolean Determina si el IngestManifestFile es el archivo principal de un recurso con varios archivos.
EncryptionVersion

Opcional.		 Edm.String La versión actual compatible con StorageEncryption, CommonEncryption y EnvelopeEncryption es "1.0".
EncryptionScheme

Opcional.		 Edm.String Esquema de cifrado usado para el archivo. Los valores válidos son: "StorageEncryption", "CommonEncryption" o "EnvelopeEncryption".
IsEncrypted

Opcional.		 Edm.Boolean Este valor debe configurarse como true si el archivo está cifrado y almacenado.
EncryptionKeyId

Opcional.		 Edm.String Identificador de ContentKey cifrado.
InitializationVector

Opcional.		 Edm.String Vector de inicialización que se usa para el cifrado de almacenamiento.

Creación de IngestManifestFile

Para crear IngestManifestFiles, puede usar una solicitud HTTP POST. Pase un cuerpo de solicitud que contenga el nombre en la sección Name del nuevo IngestManifestFile, junto con el ParentIngestManifestId y el ParentIngestManifestAssetId.

Método URI de solicitud Versión HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifestFiles> HTTP/1.1

Solicitud de ejemplo

Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.

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" }

Lista de IngestManifestFile

Para recuperar IngestManifestFiles, puede usar una solicitud HTTP GET. Puede solicitar un IngestManifestFile por identificador o ignorar el identificador para solicitarlos todos.

Método URI de solicitud Versión 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

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/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

Eliminación de IngestManifestFile

Para eliminar IngestManifestFiles, puede hacer referencia al valor del identificador de IngestManifestFile con una solicitud HTTP DELETE.

Método URI de solicitud Versión HTTP
Delete <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifestFiles>('IngestManifestFile Id') HTTP/1.1

Solicitud de ejemplo

Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.

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

Consulte también

AssetFile
IngestManifest
IngestManifestAsset
IngestManifestStatistics
Cuotas y limitaciones