IngestManifest

  • Artículo

La entidad IngestManifest representa un conjunto de recursos que se crearán mediante el ingesta en bloque junto con sus archivos de recursos asociados. La ingesta masiva permite desacoplar el proceso de carga de archivos de la creación de recursos. Como resultado, se puede usar un método de carga de archivos de alto rendimiento para conjuntos de archivos grandes durante la creación de recursos. Una vez creado un IngestManifestAssets, junto con sus archivos IngestManifestFiles asociados, Microsoft Azure Media Services inspecciona el contenedor de Almacenamiento de blobs asociado a IngestManifest a través de la propiedad BlobStorageUriForUpload. A medida que se completa cada carga de archivos en el contenedor de Blob Storage, Microsoft Azure Media Services completa un nuevo recurso para el objeto IngestManifestAsset correspondiente que contiene ese archivo.

En este artículo se proporciona información general sobre la IngestManifest entidad y también se muestra cómo ejecutar varias operaciones con la API 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.

Nota

Cada IngestManifestAssetFile asociado a ingestManifest debe tener un nombre de archivo único en el manifiesto.

Propiedades de la entidad IngestManifest

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

Opcional.		 Edm.String Nombre descriptivo para IngestManifest.
State

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

- Inactivo = 0: no quedan creaciones de recursos pendientes. Todas se han completado o tienen un error.
- Activación = 1: el manifiesto aún no está listo para recibir archivos cargados en el contenedor de blobs.
- Activo = 2: hay creaciones pendientes de IngestManifestAssets y se está supervisando el contenedor de blobs.
BlobStorageUriForUpload

Solo lectura. Establecido por Servicios multimedia.		 Edm.String Media Services establece este valor. Este valor especifica el URI del contenedor de Blob Storage, que recibe las cargas de archivos necesarias para completar IngestManifestAssets.
Statistics

Solo lectura. Establecido por Servicios multimedia.		 IngestManifestStatistics Este tipo complejo contiene información estadística que ayuda a determinar el progreso actual de la creación de IngestManifestAssets a partir de todos los archivos de recursos relacionados con el manifiesto.
IngestManifestAssets

Solo lectura. Establecido por Servicios multimedia.		 Conjunto de entidades IngestManifestAsset Propiedad de navegación a la que se puede acceder haciendo referencia a un IngestManifestAsset específico por valor de identificador. El conjunto de entidades devuelto contiene todos los IngestManifestAssets que se incluyen en IngestManifest.
PendingIngestManifestAssets

Solo lectura. Establecido por Servicios multimedia.		 Conjunto de entidades IngestManifestAsset Propiedad de navegación a la que se puede acceder haciendo referencia a un IngestManifestAsset específico por valor de identificador. El conjunto de entidades devuelto contiene todos los IngestManifestAssets pendientes de la carga de archivos o la creación de recursos.
StorageAccountName

Opcional. No se puede actualizar después de la creación de la entidad.		 Edm.String Nombre de la cuenta de almacenamiento que contiene el contenedor blob donde se cargan los archivos.

Si no se especifica en el momento de la creación, Media Services establece el nombre de la cuenta de almacenamiento predeterminada.

IngestManifestAsset.Asset debe usar la misma cuenta de almacenamiento que se especifica en IngestManifest.
StorageAccount

Solo lectura. Establecido por Servicios multimedia.		 Conjunto de entidades StorageAccount. El conjunto de entidades devuelto contiene todas las entidades StorageAccount vinculadas al recurso especificado.

Creación de IngestManifest

Para crear IngestManifests, se puede usar una solicitud HTTP POST y pasar un cuerpo de solicitud que contenga el nombre del nuevo IngestManifest.

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

Solicitud de ejemplo

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

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

Lista de IngestManifest

Los IngestManifests se pueden recuperar mediante una solicitud HTTP GET. Puede solicitar un manifiesto de ingesta por identificador o solicitarlos todos.

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

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

Actualización de IngestManifest

IngestManifests se puede actualizar haciendo referencia al id. de IngestManifest con una solicitud HTTP MERGE. El cuerpo de la solicitud contiene las propiedades que se actualizarán.

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

Solicitud de ejemplo

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

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

Eliminación de un manifiesto de ingesta

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

Método URI de solicitud Versión HTTP
Delete <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests>('IngestManifest 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/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

Consulte también

AccessPolicy
AssetFile
Recurso
ContentKey
IngestManifestAsset
IngestManifestFile
IngestManifestStatistics
Trabajo
JobTemplate
Localizador
MediaProcessor
Task
TaskTemplate
Cuotas y limitaciones