Localizador
Locator fornece um ponto de entrada para aceder aos ficheiros contidos num Recurso. Uma AccessPolicy é utilizada para definir as permissões e a duração a que um cliente tem acesso a um determinado Recurso. Os localizadores podem ter uma relação muitos-para-um com uma AccessPolicy, de modo a que diferentes Localizadores possam fornecer diferentes horas de início e tipos de ligação a diferentes clientes, ao mesmo tempo que utilizam as mesmas definições de permissão e duração; No entanto, devido a uma restrição de política de acesso partilhado definida pelos serviços de armazenamento do Azure, não pode ter mais de cinco Localizadores exclusivos associados a um determinado Recurso de uma só vez. Para obter mais informações, veja Utilizar uma Assinatura de Acesso Partilhado (API REST).
Muitas vezes, tem de transformar um Locator Uri para aceder a vários formatos de ficheiro. Por exemplo, a propriedade do Path localizador SAS dá acesso ao contentor. Para aceder aos ficheiros, tem de incorporar o nome de ficheiro entre o anfitrião e a assinatura SAS. Ao trabalhar com localizadores OnDemandOrigin, a Path propriedade não é útil até que a parte específica do protocolo seja adicionada à mesma.
As seguintes regras regem quando um Localizador pode ser criado e atualizado:
Os Localizadores de URL de Assinatura de Acesso (SAS) utilizados com AccessPolicies que definem permissões de leitura, bem como Localizadores de Origem, não podem ser criados até que os ficheiros tenham sido carregados para um Recurso.. Os Localizadores de URL de SAS, que são utilizados para transferir ou carregar ficheiros, só podem ser criados antes de os ficheiros serem carregados se forem utilizados com AccessPolicies que especifiquem permissões de escrita.
Não é possível atualizar um Localizador de URL de SAS depois de este ter sido criado; no entanto, outros tipos de Localizador, como os localizadores de origem, podem ser atualizados com novos valores StartTime.
Os URLs dos localizadores SAS serão alterados sempre que as chaves de armazenamento da conta de armazenamento associada forem atualizadas. Para obter mais informações, veja How To: Update Media Services after Rolling Storage Access Keys (Como: Atualizar os Serviços de Multimédia após As Chaves de Acesso ao Armazenamento Sem Interrupção)
Pode haver um atraso de 30 a 40 segundos após a criação de um Localizador para quando está disponível para utilização. Este problema aplica-se tanto ao URL de SAS como aos localizadores OnDemandOrigin.
Nota
Os localizadores não foram concebidos para gerir o controlo de acesso por utilizador. Para conceder direitos de acesso diferentes a utilizadores individuais, utilize soluções de Gestão de Direitos Digitais (Digital Rights Management, DRM).
Este artigo fornece uma descrição geral da Locator entidade e também demonstra como executar várias operações com a API REST dos Serviços de Multimédia.
Importante
Ao aceder a entidades nos Serviços de Multimédia, tem de definir campos e valores de cabeçalho específicos nos seus pedidos HTTP.
Para obter mais informações, veja Setup for Media Services REST API Development and Connecting to Media Services with the Media Services REST API (Configurar o Desenvolvimento da API REST dos Serviços de Multimédia e Ligar aos Serviços de Multimédia com a API REST dos Serviços de Multimédia).
Propriedades da Entidade do Localizador
| Propriedade | Tipo | Description |
|---|---|---|
IdOpcional. Não é possível atualizar após a criação da entidade. |
Edm.String | Identificador exclusivo definido pelos Serviços de Multimédia. |
NameOpcional. |
Edm.String | O nome do localizador. O comprimento máximo é 4000. |
ExpirationDateTimeSó de escrita. Utilize um pedido HTTP MERGE para atualizar o valor ExpirationDateTime. |
Edm.DateTime | O valor (representado em milissegundos desde a meia-noite de 1 de janeiro de 1970) quando o localizador já não pode ser utilizado para aceder ao recurso especificado. ExpirationDateTime tem de estar no seguinte formato DateTime: YYYY-MM-DDTHH:mm:ssZ (por exemplo, "2014-05-23T17:53:50Z"). |
TypeObrigatório. Não é possível atualizar após a criação da entidade. |
Edm.Int32 | Valor de enumeração que descreve o tipo de Localizador. Os valores válidos são: - None = 0: este é o valor de enumeração predefinido. Nenhum localizador válido terá este tipo - SAS = 1: Especifica o tipo de localizador Assinatura de Acesso Partilhado (Sas) - OnDemandOrigin = 2: especifica um tipo de localizador, que se refere a um ponto final de transmissão em fluxo de Origem a Pedido do Serviço de Multimédia do Azure |
PathSó de leitura. Definido pelos Serviços de Multimédia. |
Edm.String | URL utilizado para aceder a Ficheiros de recursos. |
BaseUriSó de leitura. Definido pelos Serviços de Multimédia. |
Edm.String | Parte do localizador que fornece as informações de arquivo/serviço/contentor sobre o recurso. (por exemplo, Nome http://someservice.cloudapp.netdo anfitrião Dns ) |
ContentAccessComponentSó de leitura. Definido pelos Serviços de Multimédia. |
Edm.String | Parte do URI necessário para aceder ao conteúdo. A localização deste token no URL de multimédia final depende do tipo de localizador, do tipo de suporte de dados e do serviço de transmissão em fluxo. |
AccessPolicyIdSó de leitura. Definido pelos Serviços de Multimédia. |
Edm.String | O ID da AccessPolicy que define as permissões e a duração do URL do Localizador. A permissão Lista não deve ser utilizada ao criar localizadores OnDemandOrigin. |
AssetIdSó de leitura. Definido pelos Serviços de Multimédia. |
Edm.String | O ID do Recurso que contém o conteúdo ao qual pretende conceder acesso. |
StartTimeOpcional. |
Edm.DateTime | A data e hora em que o seu localizador estará disponível para os clientes utilizarem.
Sugestão: Se precisar de carregar os ficheiros imediatamente, deve definir o valor StartTime para cinco minutos antes da hora atual. Isto acontece porque pode haver distorção de relógio entre o computador cliente e os Serviços de Multimédia. Além disso, o valor StartTime tem de estar no seguinte formato DateTime: YYYY-MM-DDTHH:mm:ssZ (por exemplo, "2014-05-23T17:53:50Z"). |
AssetPolicySó de leitura. Definido pelos Serviços de Multimédia. |
AssetPolicy conjunto de entidades |
Propriedade de navegação para uma instância do AccessPolicy. |
AssetSó de leitura. Definido pelos Serviços de Multimédia. |
Asset conjunto de entidades |
Propriedade de navegação para uma instância de Recurso. |
Criar um Localizador
Os localizadores podem ser criados com um pedido HTTP POST.
| Método | URI do pedido | Versão HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/Locators> | HTTP/1.1 |
Nota
Os URLs dos localizadores SAS serão alterados sempre que as chaves de armazenamento da conta de armazenamento associada forem atualizadas. Para obter mais informações, veja How To: Update Media Services after Rolling Storage Access Keys (Como: Atualizar os Serviços de Multimédia após As Chaves de Acesso ao Armazenamento Sem Interrupção)
Pedido de Amostra
Para obter a versão mais recente x-ms-version:, consulte REST dos Serviços de Multimé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, veja Entregar Recursos com a API REST dos Serviços de Multimédia.
Listar Localizadores
Os localizadores podem ser obtidos com um pedido GET HTTP.
| Método | URI do pedido | Versão HTTP |
|---|---|---|
| GET | GET https://< accountname.restv2>.<location.media.azure.net/api/Locators> | HTTP/1.1 |
| Método | URI do pedido | Versão HTTP |
|---|---|---|
| GET | <https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid') | HTTP/1.1 |
| Método | URI do pedido | Versão HTTP |
|---|---|---|
| GET | <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/Locators | HTTP/1.1 |
Pedido de Amostra
Para obter a versão mais recente x-ms-version:, consulte REST dos Serviços de Multimé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 ser atualizados com um pedido HTTP MERGE.
| Método | URI do pedido | Versão HTTP |
|---|---|---|
| INTERCALAR | <https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid') | HTTP/1.1 |
Pedido de Amostra
Para obter a versão mais recente x-ms-version:, consulte REST dos Serviços de Multimé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"}
Eliminar um Localizador
Os localizadores podem ser eliminados através de um pedido HTTP DELETE.
| Método | URI do pedido | Versão HTTP |
|---|---|---|
| DELETE | <https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid') | HTTP/1.1 |
Pedido de Amostra
Para obter a versão mais recente x-ms-version:, consulte REST dos Serviços de Multimé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
Fornecer Recursos com a API REST dos Serviços de Multimédia
ContentKey
Recurso
AccessPolicy
AssetFile
JobTemplate
Tarefa
MediaProcessor
Tarefa
TaskTemplate
Quotas e Limitações