A media processor transforms media content into a different output. For example, you can use a media processor to transcode video from one bitrate and codec into another or to watermark a video. For a list of Microsoft Azure Media Services MediaProcessors, see Get a Media Processor.
This topic gives an overview of the MediaProcessor 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.
MediaProcessor Entity Properties
| Property | Type | Description |
|---|---|---|
IdRead-only. Set by Media Services. |
Edm.String | Unique identifier. |
NameRead-only. Set by Media Services. |
Edm.String | The friendly name of the MediaProcessor. |
DescriptionRead-only. Set by Media Services. |
Edm.String | A description about the MediaProcessor. |
SkuRead-only. Set by Media Services. |
Edm.String | The SKU of the MediaProcessor. |
VendorRead-only. Set by Media Services. |
Edm.String | The vendor name of the MediaProcessor |
VersionRead-only. Set by Media Services. |
Edm.String | The version of the MediaProcessor. |
List MediaProcessors
MediaProcessors can be retrieved using a GET HTTP request.
| Method | Request URI | HTTP Version |
|---|---|---|
| GET | https://media.windows.net/API/MediaProcessors | 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/MediaProcessors 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=youraccountname&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1337240173&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=kzBQXYnddSnOK1Arueh7ZoOIzibNRotOfV66K1hobSc%3d
Host: media.windows.net
See Also
ContentKey
Asset
AccessPolicy
AssetFile
JobTemplate
Locator
Job
Task
TaskTemplate
Quotas and Limitations