Sdílet prostřednictvím

Lokátor

  • Článek

Locator poskytuje vstupní bod pro přístup k souborům obsaženým v prostředku. AccessPolicy slouží k definování oprávnění a doby trvání, po které má klient přístup k danému prostředku. Lokátory mohou mít vztah M:1 s AccessPolicy, takže různé lokátory mohou poskytovat různé časy spuštění a typy připojení různým klientům, zatímco všichni používají stejné nastavení oprávnění a doby trvání. Kvůli omezení zásad sdíleného přístupu nastavených službami Úložiště Azure však nemůžete mít k danému prostředku najednou přidružených více než pět jedinečných lokátorů. Další informace najdete v tématu Použití sdíleného přístupového podpisu (ROZHRANÍ REST API).

Často potřebujete transformovat Locator identifikátor URI, abyste získali přístup k různým formátům souborů. Například vlastnost lokátoru Path SAS poskytuje přístup ke kontejneru. Pokud chcete získat přístup k souborům, musíte název souboru vložit mezi hostitele a podpis SAS. Při práci s lokátory OnDemandOrigin není vlastnost užitečná, Path dokud se do ní nepřidá část specifická pro protokol.

Následující pravidla určují, kdy lze lokátor vytvořit a aktualizovat:

  1. Lokátory URL přístupového podpisu (SAS) používané s AccessPolicies, které definují oprávnění ke čtení, a také lokátory původu, nelze vytvořit, dokud se soubory nenahrají do prostředku. Lokátory ADRES URL SAS, které se používají ke stahování nebo nahrávání souborů, se dají vytvořit před nahráním souborů jenom v případě, že se používají s AccessPolicies, které určují oprávnění k zápisu.

  2. Lokátor ADRESY URL SAS nelze po vytvoření aktualizovat. Jiné typy lokátorů, například lokátory původu, však lze aktualizovat pomocí nových hodnot StartTime.

  3. Adresy URL lokátorů SAS se změní při každé aktualizaci klíčů úložiště přidruženého účtu úložiště. Další informace najdete v tématu Postupy: Aktualizace služby Media Services po vrácení přístupových klíčů k úložišti.

  4. Po vytvoření lokátoru do může docházet k 30 až 40sekundové prodlevě, kdy je k dispozici pro použití. Tento problém se týká adresy URL SAS i lokátorů OnDemandOrigin.

Poznámka

Lokátory nejsou určené ke správě řízení přístupu jednotlivých uživatelů. Pokud chcete konkrétním uživatelům poskytnout různá přístupová práva, použijte řešení pro správu digitálních práv (DRM).

Tento článek poskytuje přehled Locator entity a také ukazuje, jak provádět různé operace pomocí rozhraní REST API služby Media Services.

Důležité

Při přístupu k entitám ve službě Media Services musíte v požadavcích HTTP nastavit specifická pole hlaviček a hodnoty.
Další informace najdete v tématu Nastavení pro vývoj rozhraní REST API služby Media Services a připojení ke službě Media Services pomocí rozhraní REST API služby Media Services.

Vlastnosti entity lokátoru

Vlastnost Typ Description
Id

Nepovinný parametr. Po vytvoření entity není možné aktualizovat.		 Edm.String Jedinečný identifikátor nastavený službou Media Services.
Name

Nepovinný parametr.		 Edm.String Název lokátoru. Maximální délka je 4000.
ExpirationDateTime

Jen pro zápis. Pomocí požadavku SLOUČIT HTTP aktualizujte hodnotu ExpirationDateTime.		 Edm.DateTime Hodnota (reprezentovaná v milisekundách od půlnoci 1. ledna 1970), kdy již lokátor nelze použít pro přístup k zadanému prostředku.

Hodnota ExpirationDateTime musí být v následujícím formátu DateTime: YYYY-MM-DDTHH:mm:ssZ (například 2014-05-23T17:53:50Z).
Type

Povinná hodnota. Po vytvoření entity není možné aktualizovat.		 Edm.Int32 Hodnota výčtu, která popisuje typ lokátoru. Platné hodnoty jsou:

- None = 0: Toto je výchozí hodnota výčtu. Tento typ nebude mít žádný platný lokátor.
- SAS = 1: Určuje typ lokátoru sdíleného přístupového podpisu (SAS)
- OnDemandOrigin = 2: Určuje typ lokátoru, který odkazuje na koncový bod původu služby Azure Media Service na vyžádání.
Path

Jen pro čtení. Nastaveno službou Media Services.		 Edm.String Adresa URL používaná pro přístup k souborům prostředků.
BaseUri

Jen pro čtení. Nastaveno službou Media Services.		 Edm.String Součást lokátoru, který poskytuje informace o úložišti, službě nebo kontejneru prostředku. (například Název http://someservice.cloudapp.nethostitele DNS )
ContentAccessComponent

Jen pro čtení. Nastaveno službou Media Services.		 Edm.String Část identifikátoru URI potřebné pro přístup k obsahu. Umístění tohoto tokenu v koncové adrese URL média závisí na typu lokátoru, typu média a službě streamování.
AccessPolicyId

Jen pro čtení. Nastaveno službou Media Services.		 Edm.String ID AccessPolicy, které definuje oprávnění a dobu trvání adresy URL lokátoru.

Oprávnění Seznam by se nemělo používat při vytváření lokátorů OnDemandOrigin.
AssetId

Jen pro čtení. Nastaveno službou Media Services.		 Edm.String ID prostředku obsahujícího obsah, ke kterému chcete poskytnout přístup.
StartTime

Nepovinný parametr.		 Edm.DateTime Datum a čas, kdy bude lokátor k dispozici klientům. Tip: Pokud potřebujete nahrát soubory okamžitě, měli byste hodnotu StartTime nastavit na pět minut před aktuálním časem. Důvodem je to, že mezi klientským počítačem a službou Media Services může dojít k nerovnoměrné distribuci hodin. Hodnota StartTime musí být také v následujícím formátu DateTime: YYYY-MM-DDTHH:mm:ssZ (například 2014-05-23T17:53:50Z).
AssetPolicy

Jen pro čtení. Nastaveno službou Media Services.		 AssetPolicy sada entit Vlastnost navigace pro instanci AccessPolicy.
Asset

Jen pro čtení. Nastaveno službou Media Services.		 Asset sada entit Vlastnost navigace k instanci prostředku.

Vytvoření lokátoru

Lokátory je možné vytvořit pomocí požadavku POST HTTP.

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Locators> HTTP/1.1

Poznámka

Adresy URL lokátorů SAS se změní při každé aktualizaci klíčů úložiště přidruženého účtu úložiště. Další informace najdete v tématu Postupy: Aktualizace služby Media Services po vrácení přístupových klíčů k úložišti.

Ukázkový požadavek

Nejnovější verzi najdete v x-ms-version:tématu Rest služby 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}

Další informace najdete v tématu Doručování prostředků pomocí rozhraní REST API služby Media Services.

Lokátory seznamu

Lokátory je možné načíst pomocí požadavku GET HTTP.

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
GET GET https://< accountname.restv2>.<location.media.azure.net/api/Locators> HTTP/1.1
Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid') HTTP/1.1
Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/Locators HTTP/1.1

Ukázkový požadavek

Nejnovější verzi najdete v x-ms-version:tématu Rest služby 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

Aktualizace lokátoru

Lokátory původu je možné aktualizovat pomocí požadavku HTTP merge.

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
SLOUČIT <https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid') HTTP/1.1

Ukázkový požadavek

Nejnovější verzi najdete v x-ms-version:tématu Rest služby 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"}

Odstranění lokátoru

Lokátory je možné odstranit pomocí požadavku HTTP DELETE.

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
DELETE <https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid') HTTP/1.1

Ukázkový požadavek

Nejnovější verzi najdete v x-ms-version:tématu Rest služby 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

Viz také

Doručování prostředků pomocí rozhraní REST API služby Media Services
ContentKey
Prostředek
Zásady přístupu
AssetFile
Pracovní pozice
Úloha
MediaProcessor
Úkol
TaskTemplate
Kvóty a omezení