Este tema aún no ha recibido ninguna valoración - Valorar este tema

Locators

Locator proporciona un punto de entrada para acceder a los archivos que contiene un recurso. Para definir los permisos y la duración durante la cual tiene acceso a un recurso el cliente, se usa AccessPolicy. Puede haber muchos localizadores relacionados con una única AccessPolicy, de modo que distintos localizadores pueden proporcionar diferentes horas iniciales y tipos de conexión a varios clientes y compartir la configuración de permisos y duración. Sin embargo, debido a una restricción de la directiva de acceso compartido que definen los servicios de almacenamiento de Windows Azure, no puede tener más de cinco localizadores únicos asociados a un único recurso a la vez. Para obtener más información, consulte el artículo sobre el uso de una firma de acceso compartido (API de REST).

En algunas ocasiones, es necesario transformar un URI de Locator para acceder a distintos formatos de archivo. Por ejemplo, la propiedad Path del localizador de SAS proporciona acceso al contenedor. Para acceder a los archivos, es necesario insertar el nombre de archivo entre el host y la firma de SAS. Cuando se trabaja con localizadores de origen, la propiedad Path no resulta útil hasta que se le agrega la parte específica del protocolo.

Nota
La red CDN no es un localizador. Es una manipulación de cadenas sobre una ruta de acceso a un localizador de SAS o de OnDemandOrigin.

Las reglas siguientes determinan cuándo se puede crear y actualizar un localizador:

Los localizadores de URL de firma de acceso compartido (SAS), que se usan para descargar y cargar archivos, se puede crear antes de publicar un recurso solo si se usan con AccessPolicies que especifican permisos de escritura. Los localizadores de URL de SAS que se usan con AccessPolicies que definen permisos de lectura, así como los localizadores de origen, no se pueden crear que se publica un recurso.
No se puede actualizar un localizador de URL de SAS después de su creación. Sin embargo, otros tipos de localizador, como los localizadores de origen, se pueden actualizar con nuevos valores de StartTime.
Después de crear un localizador, puede que haya un retraso de 30-40 segundos hasta que esté disponible y se pueda usar. Este problema se aplica tanto a los localizadores de URL de SAS como a los localizadores de OnDemandOrigin.

Importante
Al acceder a las entidades en Servicios multimedia de Windows Azure, debe definir campos y valores de encabezado específicos en las solicitudes HTTP. Para obtener más información, vea Setup for Media Services REST API Development.

Propiedades de la entidad Locator
Creación de Locator
Lista de Locators
Actualización de Locator
Eliminación de Locator

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

Propiedades de la entidad Locator

Propiedades

Tipo

Descripción

Edm.String

Identificador único que define Servicios multimedia.

ExpirationDateTime

Edm.DateTime

El valor (representado en milisegundos desde la medianoche del 1 de enero de 1970) a partir del cual ya no se puede usar el localizador para acceder al recurso especificado.

Tipo

Edm.Int32

Valor de enumeración que describe el tipo de localizador. Los valores válidos son:

None = 0: Es el valor de enumeración predeterminado. Ningún localizador válido tiene este tipo
SAS = 1 : Especifica el tipo de localizador de firma de acceso compartido (SAS)
OnDemandOrigin = 2 : Especifica un tipo de localizador que hace referencia a un extremo de streaming de origen a petición de Azure Media Services

Ruta de acceso

Edm.String

URL que se usa para acceder a los archivos de un recurso.

BaseUri

Edm.String

Parte del localizador que proporciona información sobre el almacén/servicio/contenedor del recurso. (por ejemplo, nombre de host de DNS http://someservice.cloudapp.net)

ContentAccessComponent

Edm.String

Parte del URI necesario para acceder al contenido. La ubicación de este token en la URL de contenido multimedia final depende del tipo de localizador, el tipo de contenido multimedia y el servicio de streaming.

AccessPolicyId

Edm.String

Identificador de AccessPolicy que define los permisos y la duración de la URL del localizador.

AssetId

Edm.String

Identificador del recurso que incluye el contenido al que desea proporcionar acceso.

StartTime

Edm.DateTime

Fecha y hora en que el localizador estará disponible para que lo usen los clientes.

Sugerencia
Si necesita clientes para acceder a los archivos inmediatamente, defina el valor de StartTime cinco minutos antes de la hora actual. El motivo es que puede haber un desfase entre el reloj del cliente y el del servidor. Además, el valor de StartTime debe seguir el formato de fecha y hora de la configuración regional de EE. UU.: mes/día/añohora:minutos:segundos AM/PM.

Creación de Locator

Para crear Locators, puede usar una solicitud HTTP POST.

Método	URI de solicitud	Versión de HTTP
POST	https://media.windows.net/API/Locators	HTTP/1.1

Solicitud de ejemplo

POST https://media.windows.net/API/Locators HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.1
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=1337212980&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=kK7PbPM3lTAEJYIx5OTWeaSY7zvia358UjPiuvSFHz0%3d
Host: media.windows.net
Content-Length: 182
Expect: 100-continue

{"AccessPolicyId": "nb:pid:UUID:25544a8f-8ccf-43b1-a188-2a860b35bffa", "AssetId" : "nb:cid:UUID:d062e5ef-e496-4f21-87e7-17d210628b7c", "StartTime" : "5/16/2012 1:57:53 PM", "Type":1}

Lista de Locators

Para recuperar Locators, use una solicitud HTTP GET.

Método	URI de solicitud	Versión de HTTP
GET	GET https://media.windows.net/API/Locators	HTTP/1.1

Método	URI de solicitud	Versión de HTTP
GET	https://media.windows.net/API/Locators('locatorid')	HTTP/1.1

Método	URI de solicitud	Versión de HTTP
GET	https://media.windows.net/API/Assets('assetid')/Locators	HTTP/1.1

Solicitud de ejemplo

GET https://media.windows.net/API/Locators('nb:lid:UUID:627cbafb-3d81-4623-97c2-2194282b6d16') HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.1
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=1337219077&Issuer=https%3a%2f%2fnimbustestaccounts.accesscontrol.windows.net%2f&HMACSHA256=JSeCQMLMDLIm%2fFD%2b8qJL52dShVNGdwg1aqB%2b3GLlq5I%3d
Host: media.windows.net

Actualización de Locator

Para actualizar los localizadores de red CDN de Windows Azure y de origen, puede usar una solicitud HTTP MERGE.

Método	URI de solicitud	Versión de HTTP
MERGE	https://media.windows.net/API/Locators('locatorid')	HTTP/1.1

Solicitud de ejemplo

MERGE https://media.windows.net/API/Locators('nb:lid:UUID:5bfcb65d-843d-4d5e-bf71-9306ecb08203') HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.1
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=1337219313&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=iULfw27Jo4TIBljQr8MDMDh2TX6YZBShgvY9yblaqKU%3d
Host: media.windows.net
Content-Length: 38
Expect: 100-continue

{"StartTime" : "5/16/2012 8:49:05 AM"}

Eliminación de Locator

Para eliminar Locators, use una solicitud HTTP DELETE.

Método	URI de solicitud	Versión de HTTP
DELETE	https://media.windows.net/API/Locators('locatorid')	HTTP/1.1

Solicitud de ejemplo

DELETE https://media.windows.net/API/Locators('nb:lid:UUID:9f0e0cee-8ea5-46c4-b985-5a7cd30e7623') HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.1
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=1337219313&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=iULfw27Jo4TIBljQr8MDMDh2TX6YZBShgvY9yblaqKU%3d
Host: media.windows.net
Content-Length: 0
Connection: Keep-Alive

Vea también

Conceptos

ContentKey
Asset
AccessPolicies
AssetFiles
JobTemplates
Jobs
MediaProcessors
Task
TaskTemplates

Otros recursos

Media Services Considerations

Fecha de compilación:

2013-06-12

¿Te ha resultado útil? Sí No

No es preciso

No es lo suficientemente profundo

Se necesitan ejemplos de código adicionales

La traducción necesita mejoras

(Caracteres restantes: 1500)

Adiciones de comunidad

AGREGAR