Экспорт (0) Печать
Развернуть все

Локатор

Обновлено: Февраль 2015 г.

Locator предоставляет точку входа для доступа к файлам, содержащимся в активе. AccessPolicy используется для определения разрешений и длительности доступа клиента к определенному ресурсу. Локаторы могут иметь множество или одну связь с AccessPolicy таким образом, чтобы разные локаторы могли обеспечивать разное время запуска и типы подключения к различным клиентам с использованием одних параметров разрешения и продолжительности. Однако из-за ограничений общей политики доступа, установленных службами хранилища Azure, нельзя одновременно связать с определенным ресурсом более пяти локаторов. Дополнительные сведения см. в разделе Подпись общего доступа (REST API).

Часто необходимо преобразовать URI Locator с целью доступа к различным форматам файла. Например, свойство Path локатора SAS предоставляет доступ к контейнеру. Для доступа к файлам необходимо встроить имя файла между узлом и подписью SAS. При работе с локаторами OnDemandOrigin свойство Path не представляет пользы, пока не будет добавлена часть, специфичная для протокола.

Создание и обновление локатора определяются следующими правилами:

  1. Локаторы URL-адреса подписи доступа (SAS), используемые с политиками AccessPolicy, которые определяют разрешения на чтение, а также локаторы источника, нельзя использовать, пока файлы не будут переданы в ресурс. Локаторы URL-адреса SAS, которые используются для загрузки или передачи файлов, можно создавать до передачи файлов, только если они используются с политиками AccessPolicy, которые указывают разрешения на запись.

  2. Нельзя обновлять локаторы URL-адреса SAS после создания. Однако, другие типы локаторов, например, локатор источника, можно обновлять значениями StartTime.

  3. До возможности использования после создания локатора может возникнуть задержка на 30-40 секунд. Эта проблема возникает как для локаторов URL-адресов SAS, так и для OnDemandOrigin.

noteПримечание
Локаторы не предназначены для управления доступом отдельных пользователей. Для предоставления различных прав доступа отдельным пользователям используйте решения управления цифровыми правами (DRM).

В данном разделе приводится описание сущности Locator и демонстрируется выполнение различных операций с API REST служб мультимедиа.

ImportantВажно!
При работе с API REST служб мультимедиа учитывайте следующее.

  • При доступе к сущностям в Службы Media Services следует задавать в HTTP-запросах определенные поля и значения заголовков. Дополнительные сведения см. в Setup for Media Services REST API Development.

  • После успешного подключения к https://media.windows.net будет получено перенаправление 301, указывающее другой URI служб Media Services. Последующие обращения к новому URI.

    Дополнительные сведения см. в Connecting to Media Services with the Media Services REST API.

 

Свойство Type Описание

Id

Необязательно. Нельзя обновить после создания сущности.

Edm.String

Уникальный идентификатор, установленный Службы Media Services.

Name

Необязательно.

Edm.String

Название локатора. Максимальная длина составляет 4000 символов.

ExpirationDateTime

Только для записи. Для обновления значения ExpirationDateTime используйте HTTP-запрос MERGE.

Edm.DateTime

Значение (представляющее собой число в миллисекундах с полуночи 1 января 1970 года), когда локатор нельзя больше использовать для доступа к указанному ресурсу.

Параметр ExpirationDateTime должен быть указан в следующем формате DateTime: YYYY-MM-DDTHH:mm:ssZ (например, "2014-05-23T17:53:50Z").

Type

Обязательно. Нельзя обновить после создания сущности.

Edm.Int32

Значение перечисления, которое описывает тип локатора. Допустимые значения:

  • Нет = 0 : Это значение перечисления по умолчанию. У допустимых локаторов не будет такого типа

  • SAS = 1 : Указывает тип локатора подписи общего доступа (SAS)

  • OnDemandOrigin = 2 : Указывает тип локатора, который ссылается на конечную точку потоковой передачи данных источника по запросу Azure Media Service.

Path

Только для чтения. Задается Службы Media Services.

Edm.String

URL-адрес, используемый для доступа к ресурсным файлам.

BaseUri

Только для чтения. Задается Службы Media Services.

Edm.String

Часть локатора, которая предоставляет сведения о хранилище/службе/контейнере ресурса. (например, имя узла DNS http://someservice.cloudapp.net)

ContentAccessComponent

Только для чтения. Задается Службы Media Services.

Edm.String

Часть URI, необходимая для доступа к содержимому. Местоположение этого токена в последнем URL-адресе мультимедиа зависит от типа локатора, типа носителя и службы потоковой передачи данных.

AccessPolicyId

Только для чтения. Задается Службы Media Services.

Edm.String

Идентификатор AccessPolicy, который определяет разрешения и продолжительность для URL-адреса локатора.

Обратите внимание, что разрешение на перечисление не следует использовать при создании указателей OnDemandOrigin.

AssetId

Только для чтения. Задается Службы Media Services.

Edm.String

Идентификатор ресурса с содержимым, к которому требуется обеспечить доступ.

StartTime

Необязательно.

Edm.DateTime

Дата и время, когда локатор станет доступен для использования клиентами.

TipСовет
Если необходимо передать файлы немедленно, установите значение StartTime на пять минут до текущего времени. Это необходимо потому, что между компьютером клиента и Службы Media Services может существовать рассинхронизация часов. Также значение StartTime должно быть указано в следующем формате DateTime: YYYY-MM-DDTHH:mm:ssZ (например, "2014-05-23T17:53:50Z").

AssetPolicy

Только для чтения. Задается Службы Media Services.

Набор объектов AssetPolicy

Свойство навигации для экземпляра AccessPolicy.

Asset

Только для чтения. Задается Службы Media Services.

Набор объектов Asset

Свойство навигации для экземпляра ресурса.

Локаторы могут быть созданы с помощью HTTP-запроса POST.

 

Метод URI запроса Версия HTTP

POST

https://media.windows.net/API/Locators

HTTP/1.1

ImportantВажно!
После успешного подключения к https://media.windows.net будет получено перенаправление 301, указывающее другой URI служб Media Services. Последующие обращения к новому URI.

POST https://media.windows.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.7
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=youraccountname&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1337212980&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=kK7PbPM3lTAEJYIx5OTWeaSY7zvia358UjPiuvSFHz0%3d
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}

Дополнительные сведения см. в Доставка ресурсов с помощью API REST служб мультимедиа.

Локаторы можно получить с помощью HTTP-запроса GET.

 

Метод URI запроса Версия HTTP

GET

GET https://media.windows.net/API/Locators

HTTP/1.1

 

Метод URI запроса Версия HTTP

GET

https://media.windows.net/API/Locators('locatorid')

HTTP/1.1

 

Метод URI запроса Версия HTTP

GET

https://media.windows.net/API/Assets('assetid')/Locators

HTTP/1.1

ImportantВажно!
После успешного подключения к https://media.windows.net будет получено перенаправление 301, указывающее другой URI служб Media Services. Последующие обращения к новому URI.

GET https://media.windows.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.7
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=youraccountname&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1337219077&Issuer=https%3a%2f%2fnimbustestaccounts.accesscontrol.windows.net%2f&HMACSHA256=JSeCQMLMDLIm%2fFD%2b8qJL52dShVNGdwg1aqB%2b3GLlq5I%3d
Host: media.windows.net

Исходные локаторы можно обновить с помощью HTTP-запроса MERGE.

 

Метод URI запроса Версия HTTP

MERGE

https://media.windows.net/API/Locators('locatorid')

HTTP/1.1

ImportantВажно!
После успешного подключения к https://media.windows.net будет получено перенаправление 301, указывающее другой URI служб Media Services. Последующие обращения к новому URI.

MERGE https://media.windows.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.7
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=youraccountname&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1337219313&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=iULfw27Jo4TIBljQr8MDMDh2TX6YZBShgvY9yblaqKU%3d
Host: media.windows.net
Content-Length: 38
Expect: 100-continue

{"StartTime" : "2014-05-17T16:45:53"}

Удалить локаторы можно с помощью HTTP-запроса DELETE.

 

Метод URI запроса Версия HTTP

DELETE

https://media.windows.net/API/Locators('locatorid')

HTTP/1.1

ImportantВажно!
После успешного подключения к https://media.windows.net будет получено перенаправление 301, указывающее другой URI служб Media Services. Последующие обращения к новому URI.

DELETE https://media.windows.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.7
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=youraccountname&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1337219313&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=iULfw27Jo4TIBljQr8MDMDh2TX6YZBShgvY9yblaqKU%3d
Host: media.windows.net
Content-Length: 0
Connection: Keep-Alive

См. также

Показ:
© 2015 Microsoft