IngestManifestAsset

  • Article

IngestManifestAssets represent Assets within an IngestManifest that are used with bulk ingesting. Microsoft Azure Media Services watches internally for the file upload based on IngestManifestFiles associated to the IngestManifestAsset. Once they are uploaded, the asset is completed. For more information on bulk ingesting, see Ingesting Assets in Bulk with the REST API.

This topic gives an overview of the IngestManifestAsset entity and also demonstrates how to execute various operations with the Media Services REST API.

Important

When accessing entities in Media Services, you must set specific header fields and values in your HTTP requests.
For more information, see Setup for Media Services REST API Development and Connecting to Media Services with the Media Services REST API.

IngestManifestAsset Entity Properties

Property Type Description
Id

Read-only. Set by Media Services at creation time.		 Edm.String Unique identifier.
Created

Read-only. Set by Media Services at creation time.		 Edm.DateTime Represents the number of milliseconds since midnight Jan 1, 1970.
LastModified

Read-only. Set by Media Services.		 Edm.DateTime This value is updated by Media Services after any property changes are made. It represents the number of milliseconds since midnight Jan 1, 1970.
ParentIngestManifestId

Required.		 Edm.String IngestManifest that will contain this IngestManifestAsset.
IngestManifestFiles

Read-only.		 IngestManifestFile entity set Navigation property that can be used to access the collection of IngestManifestFiles that make up the IngestManifestAsset. Individual IngestManifestFiles can be referenced using the IngestManifestFile Id.
Asset

Required.		 Asset entity Navigation property that can be used to reference the Asset associated to this IngestManifestAsset.

Create an IngestManifestAsset

IngestManifestAssets can be created using an HTTP POST request. IngestManifestAssets must associate with a parent IngestManifest Id and an asset Id in the request body.

Method Request URI HTTP Version
POST https://<accountname>.restv2.<location>.media.azure.net/api/IngestManifestAssets HTTP/1.1

Sample Request

To get the latest x-ms-version:, see Media Services REST.

POST https://media.windows.net /API/IngestManifestAssets 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: 152  
Expect: 100-continue  
{ "ParentIngestManifestId" : "nb:mid:UUID:5c77f186-414f-8b48-8231-17f9264e2048", "Asset" : { "Id" : "nb:cid:UUID:b757929a-5a57-430b-b33e-c05c6cbef02e"}}

List an IngestManifestAsset

IngestManifestAssets can be retrieved using an HTTP GET request. You can request a specific IngestManifestAsset by its Id or request all IngestManifestAssets.

Method Request URI HTTP Version
GET https://<accountname>.restv2.<location>.media.azure.net/api/IngestManifestAssets HTTP/1.1
GET https://<accountname>.restv2.<location>.media.azure.net/api/IngestManifestAssets(‘IngestManifestAsset Id’) HTTP/1.1

Sample Request

s To get the latest x-ms-version:, see Media Services REST.

GET https://media.windows.net /API/IngestManifestAssets('nb:maid:UUID:6422b0a7-15f1-3442-b800-dac3195df54f') 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

Delete an IngestManifestAsset

IngestManifestAssets can be deleted by referencing the IngestManifestAsset Id value with an HTTP DELETE request.

Method Request URI HTTP Version
DELETE https://<accountname>.restv2.<location>.media.azure.net/api/IngestManifestAssets(‘IngestManifestAsset Id’) HTTP/1.1

Sample Request

To get the latest x-ms-version:, see Media Services REST.

DELETE https://media.windows.net /API/IngestManifestAssets('nb:maid:UUID:9c6e7256-fefd-c541-aa69-fd04cf1cc1a6') 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

See Also

Asset
AssetFile
IngestManifest
IngestManifestFile
IngestManifestStatistics
Quotas and Limitations