Localizador

Artículo
07/19/2023

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 Uso de una firma de acceso compartido (API 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 Path propiedad no es útil hasta que se agrega una parte específica del protocolo.

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 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.
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.
Las direcciones URL de los localizadores de SAS cambiarán cada vez que se actualicen las claves de almacenamiento de la cuenta de almacenamiento asociada. Para obtener más información, vea Cómo: Actualizar Media Services después de las claves de acceso graduales de almacenamiento.
Puede haber un retraso de 30 a 40 segundos desde el momento en que se crea un localizador hasta que este está disponible para su uso. Este problema se aplica tanto a los localizadores de URL de SAS como a los localizadores de OnDemandOrigin.

Nota:

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

En este artículo se proporciona información general sobre la Locator entidad y también se muestra cómo ejecutar varias operaciones con la API de REST de Media Services.

Importante

Al obtener acceso a las entidades de Media Services, debe establecer los campos de encabezado específicos y los valores en las solicitudes HTTP.
Para obtener más información, consulte Configuración del desarrollo de la API de REST de Media Services y Conexión a Media Services con la API de REST de Media Services.

Propiedades de la entidad Locator

Propiedad	Tipo	Descripción
`Id` Opcional. No se puede actualizar después de la creación de la entidad.	Edm.String	Identificador único establecido por Media Services.
`Name` Opcional.	Edm.String	Nombre del localizador. La longitud máxima es 4000.
`ExpirationDateTime` De 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. ExpirationDateTime debe tener el siguiente formato DateTime: `YYYY-MM-DDTHH:mm:ssZ` (por ejemplo, "2014-05-23T17:53:50Z").
`Type` Necesario. 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: este es el valor de enumeración predeterminado. Ningún localizador válido tiene este tipo - SAS = 1: especifica el tipo de localizador firma de acceso compartido (Sas) - OnDemandOrigin = 2: especifica un tipo de localizador, que hace referencia a un punto de conexión de streaming de origen a petición de Azure Media Service
`Path` Solo lectura. Establecido por Servicios multimedia.	Edm.String	URL que se usa para acceder a los archivos de un recurso.
`BaseUri` Solo lectura. Establecido por Servicios multimedia.	Edm.String	Parte del localizador que proporciona información sobre el almacén, servicio o contenedor del recurso. (por ejemplo, nombre `http://someservice.cloudapp.net`de host dns )
`ContentAccessComponent` Solo lectura. Establecido por Servicios multimedia.	Edm.String	Parte del URI necesario para acceder al contenido. La ubicación de este token en la dirección URL del medio final depende del tipo de localizador, el tipo de medio y el servicio de streaming.
`AccessPolicyId` Solo lectura. Establecido por Servicios multimedia.	Edm.String	Identificador de AccessPolicy que define los permisos y la duración de la dirección URL del localizador. El permiso List no se debe usar al crear localizadores OnDemandOrigin.
`AssetId` Solo lectura. Establecido por Servicios multimedia.	Edm.String	El identificador del recurso que contiene 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. Propina: Si necesita cargar los archivos inmediatamente, debe establecer el valor de StartTime en cinco minutos antes de la hora actual. Esto se debe a que puede haber un desplazamiento de reloj entre el equipo cliente y Media Services. Además, el valor startTime debe tener el siguiente formato DateTime: `YYYY-MM-DDTHH:mm:ssZ` (por ejemplo, "2014-05-23T17:53:50Z").
`AssetPolicy` Solo lectura. Establecido por Servicios multimedia.	Conjunto de entidades `AssetPolicy`	Propiedad de desplazamiento a una instancia AccessPolicy.
`Asset` Solo lectura. Establecido por Servicios multimedia.	Conjunto de entidades `Asset`	Propiedad de desplazamiento a una instancia Asset.

Creación de Locator

Para crear Locators, puede usar una solicitud HTTP POST.

Método	URI de solicitud	Versión HTTP
POST	<https:// accountname.restv2>.<location.media.azure.net/api/Locators>	HTTP/1.1

Nota:

Las direcciones URL de los localizadores de SAS cambiarán cada vez que se actualicen las claves de almacenamiento de la cuenta de almacenamiento asociada. Para obtener más información, consulte How To: Update Media Services after Rolling Storage Access Keys (Cómo: Actualizar Media Services después de cambiar las claves de acceso de almacenamiento).

Solicitud de ejemplo

Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.

POST https://<accountname>.restv2.<location>.media.azure.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.19  
Authorization: Bearer <token value>  
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 más información, consulte Entrega de recursos con la API REST de Media Services.

Lista de Locators

Para recuperar Locators, use una solicitud HTTP GET.

Método	URI de solicitud	Versión HTTP
GET	GET https://< accountname.restv2>.<location.media.azure.net/api/Locators>	HTTP/1.1

Método	URI de solicitud	Versión HTTP
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid')	HTTP/1.1

Método	URI de solicitud	Versión HTTP
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/Locators	HTTP/1.1

Solicitud de ejemplo

Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.

GET https://<accountname>.restv2.<location>.media.azure.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.19  
Authorization: Bearer <token value>  
Host: media.windows.net

Actualización de Locator

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

Método	URI de solicitud	Versión HTTP
MERGE	<https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid')	HTTP/1.1

Solicitud de ejemplo

Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.

MERGE https://<accountname>.restv2.<location>.media.azure.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.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 38  
Expect: 100-continue  
  
{"StartTime" : "2014-05-17T16:45:53"}

Eliminación de Locator

Para eliminar Locators, use una solicitud HTTP DELETE.

Método	URI de solicitud	Versión HTTP
Delete	<https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid')	HTTP/1.1

Solicitud de ejemplo

Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.

DELETE https://<accountname>.restv2.<location>.media.azure.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.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 0  
Connection: Keep-Alive

Consulte también

Entrega de recursos con la API de REST de Servicios multimedia
ContentKey
Recurso
AccessPolicy
AssetFile
JobTemplate
Trabajo
MediaProcessor
Task
TaskTemplate
Cuotas y limitaciones

Localizador

Propiedades de la entidad Locator

Creación de Locator

Solicitud de ejemplo

Lista de Locators

Solicitud de ejemplo

Actualización de Locator

Solicitud de ejemplo

Eliminación de Locator

Solicitud de ejemplo

Consulte también

Recursos adicionales