Exportar (0) Imprimir
Expandir todo

Conectar con Media Services mediante la API de REST de Media Services

Actualizado: abril de 2014

Para acceder a Servicios multimedia de Microsoft Azure se necesitan dos cosas: un token de acceso que haya proporcionado Azure Access Control Services (ACS) y el URI de Media Services. Puede usar los métodos que desee para crear estas solicitudes siempre que especifique los valores de encabezado adecuados y pase el token de acceso correctamente al llamar a Media Services.

ImportantImportante
Después de conectarse correctamente a https://media.windows.net, recibirá una redirección 301 que especifica otro URI de Servicios multimedia. Debe realizar llamadas subsecuentes a la nueva URI.

Para acceder a Media Services directamente a través de la API de REST, recupere un token de acceso de ACS y úselo en todas las solicitudes HTTP que envíe al servicio. Este token es similar a otros tokens que proporciona ACS basados en demandas de acceso proporcionadas en el encabezado de una solicitud HTTP y que usan el protocolo OAuth v2. Para conectar directamente con Media Services, no necesita ningún otro requisito previo.

En el ejemplo siguiente se muestra el cuerpo y el encabezado de la solicitud HTTP usados para recuperar un token:

POST https://wamsprodglobal001acs.accesscontrol.windows.net/v2/OAuth2-13 HTTP/1.1 Content-Type: application/x-www-form-urlencoded Host: wamsprodglobal001acs.accesscontrol.windows.net Content-Length: 120 Expect: 100-continue Connection: Keep-Alive  grant_type=client_credentials&client_id=client id value&client_secret=URL-encoded client secret value&scope=urn%3aWindowsAzureMediaServices 
ImportantImportante
Media Services proporciona los valores de client_id y client_secret al configurar la cuenta. Se corresponden con los valores de AccountName y AccountKey, respectivamente. Para obtener más información, consulte las instrucciones de configuración de la cuenta de Media Services. Además, el elemento AccountKey de su cuenta de Media Services debe tener codificación URL cuando se usa como valor de client_secret en la solicitud del token de acceso.

En el ejemplo siguiente se muestra la respuesta HTTP que contiene el token de acceso en el cuerpo de la respuesta.

HTTP/1.1 200 OK Cache-Control: public, no-store, max-age=0 Content-Type: application/json; charset=utf-8 Expires: Fri, 13 Jan 2012 22:40:07 GMT Last-Modified: Fri, 13 Jan 2012 22:40:07 GMT Vary: * Server: Microsoft-IIS/7.5 Set-Cookie: ASP.NET_SessionId=w3mtu2rnxucaz5tvj0iyfm0t; path=/; HttpOnly X-AspNetMvc-Version: 2.5 X-AspNet-Version: 4.0.30319 X-Powered-By: ASP.NET X-Content-Type-Options: nosniff Date: Fri, 13 Jan 2012 22:40:07 GMT Content-Length: 580  {"access_token":"http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=client_id&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1326498007&Issuer=https%3a%2f%2f wamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=hV1WF7sTe%2ffoHqzK%2ftmnwQY22NRPaDytcOOpC9Nv4DA%3d","token_type":"http://schemas.xmlsoap.org/ws/2009/11/swt-token-profile-1.0","expires_in":"3599","scope":"urn:WindowsAzureMediaServices"} 
ImportantImportante
Se recomienda almacenar en caché los valores "access_token" y "expires_in" en un almacenamiento externo. Los datos del token se pueden recuperar más tarde del almacenamiento y volver a usar en las llamadas de la API de REST de Media Services. Esto resulta especialmente útil para escenarios en los que el token se puede compartir de forma segura entre varios procesadores o equipos.

Asegúrese de supervisar el valor de "expires_in" del token de acceso y actualice las llamadas de la API de REST con nuevos tokens según sea necesario.

El URI raíz de Media Services es https://media.windows.net/. De entrada, conecte con este URI y, si obtiene una redirección 301 como respuesta, realice llamadas subsiguientes al nuevo URI. No debe usar lógica del tipo auto-redirect/follow en las solicitudes. Los cuerpos de solicitud y verbos HTTP no se reenviarán al nuevo URI.

El URI raíz para cargar y descargar archivos de recursos es https://cuentaalmacenamiento.blob.core.windows.net/, donde el nombre de la cuenta de almacenamiento es el que usó al configurar la cuenta de Media Services.

En el código de ejemplo siguiente se muestra cómo crear un recurso en Media Services. Tenga en cuenta que el mecanismo de autorización real que se pasa en el encabezado de la solicitud es un token portador OAuth v2.

POST https://media.windows.net/API/Assets HTTP/1.1 Content-Type: application/json;odata=verbose Accept: application/json;odata=verbose DataServiceVersion: 3.0 MaxDataServiceVersion: 3.0 x-ms-version: 2.5 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=1335602357&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=XQs5T%2fEfdO39%2f0Z9%2fBBkA12%2bbUUEY21YyefWXuRYZlY%3d Host: media.windows.net Content-Length: 27 Expect: 100-continue  { "Name" : "NewJSONAsset" }
TipSugerencia
Para que las entidades de Media Services resulten más fáciles de detectar, puede usar la operación $metadata. Permite recuperar todos los tipos de entidades, propiedades de entidad, asociaciones, funciones y acciones válidos, entre otros. En el ejemplo siguiente se muestra cómo crear el URI. https://media.windows.net/API/$metadata.

Debe anexar "?api-version=2.5" al final del URI si desea ver los metadatos en un explorador o si no ha incluido el encabezado x-ms-version en su solicitud.

Vea también

Mostrar:
© 2014 Microsoft