StreamingEndpoint

Сущность StreamingEndpoint представляет собой службу потоковой передачи, способную доставить контент непосредственно в приложение проигрывателя клиента или в сеть доставки содержимого (CDN) для дальнейшего распределения. Начиная с версии 2.9, Cлужбы мультимедиа Microsoft Azure обеспечивает интеграцию Azure CDN (дополнительные сведения см. в описании CdnEnabled свойства ниже). Исходящий поток из службы StreamingEndpoint может быть потоковой трансляцией или ресурсом видео по запросу в учетной записи Служб мультимедиа.

Каждая учетная запись Служб мультимедиа Azure (AMS) включает streamingEndpoint по умолчанию; в учетной записи можно создать дополнительные точки StreamingEndpoints. Начиная со Служб мультимедиа версии 2.15 (выпущена 10 января 2017 г.) доступно две версии StreamingEndpoint: 1.0 и 2.0. Кроме того, существует три типа потоковых точек: Классическая, **Стандартная или Премиум.

Учетные записи служб мультимедиа, созданные до обновления AMS REST 2.15, по умолчанию включают классические конечные точки потоковой передачи версии 1.0. Вы можете выполнить обновление до версии 2.0, перейти на более раннюю версию до версии 1.0. Учетные записи AMS, созданные после обновления 2.15, по умолчанию включают стандартные конечные точки потоковой передачи версии 2.0. В конечных точках потоковой передачи версии 2.0 внесены изменения в функции и выставление счетов. Дополнительные сведения см. в описании StreamingEndpointVersion свойства, описанного ниже.

Автоматически подготовленная streamingEndpoint имеет имя Default и не может быть удалена. Состояние StreamingEndpoint — Остановлено. Чтобы начать потоковую передачу, необходимо запустить конечную точку потоковой передачи.

Если вы создали учетную запись с помощью классического портала Azure и в регионе доступна сеть Доставки содержимого Azure, она будет иметь интеграцию CDN по умолчанию ("CdnEnabled":true, "CdnProvider":StandardVerizon и "CdnProfile":AzureMediaStreamingPlatformCdnProfile).

В большинстве случаев следует оставить CDN включенным. Тем не менее, если вы ожидаете максимального уровня параллелизма меньше 500 зрителей, рекомендуется отключить сеть CDN, так как она лучше масштабируется при высоком параллелизме.

Обзор конечных точек потоковой передачи "Классический", "Стандартный" и "Премиум"

Дополнительные функции, описанные в этом разделе, включают динамическую упаковку и динамическое шифрование.

В таблице указаны сводные данные поведения:

Тип	Версия	Единицы масштабирования	Дополнительные функции	CDN	Выставление счетов
Классический	1,0	0	Н/Д	Н/Д	Бесплатный
Конечная точка потоковой передачи типа "Стандартный" (рекомендуется)	2.0	0	Да	Да	Платный
Конечная точка потоковой передачи типа "Премиум"	1,0	>0	Да	Да	Платный
Конечная точка потоковой передачи типа "Премиум"	2.0	>0	Да	Да	Платный

Рекомендуется обновить классические конечные точки потоковой передачи до стандартных конечных точек потоковой передачи, чтобы повысить удобство работы и дополнительные функции. Стандартная потоковая передача также автоматически масштабирует исходящую пропускную способность.

Тип Стандартный является рекомендуемым вариантом практически для всех сценариев потоковой передачи и размеров аудитории. Для клиентов с чрезвычайно высокими требованиями AMS также предлагает конечные точки потоковой передачи уровня "Премиум ", которые можно использовать для масштабирования емкости для крупнейших интернет-аудиторий. Если вам нужны большие аудитории и параллельные зрители, свяжитесь с нами, чтобы получить рекомендации по переходу на тип Premium . Хороший пост руководства заключается в том, чтобы связаться с нами (amsstreaming на microsoft.com), если вы ожидаете одновременный размер аудитории больше 50000 зрителей.

Вы переходите к типу Premium , изменяя единицы масштабирования. Единицы масштабирования предоставляют выделенную пропускную способность исходящего трафика, которую можно приобрести с шагом 200 Мбит/с. При использовании типа Премиум каждая включенная единица обеспечивает приложению дополнительную пропускную способность. Дополнительные сведения см. в разделе How to Scale StreamingEndpoint.

Дополнительные сведения см. в статье Общие сведения о конечных точках потоковой передачи.

Свойства и операции StreamingEndpoint

В этом разделе представлен обзор сущности StreamingEndpoint , а также показано, как выполнять различные операции с помощью REST API Служб мультимедиа.

• Создание конечной точки потоковой передачи

• Запуск конечной точки потоковой передачи

• Остановка конечных точек потоковой передачи

• Масштабирование конечных точек потоковой передачи

• Перечисление конечных точек потоковой передачи

• Обновление конечных точек потоковой передачи

• Удаление конечных точек потоковой передачи

Сущность конечной точки потоковой передачи

Сущность StreamingEndpoint содержит следующие свойства:

Свойство	Тип	Описание
Id Только для чтения. Задается Media Services.	Edm.String	Идентификатор конечной точки потоковой передачи, назначенный при создании. Формат: nb:oid:UUID:<GUID>.
Name	Edm.String	Понятное имя конечной точки потоковой передачи. — Должен быть уникальным в пределах вашей учетной записи Служб мультимедиа. — Максимальная длина = 32 символа. — не может содержать пробелы. — дефисы и буквенно-цифровые символы. — не может начинаться или заканчиваться дефисом.
Description	Edm.String	Описание конечной точки потоковой передачи. Максимальная длина составляет 256 символов.
Created Только для чтения. Задается Media Services.	Edm.DateTime	Создано службой предварительной версии Cлужбы мультимедиа Microsoft Azure Live Streaming.
State Только для чтения. Задается Media Services.	Edm.Int32	Возможные значения для свойства: — Stopped. Начальное состояние конечной точки потоковой передачи после создания. — Starting. Конечная точка потоковой передачи переходит в рабочее состояние. — Running. Конечная точка потоковой передачи может выполнять потоковую передачу в адрес клиентов. — Scaling. Модули потоковой передачи (ScaleUnits) увеличиваются или уменьшаются. — Stopping. Конечная точка потоковой передачи переходит в состояние остановки.
HostName Только для чтения. Задается Media Services.	Edm.String	Имя узла конечной точки потоковой передачи по умолчанию.
LastModified Только для чтения. Задается Media Services.	Edm.DateTime	Время последнего обновления этой сущности.
ScaleUnits Только для чтения.	Edm.Int32	Количество конечных точек потоковой передачи уровня "Премиум", выделенных для развертывания StreamingEndpoint. Если конечная точка потоковой передачи находится в состоянии Running, количество модулей потоковой передачи в этой конечной точке можно увеличивать с помощью, вызвав операцию Scale. Это свойство также управляет типом конечной точки потоковой передачи с помощью сочетания версии конечной точки потоковой передачи. Если версия конечной точки потоковой передачи — 1.0 и ScaleUnits=0, конечная точка потоковой передачи имеет классический тип. Следующие свойства StreamingEndpoint можно настроить, только если конечная точка потоковой передачи является стандартной или премиальной: AccessControl, CustomHostNames, CacheControl, CrossSiteAccessPolicies.
CdnEnabled Это свойство было добавлено в службы мультимедиа 2.9.	Edm.Boolean	Указывает, включена или нет интеграция сети доставки содержимого Azure для этой сущности StreamingEndpoint (отключена по умолчанию). Чтобы задать CdnEnabled значение true, StreamingEndpoint должна иметь по крайней мере одну конечную точку потоковой передачи уровня "Премиум" (ScaleUnits) для StreamingEndpoint версии 1.0 и находиться в остановленном состоянии. Это свойство можно задать, если StreamingEndpoint версии 2.0 независимо от значения ScaleUnits (см. стандартную конечную точку потоковой передачи). Используйте REST API операции, чтобы проверка состояние. После включения следующие конфигурации будут отключены: CustomHostNames и AccessControl. Примечание. Не все центры обработки данных поддерживают интеграцию Azure CDN. Чтобы проверить, доступна ли интеграция Azure CDN для вашего центра обработки данных, сделайте следующее: — Попробуйте установить для параметра CdnEnabled значение true. — Проверьте возвращенный результат для HTTP Error Code 412 (PreconditionFailed) с сообщением "Свойство CdnEnabled конечной точки потоковой передачи не может быть установлено в значение true, так как возможность CDN недоступна в текущем регионе". Если вы получаете эту ошибку, данная интеграция не поддерживается в этом центре обработки данных. Попробуйте использовать другой центр обработки данных.
CdnProvider Это свойство было добавлено в Службы мультимедиа 2.15.	Edm.String	Если CDN включена ("CdnEnabled":true), можно также передать значения CdnProvider. CdnProvider определяет, какой поставщик будет использоваться. Сейчас поддерживаются три значения: StandardVerizon, PremiumVerizon и StandardAkamai. Если значение не указано и "CdnEnabled":true, используется "StandardVerizon" (это значение по умолчанию). Пример: "CdnProvider":"StandardAkamai". Примечание. StreamingEndpoints, которые являются "CDNEnabled":true с более ранними версиями AMS (<2.15), имеют устаревшую интеграцию CDN и используют поставщик CDN "StandardVerizon". Рекомендуется перенести StreamingEndpoints в более новую интеграцию CDN, чтобы улучшить взаимодействие и получить полную функцию.
CdnProfile Это свойство было добавлено в Службы мультимедиа 2.15.	Edm.String	Если сеть CDN включена ("CdnEnabled":true), вы также можете передать значения CdnProfile. CdnProfile — это имя профиля CDN, в котором будет создана точка конечной точки CDN. Вы можете предоставить существующий cdnProfile или использовать новый. Если значение равно NULL и "CdnEnabled":true, используется значение по умолчанию AzureMediaStreamingPlatformCdnProfile. Если предоставленный CdnProfile уже существует, в нем создается конечная точка. Если профиль отсутствует, он создается автоматически. Пример: "CdnProfile":"AzureMediaStreamingPlatformCdnProfile".
FreeTrialEndTime Только для чтения. Это свойство было добавлено в Службы мультимедиа 2.15.	Edm.DateTime	При создании учетной записи служб мультимедиа стандартная конечная точка потоковой передачи по умолчанию также автоматически подготавливается под учетной записью в остановленном состоянии. Эта конечная точка включает 15-дневный бесплатный пробный период, а пробный период начинается при первом запуске конечной точки. Бесплатная пробная версия не применяется к существующим учетным записям, и дата окончания не меняется при переходе состояния, например остановке или запуске. Бесплатная пробная версия запускается при первом запуске конечной точки потоковой передачи и заканчивается через 15 календарных дней. Бесплатная пробная версия применяется только к конечной точке потоковой передачи по умолчанию и не применяется к дополнительным конечным точкам потоковой передачи. Если конечная точка только что создана и находится в остановленном состоянии, для параметра FreeTrialEndTime устанавливается значение "0001-01-01T00:00:00Z". При запуске к дате начала добавляется 15 дней, а значение начинается с даты окончания бесплатной пробной версии "FreeTrialEndTime":"2016-12-16T18:01:47.8524725Z". Значения для конечных точек потоковой передачи, которые не могут использовать бесплатную пробную версию, всегда будут иметь значение "FreeTrialEndTime":"0001-01-01T00:00:00Z" независимо от состояния. Примеры: "FreeTrialEndTime":"2016-12-16T18:01:47.8524725Z" "FreeTrialEndTime":"0001-01-01T00:00:00Z"
StreamingEndpointVersion Это свойство было добавлено в Службы мультимедиа 2.15.	Edm.String	Сочетание StreamingEndpointVersion и ScaleUnits управляет типом конечной точки потоковой передачи. Любая конечная точка потоковой передачи, созданная до обновления 2.15 (10 января 2017 г.), будет иметь "StreamingEndpointVersion":"1.0", а конечные точки потоковой передачи, созданные после обновления, будут иметь "StreamingEndpointVersion":"2.0". Конечные точки потоковой передачи версии 1.0 не будут автоматически обновлены до версии 2.0, но могут быть явно обновлены до "StreamingEndpointVersion":"2.0". Конечные точки потоковой передачи с "ScaleUnits":0 и StreamingEndpointVersion:"1.0" будут считаться классическими конечными точками потоковой передачи, которые не имеют расширенных функций, таких как динамическая упаковка или динамическое шифрование. Конечные точки потоковой передачи с scaleUnits > 0 (независимо от того, установлена ли версия StreamingEndpointVersion 1.0 или 2.0) являются единицами уровня "Премиум ". Стандартные конечные точки потоковой передачи с "ScaleUnits":0 и StreamingEndpointVersion:"2.0" будут включать те же функции, что и единицы premium (включая динамическую упаковку и динамическое шифрование). Вы можете обновить классическую конечную точку потоковой передачи до стандартной , задав для версии значение StreamingEndpointVersion:"2.0". Это односторонняя операция; вы не можете понизить версию 2.0 до 1.0. Учтите, что для этой операции откат не предусмотрен, а ее выполнение связано с дополнительными расходами. Распространение этой новой конфигурации может занять до 30 минут. В течение этого периода конечная точка будет работать в режиме понижения производительности, и вы можете столкнуться с ошибками для динамической упаковки и запросов динамического шифрования. Примеры: StreamingEndpointVersion:"2.0" StreamingEndpointVersion:"1.0"
CustomHostNames Необязательный элемент.	Collection(Edm.String)	Используется для настройки конечной точки потоковой передачи для приема трафика, направленного на пользовательское имя узла. Это упростит настройку управления трафиком с помощью глобального диспетчера трафика (GTM) и позволит использовать фирменные доменные имена в качестве имени конечной точки потоковой передачи. Владелец доменного имени должен быть подтвержден Службами мультимедиа Azure. Службы мультимедиа Azure проверяют принадлежность доменного имени, требуя, чтобы запись CName, содержащая идентификатор учетной записи Служб мультимедиа Azure, была добавлена в качестве компонента к используемому домену. Например, для использования sports.contoso.com в качестве пользовательского имени узла для конечной точки потоковой передачи необходимо настроить запись accountId.contoso.com<> так, чтобы она указывала на одно из имен узлов проверки Служб мультимедиа. Имя узла проверки состоит из verifydns.<mediaservices-dns-zone>. Следующая таблица содержит ожидаемые зоны DNS, которые должны использоваться в проверочной записи для разных регионов Azure. Северная Америка, Европа, Сингапур, Гонконг, Япония: — mediaservices.windows.net; — verifydns.mediaservices.windows.net. Китай: — mediaservices.chinacloudapi.cn; — verifydns.mediaservices.chinacloudapi.cn. Например, запись CName, в которой 945a4c4e-28ea-45cd-8ccb-a519f6b700ad.contoso.com соответствует verifydns.mediaservices.windows.net, подтверждает, что идентификатор Служб мультимедиа Azure 945a4c4e-28ea-45cd-8ccb-a519f6b700ad владеет доменом contoso.com, следовательно, любое имя в contoso.com можно использовать в качестве пользовательского имени узла для конечной точки потоковой передачи в этой учетной записи. Чтобы найти значение идентификатора службы мультимедиа, перейдите на портал Azure и выберите свою учетную запись службы мультимедиа. Идентификатор службы мультимедиа отображается справа от страницы панели мониторинга. Предупреждение. При попытке задать пользовательское имя узла без надлежащей проверки записи CName ответ DNS не будет получен, после чего в течение некоторого времени будет выполняться кэширование. После получения соответствующей записи повторная проверка кэшированного ответа может занять некоторое время. В зависимости от поставщика DNS пользовательского домена повторная проверка записи может занять от нескольких минут до часа. Кроме параметра CName, который сопоставляет <accountId>.<parent domain> с verifydns.<mediaservices-dns-zone>, необходимо создать другую запись CName, которая сопоставляет пользовательское имя узла (например, sports.contoso.com) с именем узла StreamingEndpont Служб мультимедиа (например, amstest.streaming.mediaservices.windows.net). Примечание. Конечные точки потоковой передачи, расположенные в одном центре обработки данных, не могут совместно применять одно пользовательское имя узла. Это свойство допустимо для конечных точек потоковой передачи уровня "Стандартный" и "Премиум" и может быть задано при "CdnEnabled":false Обратите внимание, что в настоящее время AMS не поддерживает SSL для личных доменов.
AccessControl	StreamingEndpointAccessControl ComplexType	Используется для настройки следующих параметров безопасности для этой конечной точки потоковой передачи: ключи аутентификации заголовка подписи Akamai и IP-адреса, которые смогут подключиться к этой конечной точке. Примечание. Это свойство допустимо для конечных точек потоковой передачи уровня "Стандартный" и "Премиум" и может быть задано при "CdnEnabled":false
CacheControl	StreamingEndpointCacheControl	Используется для настройки времени жизни кэша для активов, обслуживаемых через данную конечную точку потоковой передачи.
CrossSiteAccessPolicies	CrossSiteAccessPolicies	Используется для указания политик межсайтового доступа для различных клиентов. Дополнительные сведения см. в статьях Спецификация файла междоменной политики и Настройка доступности службы на границах домена.

StreamingEndpointCacheControl

Имя	Тип	Описание
MaxAge Необязательный элемент.	Edm.Int64	Переопределяет значение по умолчанию заголовка максимального срока действия кэша HTTP, установленное конечной точкой потоковой передачи в медиафрагментах и манифестах по запросу. Это значение задается в секундах.

StreamingEndpointAccessControl ComplexType

Имя	Тип	Описание
Akamai	AkamaiAccessControl	Управление доступом Akamai.
IP	IPAccessControl	Управление доступом IP-адресов.

AkamaiAccessControl

Имя	Тип	Описание
AkamaiSignatureHeaderAuthenticationKeyList	AkamaiSignatureHeaderAuthenticationKey ComplexType	Содержит информацию о ключах проверки подлинности заголовка подписи Akamai.

IPAccessControl

Имя	Тип	Описание
Allow	IPRange ComplexType	Определяет IP-адреса, которые могут подключаться к конечной точке потоковой передачи. Примечание. Если задать для этого значения значение NULL, можно подключиться ко всем IP-адресам источника. Установите его на пустую строку (""), что не позволит никому осуществлять подключение.

AkamaiSignatureHeaderAuthenticationKey ComplexType

Этот тип описывает параметры проверки подлинности Akamai G20. Проверка подлинности Akamai — это схема проверки подлинности сообщений с ключом и хэшом. Ключ проверки подлинности — это секрет, совместно используемый сетью CDN Akamai и службой потоковой передачи источника мультимедиа Azure. Службы мультимедиа Azure поддерживают только версию 3, в которой используется HMAC-MD5.

Имя	Тип	Описание
Identifier	Edm.String	Идентификатор ключа проверки подлинности. Это nonce, предоставленный Akamai.
Expiration	Edm.DateTime	Значение даты и времени, указывающее, когда истечет срок действия проверки подлинности Akamai
Base64Key	Edm.String	Ключ проверки подлинности на основе Base64, который будет использован CDN. Ключ проверки подлинности, предоставляемый Akamai, является строкой в кодировке ASCII и должен быть преобразован в байты, а затем в кодировке Base64.

В следующем примере C# показано, как преобразовать ключ проверки подлинности Akamai в base64:

string akamaiKey = "01234567890123456789012345678901";  
string base64Key = Convert.ToBase64String(System.Text.Encoding.ASCII.GetBytes(akamaiKey);  
  

IPRange ComplexType

Имя	Тип	Описание
Name	Edm.String	Понятное имя для данного диапазона IP-адресов.
Address	Edm.String	Базовый IP-адрес для представления подсети (например:192.168.0.1).
SubnetPrefixLength	Edm.Int32	Количество значимых битов для маски подсети (например в IP-адресе 192.168.0.1/24 цифра 24 указывает на количество значимых битов).

Создание конечной точки потоковой передачи

Создание новой конечной точки потоковой передачи.

Запрос

Метод	Универсальный код ресурса (URI) запроса	Версия HTTP
POST	<https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoint>	HTTP/1.1

Пример запроса

Вы можете опробовать следующий пример на вкладке Fiddler's Composer.

Чтобы получить последнюю версию x-ms-version:, см. раздел REST Служб мультимедиа.

Заголовки запроса:

POST https://testrest.cloudapp.net/api/StreamingEndpoints HTTP/1.1  
Content-Type: application/json;odata=minimalmetadata  
Accept: application/json;odata=minimalmetadata  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
x-ms-version: 2.19
Authorization: Bearer <token value>  
  

Тело запроса:

{    
   "Id":null,  
   "Name":"teststreamingendpoint001",  
   "Description":"",  
   "Created":"0001-01-01T00:00:00",  
   "LastModified":"0001-01-01T00:00:00",  
   "State":null,  
   "HostName":null,  
   "ScaleUnits":0,  
   "CustomHostNames":[    
  
   ],  
   "AccessControl":{    
      "Akamai":{    
         "AkamaiSignatureHeaderAuthenticationKeyList":[    
            {    
               "Identifier":"My key",  
               "Expiration":"2015-08-08T21:45:34.463Z",  
               "Base64Key":"/31iWKdqNC7YUnj8zQ3XHA=="  
            }  
         ]  
      },  
      "IP":{    
         "Allow":[    
            {    
               "Name":"Allow all",  
               "Address":"0.0.0.0",  
               "SubnetPrefixLength":0  
            }  
         ]  
      }  
   },  
   "CacheControl":{    
      "MaxAge":"1800"  
   },  
   "CrossSiteAccessPolicies":{    
      "ClientAccessPolicy":"<access-policy><cross-domain-access><policy><allow-from http-request-headers='*'><domain uri='http://*' /></allow-from><grant-to><resource path='/' include-subpaths='false' /></grant-to></policy></cross-domain-access></access-policy>",  
      "CrossDomainPolicy":"<?xml version='1.0'?><!DOCTYPE cross-domain-policy SYSTEM 'http://www.macromedia.com/xml/dtds/cross-domain-policy.dtd'><cross-domain-policy><allow-access-from domain='*' /></cross-domain-policy>"  
   }  
}  
  

При успешном выполнении возвращается код состояния 202 Принято вместе с представлением созданной сущности в тексте ответа.

HTTP/1.1 202 Accepted  
Cache-Control: no-cache  
Content-Length: 1185  
Content-Type: application/json;odata=minimalmetadata;streaming=true;charset=utf-8  
Location: https://testrest.cloudapp.net/api/StreamingEndpoints('nb%3Aoid%3AUUID%3Ad2742eb8-ce32-44b8-aae8-83f21364c291')  
Server: Microsoft-IIS/8.5  
request-id: 917c74d3-ebc7-48b6-8484-a103054a9e34  
x-ms-request-id: 917c74d3-ebc7-48b6-8484-a103054a9e34  
operation-id: nb:opid:UUID:ec2e517c-9b33-4af5-baca-e6136acfb40f  
X-Content-Type-Options: nosniff  
DataServiceVersion: 3.0;  
X-Powered-By: ASP.NET  
Date: Sun, 10 Aug 2014 00:31:28 GMT  
  
{    
   "odata.metadata":"https://testrest.cloudapp.net/api/$metadata#StreamingEndpoints/@Element",  
   "Id":"nb:oid:UUID:d2742eb8-ce32-44b8-aae8-83f21364c291",  
   "Name":"teststreamingendpoint001",  
   "Description":"",  
   "Created":"2014-08-10T00:31:28.6760592Z",  
   "LastModified":"2014-08-10T00:31:28.6760592Z",  
   "State":"Stopped",  
   "HostName":null,  
   "ScaleUnits":0,  
   "CustomHostNames":[    
  
   ],  
   "AccessControl":{    
      "Akamai":{    
         "AkamaiSignatureHeaderAuthenticationKeyList":[    
            {    
               "Identifier":"My key",  
               "Expiration":"2015-08-08T21:45:34.463Z",  
               "Base64Key":"/31iWKdqNC7YUnj8zQ3XHA=="  
            }  
         ]  
      },  
      "IP":{    
         "Allow":[    
            {    
               "Name":"Allow all",  
               "Address":"0.0.0.0",  
               "SubnetPrefixLength":0  
            }  
         ]  
      }  
   },  
   "CacheControl":{    
      "MaxAge":"1800"  
   },  
   "CrossSiteAccessPolicies":{    
      "ClientAccessPolicy":"<access-policy><cross-domain-access><policy><allow-from http-request-headers='*'><domain uri='http://*' /></allow-from><grant-to><resource path='/' include-subpaths='false' /></grant-to></policy></cross-domain-access></access-policy>",  
      "CrossDomainPolicy":"<?xml version='1.0'?><!DOCTYPE cross-domain-policy SYSTEM 'http://www.macromedia.com/xml/dtds/cross-domain-policy.dtd'><cross-domain-policy><allow-access-from domain='*' /></cross-domain-policy>"  
   }  
}  
  

Код состояния 202 Принято указывает на асинхронную операцию. В этом случае также предоставляется значение заголовка идентификатора операции для опроса и отслеживания состояния долговременных операций, например, для запуска или остановки конечной точки потоковой передачи. Для получения состояния передайте значение заголовка идентификатора операции в сущность операции. Дополнительные сведения см. в разделе Опрос операций Long-Running вручную.

Запуск конечной точки потоковой передачи

Запуск определенной конечной точки потоковой передачи. Конечную точку потоковой передачи может запустить, только когда она находится в состоянии Остановлена. Через некоторое время после запуска StreamingEdpoint состояние изменяется на Running.
Чтобы остановить потоковую передачу позже, вызовите операцию Stop .

Доступные действия в состоянии Выполняется .

Состояние	Единицы потоковой передачи	Описание	Доступные действия
Запущен	0	Потоковая передача из конечной точки потоковой передачи уровня "Стандартный".	Остановить, Масштабировать
Запущен	>0	Потоковая передача из конечной точки потоковой передачи уровня "Премиум".	Остановить, Масштабировать

Запрос

Метод	Универсальный код ресурса (URI) запроса	Версия HTTP
POST	<https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Start	HTTP/1.1

Пример запроса

Вы можете опробовать следующий пример на вкладке Fiddler's Composer.

Заголовки запроса:

POST https://testrest.cloudapp.net/api/StreamingEndpoints('nb%3Aoid%3AUUID%3A32ad7fa6-f780-4345-bbc6-45a79a914427')/Start HTTP/1.1  
Content-Type: application/json;odata=minimalmetadata  
Accept: application/json;odata=minimalmetadata  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
x-ms-version: 2.19
Authorization: Bearer <token value>  
  

При успешном выполнении возвращается код состояния 202 Принято. Код состояния 202 Принято указывает на асинхронную операцию. В этом случае также предоставляется значение заголовка идентификатора операции для опроса и отслеживания состояния долговременных операций, например, для запуска или остановки конечной точки потоковой передачи. Для получения состояния передайте значение заголовка идентификатора операции в сущность операции. Дополнительные сведения см. в разделе Опрос операций Long-Running вручную.

Остановка конечных точек потоковой передачи

Остановка определенной конечной точки потоковой передачи. Конечную точку потоковой передачи может остановить, только когда она находится в состоянии Работает.

Доступные действия в состоянии Остановлено .

Состояние	Единицы потоковой передачи	Описание	Доступные действия
Остановлена	0	Нет потоковой передачи данных.	Запуск, Масштабировать
Остановлена	>0	Нет потоковой передачи данных.	Запуск, Масштабировать

Запрос

Метод	Универсальный код ресурса (URI) запроса	Версия HTTP
POST	<https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Stop	HTTP/1.1

Пример запроса

Вы можете опробовать следующий пример на вкладке Fiddler's Composer.

Сведения о том, как получить последнюю версию x-ms-version:, см. в разделе REST Служб мультимедиа.

Заголовки запроса:

POST https://testrest.cloudapp.net/api/StreamingEndpoints('nb%3Aoid%3AUUID%3A32ad7fa6-f780-4345-bbc6-45a79a914427')/Start HTTP/1.1  
Content-Type: application/json;odata=minimalmetadata  
Accept: application/json;odata=minimalmetadata  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
x-ms-version: 2.19
Authorization: Bearer <token value>  
  

При успешном выполнении возвращается код состояния 202 Принято. Код состояния 202 Принято указывает на асинхронную операцию. В этом случае также предоставляется значение заголовка идентификатора операции для опроса и отслеживания состояния долговременных операций, например, для запуска или остановки конечной точки потоковой передачи. Для получения состояния передайте значение заголовка идентификатора операции в сущность операции. Дополнительные сведения см. в разделе Опрос операций Long-Running вручную.

Масштабирование конечных точек потоковой передачи

Динамически обновляет емкость единицы потоковой передачи в состоянии выполнения и изменяет тип со стандартной конечной точки потоковой передачи на конечную точку потоковой передачи уровня "Премиум" при обновлении с "ScaleUnits":0.

Запрос

Метод	Универсальный код ресурса (URI) запроса	Версия HTTP
POST	<https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Scale	HTTP/1.1

Пример запроса

Вы можете опробовать следующий пример на вкладке Fiddler's Composer.

Сведения о том, как получить последнюю версию x-ms-version:, см. в разделе REST Служб мультимедиа.

Заголовки запроса:

POST https://testrest.cloudapp.net/api/StreamingEndpoints('nb%3Aoid%3AUUID%3A32ad7fa6-f780-4345-bbc6-45a79a914427')/Scale HTTP/1.1  
Content-Type: application/json;odata=minimalmetadata  
Accept: application/json;odata=minimalmetadata  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
x-ms-version: 2.19
Authorization: Bearer <token value>  
  

Тело запроса:

{"scaleUnits" : 2}  

При успешном выполнении возвращается код состояния 202 Принято. Код состояния 202 Принято указывает на асинхронную операцию. В этом случае также предоставляется значение заголовка идентификатора операции для опроса и отслеживания состояния долговременных операций, например, для запуска или остановки конечной точки потоковой передачи. Для получения состояния передайте значение заголовка идентификатора операции в сущность операции. Дополнительные сведения см. в разделе Опрос операций Long-Running вручную.

Перечисление конечных точек потоковой передачи

Конечные точки потоковой передачи можно получить с помощью HTTP-запроса GET.

Запрос

Метод	Универсальный код ресурса (URI) запроса	Версия HTTP
GET	Получение всех конечных точек потоковой передачи: <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints> Получение определенной конечной точки потоковой передачи. <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')	HTTP/1.1

Пример запроса

Вы можете опробовать следующий пример на вкладке Fiddler's Composer.

Сведения о том, как получить последнюю версию x-ms-version:, см. в разделе REST Служб мультимедиа.

Заголовки запроса:

GET https://testrest.cloudapp.net/api/StreamingEndpoints HTTP/1.1  
Content-Type: application/json;odata=minimalmetadata  
Accept: application/json;odata=minimalmetadata  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
x-ms-version: 2.19
Authorization: Bearer <token value>  
  

В случае успешного выполнения эта операция возвращает код состояния 200 OK и список всех точек StreamingEndpoints, созданных в вашей учетной записи Служб мультимедиа.

Обновление конечных точек потоковой передачи

Обновление конечной точки потоковой передачи новыми значениями свойства. Если конечная точка потоковой передачи работает и параметры изменены, эта операция асинхронна.

Запрос

Метод	Универсальный код ресурса (URI) запроса	Версия HTTP
PATCH/PUT/MERGE Дополнительные сведения об этих операциях см. здесь.	<https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')	HTTP/1.1

Пример запроса

Вы можете опробовать следующий пример на вкладке Fiddler's Composer. В примере обновляется значение MaxAge .

Чтобы получить последнюю версию x-ms-version:, см. раздел REST Служб мультимедиа.

Заголовки запроса:

PATCH https://testrest.cloudapp.net/api/StreamingEndpoints('nb%3Aoid%3AUUID%3A32ad7fa6-f780-4345-bbc6-45a79a914427') HTTP/1.1  
Content-Type: application/json;odata=minimalmetadata  
Accept: application/json;odata=minimalmetadata  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
x-ms-version: 2.19
Authorization: Bearer <token value>  
  

Тело запроса:

{"CacheControl":{"MaxAge":"2000"}}  

Если обновление завершается синхронно, оно возвращает код состояния 204 Нет содержимого. В противном случае оно возвращает код состояния 202 Принято. Код состояния 202 Принято указывает на асинхронную операцию. В этом случае также предоставляется значение заголовка идентификатора операции для опроса и отслеживания состояния долговременных операций, например, для запуска или остановки конечной точки потоковой передачи. Для получения состояния передайте значение заголовка идентификатора операции в сущность операции. Дополнительные сведения см. в разделе Опрос операций Long-Running вручную.

Удаление конечных точек потоковой передачи

Удаление конечной точки потоковой передачи. Конечную точку потоковой передачи можно удалить, только когда она находится в состоянии Остановлена.

Запрос

Метод	Универсальный код ресурса (URI) запроса	Версия HTTP
DELETE	<https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')	HTTP/1.1

Пример запроса

Вы можете опробовать следующий пример на вкладке Fiddler's Composer.

Чтобы получить последнюю версию x-ms-version:, см. раздел REST Служб мультимедиа.

Заголовки запроса:

DELETE https://testrest.cloudapp.net/api/StreamingEndpoints('nb%3Aoid%3AUUID%3A32ad7fa6-f780-4345-bbc6-45a79a914427') HTTP/1.1  
Content-Type: application/json;odata=minimalmetadata  
Accept: application/json;odata=minimalmetadata  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
x-ms-version: 2.19
Authorization: Bearer <token value>  
  

При успешном выполнении возвращается код состояния 202 Принято. Код состояния 202 Принято указывает на асинхронную операцию. В этом случае также предоставляется значение заголовка идентификатора операции для опроса и отслеживания состояния долговременных операций, например, для запуска или остановки конечной точки потоковой передачи. Для получения состояния передайте значение заголовка идентификатора операции в сущность операции. Дополнительные сведения см. в разделе Опрос операций Long-Running вручную.

См. также:

Канал
Program
Операция