Compartilhar via

Localizador

  • Artigo

Locator fornece um ponto de entrada para acessar os arquivos contidos em um ativo. Uma AccessPolicy é usada para definir as permissões e duração de acesso a um ativo específico por um cliente. Os localizadores podem ter um relacionamento de muitos para um com uma AccessPolicy, de tal modo que localizadores diferentes possam fornecer horas de início e tipos de conexões distintos para vários clientes enquanto todos utilizam as mesmas configurações de permissão e duração; contudo, devido a uma restrição de política de acesso compartilhado configurada pelos serviços de armazenamento do Azure, você não pode ter mais do que cinco localizadores únicos de uma vez associados a um ativo especifico. Para obter mais informações, consulte Usando uma Assinatura de Acesso Compartilhado (API REST).

Geralmente, você precisa transformar uma Uri de Locator para acessar vários formatos de arquivo. Por exemplo, a propriedade Path do localizador de SAS dá acesso ao contêiner. Para acessar arquivos, você precisa inserir o nome do arquivo entre a assinatura SAS e o host. Ao trabalhar com localizadores OnDemandOrigin, a Path propriedade não é útil até que parte específica do protocolo seja adicionada a ela.

As regras a seguir controlam a criação e atualização de um localizador:

  1. Localizadores de URL de SAS (assinatura de acesso) usados com AccessPolicies que definem permissões de leitura, bem como localizadores de Origem, não podem ser criados até os arquivos serem carregados em um ativo. Localizadores de URL de SAS, que são usados para fazer download ou upload de arquivos, poderão ser criados antes que os arquivos sejam carregados apenas se eles forem usados com AccessPolicies que especifiquem permissões de gravação.

  2. Você não pode atualizar um localizador de URL SAS após sua criação; contudo, outros tipos de localizadores, como localizadores de origem, podem ser atualizados como os novos valores de StartTime.

  3. As URLs dos localizadores SAS serão alteradas sempre que as chaves de armazenamento da conta de armazenamento associada forem atualizadas. Para obter mais informações, consulte How To: Update Media Services after Rolling Storage Access Keys

  4. Pode haver um 30 a 40 segundos de atraso após a criação de um localizador quando ele está disponível para uso. Esse problema se aplica aos localizadores URL SAS e OnDemandOrigin.

Observação

Os localizadores não foram designados para gerenciar um controle de acesso por usuário. Para conceder direitos de acesso diferentes para usuários individuais, use as soluções de gerenciamento de direitos digitais (DRM).

Este artigo fornece uma visão geral da Locator entidade e também demonstra como executar várias operações com a API REST dos Serviços de Mídia.

Importante

Ao acessar entidades nos serviços de mídia, você deve definir valores e campos de cabeçalho específicos nas suas solicitações HTTP.
Para obter mais informações, consulte Instalação para desenvolvimento de API REST dos Serviços de Mídia e Conexão aos Serviços de Mídia com a API REST dos Serviços de Mídia.

Propriedades de entidade de localizador

Propriedade Type Descrição
Id

Opcional. Não pode ser atualizada após a criação da entidade.		 Edm.String Identificador exclusivo definido pelos Serviços de Mídia.
Name

Opcional.		 Edm.String O nome do localizador. O comprimento máximo é 4000.
ExpirationDateTime

Somente gravação. Use uma solicitação MERGE HTTP para atualizar o valor ExpirationDateTime.		 Edm.DateTime O valor (representado em milissegundos desde a meia-noite de 1º de janeiro de 1970) a partir do qual o localizador não pode mais ser usado para acessar o ativo especificado.

O ExpirationDateTime deve estar no seguinte formato DateTime: YYYY-MM-DDTHH:mm:ssZ (por exemplo, "2014-05-23T17:53:50Z").
Type

Obrigatórios. Não pode ser atualizada após a criação da entidade.		 Edm.Int32 O valor de enumeração que descreve o tipo de localizador. Os valores válidos são:

- None = 0: esse é o valor de enumeração padrão. Nenhum localizador válido terá esse tipo
- SAS = 1: especifica o tipo de localizador Sas (Assinatura de Acesso Compartilhado)
- OnDemandOrigin = 2: especifica um tipo de localizador, que se refere a um ponto de extremidade de streaming de Origem sob Demanda do Serviço de Mídia do Azure
Path

Somente leitura. Configurada pelos Serviços de Mídia.		 Edm.String URL usada para acessar arquivos de ativo.
BaseUri

Somente leitura. Configurada pelos Serviços de Mídia.		 Edm.String Parte do localizador que fornece as informações de contêiner/serviço/armazenamento sobre o ativo (por exemplo, nome http://someservice.cloudapp.netdo host DNS )
ContentAccessComponent

Somente leitura. Configurada pelos Serviços de Mídia.		 Edm.String Parte de uma URI necessária para acessar o conteúdo. O local desse token na URL de mídia final depende do tipo de localizador, do tipo de mídia e do serviço de streaming.
AccessPolicyId

Somente leitura. Configurada pelos Serviços de Mídia.		 Edm.String A ID do AccessPolicy que define as permissões e a duração da URL do Localizador.

A permissão Lista não deve ser usada ao criar localizadores OnDemandOrigin.
AssetId

Somente leitura. Configurada pelos Serviços de Mídia.		 Edm.String A ID do Ativo que contém o conteúdo ao qual você deseja fornecer acesso.
StartTime

Opcional.		 Edm.DateTime A data e hora em que o localizador estará disponível para uso do cliente. Ponta: Se precisar carregar seus arquivos imediatamente, defina o valor de StartTime como cinco minutos antes da hora atual. Isso ocorre porque pode haver uma defasagem horária entre o computador do cliente e os serviços de mídia. Além disso, o valor de StartTime deve estar no seguinte formato DateTime: YYYY-MM-DDTHH:mm:ssZ (por exemplo, "2014-05-23T17:53:50Z").
AssetPolicy

Somente leitura. Configurada pelos Serviços de Mídia.		 Conjunto de entidades de AssetPolicy Propriedade de navegação para uma instância de AccessPolicy.
Asset

Somente leitura. Configurada pelos Serviços de Mídia.		 Conjunto de entidades de Asset Propriedade de navegação para uma instância de ativo.

Criar um localizador

Os localizadores podem ser criados com uma solicitação POST HTTP.

Método URI da solicitação Versão de HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Locators> HTTP/1.1

Observação

As URLs dos localizadores SAS serão alteradas sempre que as chaves de armazenamento da conta de armazenamento associada forem atualizadas. Para obter mais informações, consulte How To: Update Media Services after Rolling Storage Access Keys

Solicitação de Exemplo

Para obter o mais recente x-ms-version:, consulte REST dos Serviços de Mídia.

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 obter mais informações, consulte Entregando ativos com a API REST dos Serviços de Mídia.

Listar localizadores

Os localizadores podem ser recuperados usando uma solicitação HTTP GET.

Método URI da solicitação Versão de HTTP
GET GET https://< accountname.restv2>.<location.media.azure.net/api/Locators> HTTP/1.1
Método URI da solicitação Versão de HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid') HTTP/1.1
Método URI da solicitação Versão de HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/Locators HTTP/1.1

Solicitação de Exemplo

Para obter o mais recente x-ms-version:, consulte REST dos Serviços de Mídia.

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

Atualizar um localizador

Os localizadores de Origem podem atualizados usando uma solicitação MERGE HTTP.

Método URI da solicitação Versão de HTTP
MESCLAR <https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid') HTTP/1.1

Solicitação de Exemplo

Para obter o mais recente x-ms-version:, consulte REST dos Serviços de Mídia.

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"}

Excluir um localizador

Os localizadores podem ser excluídos usando uma solicitação DELETE HTTP.

Método URI da solicitação Versão de HTTP
Delete (excluir) <https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid') HTTP/1.1

Solicitação de Exemplo

Para obter o mais recente x-ms-version:, consulte REST dos Serviços de Mídia.

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 Também

Fornecendo ativos com a API REST dos Serviços de Mídia
ContentKey
Ativo
AccessPolicy
AssetFile
JobTemplate
Trabalho
MediaProcessor
Tarefa
TaskTemplate
Cotas e limitações