Exporteren (0) Afdrukken
Alles uitvouwen
EN
Deze inhoud is niet beschikbaar in uw taal, maar wel in het Engels.

IngestManifest

Updated: February 18, 2014

An IngestManifest represents a set of assets to be created through bulk ingesting along with their associated asset files. Bulk ingesting allows you to decouple the file upload process from asset creation so that high performance file upload methods can be used for very large file sets during asset creation. Each asset to be created is represented by an IngestManifestAsset in the IngestManifestAssets collection contained in the manifest. Once an IngestManifestAssets is created along with its associated IngestManifestFiles, Microsoft Azure Media Services watches the Blob storage container associated with the IngestManifest via the BlobStorageUriForUpload property. As each file upload to the Blob storage container completes, Microsoft Azure Media Services completes a new asset for the respective IngestManifestAsset that contains that file.

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

ImportantImportant
When working with the Media Services REST API, the following considerations apply:

noteNote
Each IngestManifestAssetFile associated to an IngestManifest must have a unique filename in the manifest.

IngestManifest 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.

Name

Optional.

Edm.String

Friendly name for your IngestManifest.

State

Read-only. Set by Media Services.

Edm.Int32

The current state of the manifest. This value can be one of the following:

  • Inactive = 0: No pending asset creations remain. All have either completed or encountered an error.

  • Activating = 1: The manifest is not yet ready to receive files uploaded to the Blob container.

  • Active = 2: There are IngestManifestAssets pending creations and the Blob container is being monitored.

BlobStorageUriForUpload

Read-only. Set by Media Services.

Edm.String

This value is set by Media Services. This value specifies the Uri of the Blob storage container which receives the file uploads needed to complete the IngestManifestAssets.

Statistics

Read-only. Set by Media Services.

IngestManifestStatistics

This complex type contains statistic information to help determine the current progress of the creation of IngestManifestAssets based on all asset files related to the manifest.

IngestManifestAssets

Read-only. Set by Media Services.

IngestManifestAsset entity set

Navigation property that can be accessed by referencing a specific IngestManifestAsset by Id value. The returned entity set contains all IngestManifestAssets contained in the IngestManifest.

PendingIngestManifestAssets

Read-only. Set by Media Services.

IngestManifestAsset entity set

Navigation property that can be accessed by referencing a specific IngestManifestAsset by Id value. The returned entity set contains all IngestManifestAssets pending file upload or asset creation.

StorageAccountName

Optional. Cannot be updated after the entity has been created.

Edm.String

Name of the storage account that contains the blob container where the files are uploaded.

If not specified at creation time, Media Services sets the default storage account name.

IngestManifestAsset.Asset has to use the same storage account as specified in the IngestManifest.

StorageAccount

Read-only. Set by Media Services.

StorageAccount entity set.

The returned entity set contains all of the StorageAccount entities that are linked to the specified Asset.

Create an IngestManifest

IngestManifests can be created by using an HTTP POST request and passing a request body that contains the name of the new IngestManifest.

 

Method Request URI HTTP Version

POST

https://media.windows.net/API/IngestManifests

HTTP/1.1

Sample Request

ImportantImportant
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.

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.6
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: 36
Expect: 100-continue

{ "Name" : "ExampleManifestREST" }

List an IngestManifest

IngestManifests can be retrieved using an HTTP GET request. You can request an ingest manifest by its Id or request all manifests.

 

Method Request URI HTTP Version

GET

https://media.windows.net/API/IngestManifests

HTTP/1.1

GET

https://media.windows.net/API/IngestManifests(‘IngestManifest Id’)

HTTP/1.1

Sample Request

ImportantImportant
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.

GET https://media.windows.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.6
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

Update an IngestManifest

IngestManifests can be updated by referencing the IngestManifest Id with a HTTP MERGE request. The request body contains the properties to be updated.

 

Method Request URI HTTP Version

MERGE

https://media.windows.net/API/IngestManifests(‘IngestManifest Id’)

HTTP/1.1

Sample Request

ImportantImportant
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.

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.6
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: 43
Expect: 100-continue

{ "Name" : "ExampleManifestUpdated" }

Delete an Ingest Manifest

IngestManifests can be deleted by referencing the IngestManifest Id value with an HTTP DELETE request.

 

Method Request URI HTTP Version

DELETE

https://media.windows.net/API/IngestManifests(‘IngestManifest Id’)

HTTP/1.1

Sample Request

ImportantImportant
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.

DELETE https://media.windows.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.6
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


Build Date:

2014-05-29

Community-inhoud

Weergeven:
© 2014 Microsoft