¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
Exportar (0) Imprimir
Expandir todo

Localizador

Actualizado: junio de 2015

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 el cliente tiene acceso a un recurso, 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 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 OnDemandOrigin, la propiedad Path no resulta útil hasta que se le agrega la parte específica del protocolo.

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

  1. Los localizadores de URL de firma de acceso compartido (SAS) que se usan con AccessPolicies que definen permisos de lectura, así como los localizadores de origen, no se pueden crear hasta que se cargan los archivos en un recurso. Los localizadores de URL SAS, que se usan para descargar y cargar archivos, se puede crear antes de cargar los archivos solo si se usan con AccessPolicies que especifican permisos de escritura.

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

  3. Después de crear un localizador, puede que haya un retraso de 30 a 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.

noteNota
Los localizadores no se han diseñado para administrar el control de acceso por usuario. Para ofrecer distintos derechos de acceso a usuarios individuales, use soluciones de administración de derechos digitales (DRM).

En este tema encontrará un resumen de la entidad Locator y una demostración de cómo ejecutar distintas operaciones con la API de REST de Servicios multimedia.

ImportantImportante
Al trabajar con la API de REST de Servicios multimedia, tenga en cuenta las consideraciones siguientes:

 

Propiedad Tipo Descripción

Id

Opcional. No se puede actualizar después de la creación de la entidad.

Edm.String

Identificador único que define Media Services.

Name

Opcional.

Edm.String

Nombre del localizador. La longitud máxima es 4000.

ExpirationDateTime

Solo escritura. Use una solicitud MERGE HTTP para actualizar el valor 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.

El valor de ExpirationDateTime debe proporcionarse con el formato siguiente: YYYY-MM-DDTHH:mm:ssZ (por ejemplo, "2014-05-23T17:53:50Z").

Type

Requerido. No se puede actualizar después de la creación de la entidad.

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 los Servicios multimedia de Azure

Path

De solo lectura. Definida por Media Services.

Edm.String

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

BaseUri

De solo lectura. Definida por Media Services.

Edm.String

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

ContentAccessComponent

De solo lectura. Definida por Media Services.

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

De solo lectura. Definida por Media Services.

Edm.String

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

Tenga en cuenta que el permiso Lista no debe utilizarse cuando se crean localizadores OnDemandOrigin.

AssetId

De solo lectura. Definida por Media Services.

Edm.String

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

StartTime

Opcional.

Edm.DateTime

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

TipSugerencia
Si necesita cargar los archivos inmediatamente, defina el valor StartTime cinco minutos antes de la hora actual. El motivo es que puede haber un desfase entre los relojes del equipo cliente y Media Services. El valor de StartTime debe tener también el formato FechaHora siguiente: YYYY-MM-DDTHH:mm:ssZ (por ejemplo, "2014-05-23T17:53:50Z").

AssetPolicy

De solo lectura. Definida por Media Services.

Conjunto de entidades AssetPolicy

Propiedad de desplazamiento a una instancia AccessPolicy.

Asset

De solo lectura. Definida por Media Services.

Conjunto de entidades Asset

Propiedad de desplazamiento a una instancia Asset.

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

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.

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.9
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" : "2014-05-17T16:45:53", "Type":1}

Para obtener más información, vea Delivering Assets with the Media Services REST API.

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

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.

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

Los localizadores de origen se pueden actualizar mediante una solicitud HTTP MERGE.

 

Método URI de solicitud Versión de HTTP

MERGE

https://media.windows.net/API/Locators('locatorid')

HTTP/1.1

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.

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.9
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" : "2014-05-17T16:45:53"}

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

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.

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

Mostrar:
© 2015 Microsoft