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:
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.
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.
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)
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 |
|---|---|---|
IdOpcjonalny. Nie można zaktualizować po utworzeniu jednostki. |
Edm.String | Unikatowy identyfikator ustawiony przez usługę Media Services. |
NameOpcjonalny. |
Edm.String | Nazwa lokalizatora. Maksymalna długość to 4000. |
ExpirationDateTimeTylko 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"). |
TypeWymagane. 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 |
PathTylko do odczytu. Ustaw przez usługę Media Services. |
Edm.String | Adres URL używany do uzyskiwania dostępu do plików zasobów. |
BaseUriTylko 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 ) |
ContentAccessComponentTylko 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. |
AccessPolicyIdTylko 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. |
AssetIdTylko do odczytu. Ustaw przez usługę Media Services. |
Edm.String | Identyfikator elementu zawartości zawierającej zawartość, do której chcesz zapewnić dostęp. |
StartTimeOpcjonalny. |
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"). |
AssetPolicyTylko do odczytu. Ustaw przez usługę Media Services. |
AssetPolicy zestaw jednostek |
Właściwość nawigacji do wystąpienia programu AccessPolicy. |
AssetTylko 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