Condividi tramite

Locator

  • Articolo

Un'entità Locator fornisce un punto di accesso ai file contenuti in una risorsa. Un'entità AccessPolicy viene usata per definire le autorizzazioni e il periodo di tempo durante il quale un client ha accesso a un determinato asset. I localizzatori possono avere una relazione molti-a-uno con un criterio di accesso. In tal modo, localizzatori diversi possono fornire ore di inizio e tipi di connessione diversi a client diversi usando tutti le stesse impostazioni di autorizzazione e la stessa durata. Tuttavia, a causa di una restrizione per un criterio di accesso condiviso impostata dai servizi di archiviazione di Azure, a un determinato asset non possono essere associati più di cinque localizzatori univoci alla volta. Per altre informazioni, vedere Uso di una firma di accesso condiviso (API REST).

Per accedere a diversi formati di file, è spesso necessario trasformare l'URI di un'entità Locator. Ad esempio, la proprietà Path del localizzatore di firma di accesso condiviso consente di accedere al contenitore. Per accedere ai file, è necessario incorporare il nome file tra l'host e la firma di accesso condiviso. Quando si utilizzano localizzatori OnDemandOrigin, la Path proprietà non è utile finché non viene aggiunta una parte specifica del protocollo.

Le seguenti regole determinano quando un localizzatore può essere creato e aggiornato:

  1. I localizzatori di origine e i localizzatori URL di firma di accesso condiviso usati con criteri di accesso che definiscono le autorizzazioni di lettura non possono essere creati fino a quando i file non sono stati caricati in un asset. I localizzatori di URL di firma di accesso condiviso, usati per scaricare o caricare i file, possono essere creati prima del caricamento dei file solo se vengono usati con criteri di accesso che specificano le autorizzazioni di scrittura.

  2. Non è possibile aggiornare un localizzatore URL di firma di accesso condiviso dopo che è stato creato. È tuttavia possibile aggiornare altri tipi di localizzatori, come i localizzatori di origine, con nuovi valori di StartTime.

  3. Gli URL dei localizzatori di firma di accesso condiviso cambieranno ogni volta che le chiavi di archiviazione dell'account di archiviazione associato vengono aggiornate. Per altre informazioni, vedere Procedura: Aggiornare Servizi multimediali dopo la sequenza di chiavi di accesso all'archiviazione in sequenza

  4. Può verificarsi un ritardo di 30-40 secondi tra la creazione di un localizzatore e la relativa disponibilità per l'uso. Questo problema può verificarsi sia con i localizzatori URL di firma di accesso condiviso sia con i localizzatori OnDemandOrigin.

Nota

I localizzatori non sono progettati per gestire il controllo dell'accesso per utente. Per assegnare a singoli utenti diritti di accesso diversi, è possibile usare soluzioni DRM (Digital Rights Management).

Questo articolo offre una panoramica dell'entità e illustra anche come eseguire varie operazioni con l'API Locator REST di Servizi multimediali.

Importante

Quando si accede alle entità in Servizi multimediali, è necessario impostare valori e campi di intestazione specifici nelle richieste HTTP.
Per altre informazioni, vedere Configurazione per lo sviluppo di API REST di Servizi multimediali e connessione a Servizi multimediali con l'API REST di Servizi multimediali.

Proprietà dell'entità Locator

Proprietà Type Descrizione
Id

Facoltativa. Impossibile eseguire l'aggiornamento dopo la creazione dell'entità.		 Edm.String Identificatore univoco impostato da Servizi multimediali.
Name

Facoltativa.		 Edm.String Nome del localizzatore. La lunghezza massima è 4000.
ExpirationDateTime

Sola scrittura. Per aggiornare il valore ExpirationDateTime, usare una richiesta HTTP MERGE.		 Edm.DateTime Periodo di tempo, espresso in millisecondi dalla mezzanotte del 1° gennaio 1970, trascorso il quale il localizzatore non può più essere usato per accedere all'asset specificato.

L'oggetto ExpirationDateTime deve essere nel formato DateTime seguente: YYYY-MM-DDTHH:mm:ssZ ad esempio "2014-05-23T17:53:50Z").
Type

Obbligatorio. Impossibile eseguire l'aggiornamento dopo la creazione dell'entità.		 Edm.Int32 Valore di enumerazione che descrive il tipo di localizzatore. I valori validi sono:

- Nessuno = 0: si tratta del valore di enumerazione predefinito. Nessun localizzatore valido sarà di questo tipo
- SAS = 1: Specifica il tipo di localizzatore firma di accesso condiviso (Sas)
- OnDemandOrigin = 2: specifica un tipo di localizzatore, che fa riferimento a un endpoint di streaming di origine del servizio multimediale di Azure su richiesta
Path

Di sola lettura. Impostata da Servizi multimediali.		 Edm.String URL usato per accedere ai file di asset.
BaseUri

Di sola lettura. Impostata da Servizi multimediali.		 Edm.String Parte del localizzatore che fornice le informazioni dell'archivio, del servizio o del contenitore relative all'asset (ad esempio, nome http://someservice.cloudapp.nethost DNS )
ContentAccessComponent

Di sola lettura. Impostata da Servizi multimediali.		 Edm.String Parte dell'URI necessaria per accedere al contenuto. Il percorso di questo token nell'URL multimediale finale dipende dal tipo di localizzatore, dal tipo di supporto e dal servizio di streaming.
AccessPolicyId

Di sola lettura. Impostata da Servizi multimediali.		 Edm.String ID dell'oggetto AccessPolicy che definisce le autorizzazioni e la durata per l'URL del localizzatore.

L'autorizzazione List non deve essere usata durante la creazione di localizzatori OnDemandOrigin.
AssetId

Di sola lettura. Impostata da Servizi multimediali.		 Edm.String ID dell'asset che contiene il contenuto a cui si vuole fornire l'accesso.
StartTime

Facoltativa.		 Edm.DateTime Data e ora in cui il localizzatore sarà disponibile per l'uso da parte dei client. Mancia: Se è necessario caricare immediatamente i file, è necessario impostare il valore StartTime su cinque minuti prima dell'ora corrente. Potrebbe infatti essere presente una leggera differenza di orario tra il computer client e Servizi multimediali. Inoltre, il valore StartTime deve essere nel formato DateTime seguente: YYYY-MM-DDTHH:mm:ssZ ad esempio "2014-05-23T17:53:50Z").
AssetPolicy

Di sola lettura. Impostata da Servizi multimediali.		 Set di entità AssetPolicy Proprietà di navigazione verso un'istanza AccessPolicy.
Asset

Di sola lettura. Impostata da Servizi multimediali.		 Set di entità Asset Proprietà di navigazione verso un'istanza Asset.

Creare un'entità Locator

Le entità Locator possono essere create tramite una richiesta HTTP POST.

Metodo URI richiesta Versione HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Locators> HTTP/1.1

Nota

Gli URL dei localizzatori di firma di accesso condiviso cambieranno ogni volta che le chiavi di archiviazione dell'account di archiviazione associato vengono aggiornate. Per altre informazioni, vedere Procedura: Aggiornare Servizi multimediali dopo la distribuzione delle chiavi di accesso all'archiviazione

Richiesta di esempio

Per ottenere la versione più recente x-ms-version:, vedere Servizi multimediali REST.

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}

Per altre informazioni, vedere Distribuzione di asset con l'API REST di Servizi multimediali.

Elencare le entità Locator

Le entità Locator possono essere recuperate tramite una richiesta HTTP GET.

Metodo URI richiesta Versione HTTP
GET GET https://< accountname.restv2>.<location.media.azure.net/api/Locators> HTTP/1.1
Metodo URI richiesta Versione HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid') HTTP/1.1
Metodo URI richiesta Versione HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/Locators HTTP/1.1

Richiesta di esempio

Per ottenere la versione più recente x-ms-version:, vedere Servizi multimediali REST.

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

Aggiornare un'entità Locator

I localizzatori di origine possono essere aggiornati tramite una richiesta HTTP MERGE.

Metodo URI richiesta Versione HTTP
MERGE <https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid') HTTP/1.1

Richiesta di esempio

Per ottenere la versione più recente x-ms-version:, vedere Servizi multimediali REST.

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

Eliminare un'entità Locator

Le entità Locator possono essere eliminate tramite una richiesta HTTP DELETE.

Metodo URI richiesta Versione HTTP
DELETE <https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid') HTTP/1.1

Richiesta di esempio

Per ottenere la versione più recente x-ms-version:, vedere Servizi multimediali REST.

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

Vedere anche

Distribuzione di asset con l'API REST di Servizi multimediali
ContentKey
Asset
AccessPolicy
AssetFile
JobTemplate
Processo
MediaProcessor
Attività
TaskTemplate
Quote e limitazioni