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 working with the Media Services REST API, the following considerations apply:
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.
- After successfully connecting to https://media.windows.net, you will receive a 301 redirect specifying another Media Services URI. You must make subsequent calls to the new URI.
For more information, see Connecting to Media Services with the Media Services REST API.
IngestManifestAsset Entity Properties
| Property | Type | Description |
|---|---|---|
IdRead-only. Set by Media Services at creation time. |
Edm.String | Unique identifier. |
CreatedRead-only. Set by Media Services at creation time. |
Edm.DateTime | Represents the number of milliseconds since midnight Jan 1, 1970. |
LastModifiedRead-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. |
ParentIngestManifestIdRequired. |
Edm.String | IngestManifest that will contain this IngestManifestAsset. |
IngestManifestFilesRead-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. |
AssetRequired. |
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://media.windows.net/API/IngestManifestAssets | HTTP/1.1 |
Sample Request
Important
After successfully connecting to https://media.windows.net, you will receive a 301 redirect specifying another Media Services URI. You must make subsequent calls to the new URI.
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.11
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=070500D0-F35C-4A5A-9249-485BBF4EC70B&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1334275521&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=GxdBb%2fmEyN7iHdNxbawawHRftLhPFFqxX1JZckuv3hY%3d
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://media.windows.net/API/IngestManifestAssets | HTTP/1.1 |
| GET | https://media.windows.net/API/IngestManifestAssets(‘IngestManifestAsset Id’) | HTTP/1.1 |
Sample Request
Important
After successfully connecting to https://media.windows.net, you will receive a 301 redirect specifying another Media Services URI. You must make subsequent calls to the new URI.
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.11
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=070500D0-F35C-4A5A-9249-485BBF4EC70B&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1334275521&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=GxdBb%2fmEyN7iHdNxbawawHRftLhPFFqxX1JZckuv3hY%3d
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://media.windows.net/API/IngestManifestAssets(‘IngestManifestAsset Id’) | HTTP/1.1 |
Sample Request
Important
After successfully connecting to https://media.windows.net, you will receive a 301 redirect specifying another Media Services URI. You must make subsequent calls to the new URI.
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.11
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=070500D0-F35C-4A5A-9249-485BBF4EC70B&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1334275521&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=GxdBb%2fmEyN7iHdNxbawawHRftLhPFFqxX1JZckuv3hY%3d
Host: media.windows.net
Content-Length: 0
See Also
Asset
AssetFile
IngestManifest
IngestManifestFile
IngestManifestStatistics
Quotas and Limitations