Lokalizator

Locator zapewnia punkt wejścia umożliwiający dostęp do plików zawartych w zasobie. Element AccessPolicy służy do definiowania uprawnień i czasu trwania, do którego klient ma dostęp do danego zasobu. Lokalizatory mogą mieć wiele do jednej relacji z zasadami programu AccessPolicy, tak aby różne lokalizatory mogły zapewnić różne czasy rozpoczęcia i typy połączeń do różnych klientów, jednocześnie używając tych samych ustawień uprawnień i czasu trwania; jednak ze względu na ograniczenie zasad dostępu współdzielonego ustawione przez usługi Azure Storage nie można jednocześnie skojarzyć więcej niż pięciu unikatowych lokalizatorów skojarzonych z danym zasobem. Aby uzyskać więcej informacji, zobacz Używanie sygnatury dostępu współdzielonego (interfejs API REST).

Często należy przekształcić Locator identyfikator URI w celu uzyskania dostępu do różnych formatów plików. Na przykład właściwość lokalizatora sygnatur dostępu współdzielonego Path zapewnia dostęp do kontenera. Aby uzyskać dostęp do plików, należy osadzić nazwę pliku między hostem a sygnaturą sygnatury sygnatury dostępu współdzielonego. Podczas pracy z lokalizatorami Path OnDemandOrigin właściwość nie jest przydatna do momentu dodania do niego części specyficznej dla protokołu.

Następujące reguły określają, kiedy można utworzyć i zaktualizować lokalizator:

  1. Lokalizatory adresów URL sygnatury dostępu (SAS) używane z programem AccessPolicies definiujące uprawnienia do odczytu, a także lokalizatory źródeł, nie można utworzyć do momentu przekazania plików do zasobu. Lokalizatory adresów URL sygnatury dostępu współdzielonego, które są używane do pobierania lub przekazywania plików, można utworzyć przed przekazaniem plików tylko wtedy, gdy są one używane z programem AccessPolicies, które określają uprawnienia do zapisu.

  2. Nie można zaktualizować lokalizatora adresów URL sygnatury dostępu współdzielonego po jego utworzeniu; jednak inne typy lokalizatorów, takie jak lokalizatory pochodzenia, można zaktualizować przy użyciu nowych wartości StartTime.

  3. Adresy URL lokalizatorów sygnatur dostępu współdzielonego zmieniają się za każdym razem, gdy klucze magazynu skojarzonego konta magazynu zostaną zaktualizowane. Aby uzyskać więcej informacji, zobacz How To: Update Media Services after Rolling Storage Access Keys (Instrukcje: aktualizowanie usługi Media Services po rolowaniu kluczy dostępu do magazynu)

  4. Po utworzeniu lokalizatora może wystąpić opóźnienie 30–40 sekund po udostępnieniu go do użycia. Ten problem dotyczy zarówno adresu URL sygnatury dostępu współdzielonego, jak i lokalizatorów OnDemandOrigin.

Uwaga

Lokalizatory nie są przeznaczone do zarządzania kontrolą dostępu poszczególnych użytkowników. Aby nadać różne uprawnienia poszczególnym użytkownikom, użyj rozwiązań do zarządzania prawami cyfrowymi (DRM, Digital Rights Management).

Ten artykuł zawiera omówienie Locator jednostki, a także pokazuje, jak wykonywać różne operacje za pomocą interfejsu API REST usługi Media Services.

Ważne

Podczas uzyskiwania dostępu do jednostek w usłudze Media Services należy ustawić określone pola nagłówka i wartości w żądaniach HTTP.
Aby uzyskać więcej informacji, zobacz Konfigurowanie tworzenia interfejsu API REST usługi Media Services i nawiązywanie połączenia z usługą Media Services przy użyciu interfejsu API REST usługi Media Services.

Właściwości jednostki lokalizatora

Właściwość Typ Opis
Id

Opcjonalny. Nie można zaktualizować po utworzeniu jednostki.
Edm.String Unikatowy identyfikator ustawiony przez usługę Media Services.
Name

Opcjonalny.
Edm.String Nazwa lokalizatora. Maksymalna długość to 4000.
ExpirationDateTime

Tylko zapis. Użyj żądania HTTP MERGE, aby zaktualizować wartość ExpirationDateTime.
Edm.DateTime Wartość (reprezentowana w milisekundach od północy 1 stycznia 1970 r.), gdy lokalizator nie może być już używany do uzyskiwania dostępu do określonego zasobu.

Funkcja ExpirationDateTime musi mieć następujący format DateTime: YYYY-MM-DDTHH:mm:ssZ (na przykład "2014-05-23T17:53:50Z").
Type

Wymagane. Nie można zaktualizować po utworzeniu jednostki.
Edm.Int32 Wartość wyliczenia, która opisuje typ lokalizatora. Prawidłowe wartości:

- None = 0: Jest to domyślna wartość wyliczenia. Ten typ nie będzie miał prawidłowego lokalizatora
- SAS = 1: Określa typ lokalizatora sygnatury dostępu współdzielonego (Sas)
- OnDemandOrigin = 2: Określa typ lokalizatora, który odwołuje się do punktu końcowego przesyłania strumieniowego źródła na żądanie usługi Azure Media Service
Path

Tylko do odczytu. Ustaw przez usługę Media Services.
Edm.String Adres URL używany do uzyskiwania dostępu do plików zasobów.
BaseUri

Tylko do odczytu. Ustaw przez usługę Media Services.
Edm.String Część lokalizatora, która udostępnia informacje o magazynie/usłudze/kontenerze o zasobie. (na przykład nazwa http://someservice.cloudapp.nethosta DNS )
ContentAccessComponent

Tylko do odczytu. Ustaw przez usługę Media Services.
Edm.String Część identyfikatora URI potrzebnego do uzyskania dostępu do zawartości. Lokalizacja tego tokenu w ostatnim adresie URL nośnika zależy od typu lokalizatora, typu nośnika i usługi przesyłania strumieniowego.
AccessPolicyId

Tylko do odczytu. Ustaw przez usługę Media Services.
Edm.String Identyfikator obiektu AccessPolicy definiujący uprawnienia i czas trwania adresu URL lokalizatora.

Uprawnienie Lista nie powinno być używane podczas tworzenia lokalizatorów OnDemandOrigin.
AssetId

Tylko do odczytu. Ustaw przez usługę Media Services.
Edm.String Identyfikator elementu zawartości zawierającej zawartość, do której chcesz zapewnić dostęp.
StartTime

Opcjonalny.
Edm.DateTime Data i godzina, kiedy lokalizator będzie dostępny dla klientów do użycia. Wskazówka: Jeśli musisz natychmiast przekazać pliki, należy ustawić wartość StartTime na pięć minut przed bieżącą godziną. Dzieje się tak, ponieważ może istnieć niesymetryczność zegara między komputerem klienckim a usługą Media Services. Ponadto wartość Godzina rozpoczęcia musi mieć następujący format DateTime: YYYY-MM-DDTHH:mm:ssZ (na przykład "2014-05-23T17:53:50Z").
AssetPolicy

Tylko do odczytu. Ustaw przez usługę Media Services.
AssetPolicy zestaw jednostek Właściwość nawigacji do wystąpienia programu AccessPolicy.
Asset

Tylko do odczytu. Ustaw przez usługę Media Services.
Asset zestaw jednostek Właściwość nawigacji do wystąpienia zasobu.

Tworzenie lokalizatora

Lokalizatory można utworzyć za pomocą żądania HTTP POST.

Metoda Identyfikator URI żądania Wersja protokołu HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Locators> HTTP/1.1

Uwaga

Adresy URL lokalizatorów sygnatur dostępu współdzielonego zmieniają się za każdym razem, gdy klucze magazynu skojarzonego konta magazynu zostaną zaktualizowane. Aby uzyskać więcej informacji, zobacz How To: Update Media Services after Rolling Storage Access Keys (Instrukcje: aktualizowanie usługi Media Services po rolowaniu kluczy dostępu do magazynu)

Przykładowe żądanie

Aby uzyskać najnowszą wersję x-ms-version:, zobacz Media Services 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}  

Aby uzyskać więcej informacji, zobacz Dostarczanie zasobów za pomocą interfejsu API REST usługi Media Services.

Lokalizatory list

Lokalizatory można pobrać przy użyciu żądania HTTP GET.

Metoda Identyfikator URI żądania Wersja protokołu HTTP
GET GET https://< accountname.restv2>.<location.media.azure.net/api/Locators> HTTP/1.1
Metoda Identyfikator URI żądania Wersja protokołu HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid') HTTP/1.1
Metoda Identyfikator URI żądania Wersja protokołu HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/Lokalizatory HTTP/1.1

Przykładowe żądanie

Aby uzyskać najnowszą wersję x-ms-version:, zobacz Media Services 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  

Aktualizowanie lokalizatora

Lokalizatory pochodzenia można zaktualizować przy użyciu żądania HTTP SCALANIA.

Metoda Identyfikator URI żądania Wersja protokołu HTTP
SCALANIA <https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid') HTTP/1.1

Przykładowe żądanie

Aby uzyskać najnowszą wersję x-ms-version:, zobacz Media Services 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"}  

Usuwanie lokalizatora

Lokalizatory można usunąć przy użyciu żądania HTTP DELETE.

Metoda Identyfikator URI żądania Wersja protokołu HTTP
DELETE <https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid') HTTP/1.1

Przykładowe żądanie

Aby uzyskać najnowszą wersję x-ms-version:, zobacz Media Services 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  

Zobacz też

Dostarczanie zasobów za pomocą interfejsu API REST usługi Media Services
ContentKey
Zasób
AccessPolicy
AssetFile
JobTemplate
Zadanie
MediaProcessor
Zadanie
TaskTemplate
Limity przydziału i ograniczenia