Punkt końcowy przesyłania strumieniowego
Ważne
Począwszy od usługi Media Services 2.7, Origin nazwa jednostki została zmieniona na StreamingEndpoint.
Jednostka StreamingEndpoint reprezentuje usługę przesyłania strumieniowego, która może dostarczać zawartość bezpośrednio do aplikacji odtwarzacza klienta lub do usługi Content Delivery Network (CDN) w celu dalszej dystrybucji. Począwszy od wersji 2.9, Microsoft Azure Media Services zapewnia integrację usługi Azure CDN (aby uzyskać więcej informacji, zobacz CdnEnabled właściwość udokumentowaną poniżej). Strumień wychodzący z usługi StreamingEndpoint może być strumieniem na żywo lub elementem zawartości wideo na żądanie na koncie usługi Media Services.
Każde konto usługi Azure Media Services (AMS) zawiera domyślny punkt końcowy przesyłania strumieniowego; Dodatkowe punkty końcowe przesyłania strumieniowego można utworzyć na koncie. Począwszy od usługi Media Services 2.15 (wydanej 10 stycznia 2017 r.), istnieją dwie wersje streamingEndpoint: 1.0 i 2.0. Istnieją również trzy typy punktów Końcowych przesyłania strumieniowego: Klasyczny, **Standardowy lub Premium.
Konta usługi Media Services utworzone przed aktualizacją usługi AMS REST 2.15 domyślnie obejmują klasyczne punkty końcowe przesyłania strumieniowego w wersji 1.0. Możesz przeprowadzić uaktualnienie do wersji 2.0. Nie można obniżyć poziomu do wersji 1.0. Konta usługi AMS utworzone po aktualizacji 2.15 domyślnie obejmują punkty końcowe przesyłania strumieniowego w warstwie Standardowa w wersji 2.0. Punkty końcowe przesyłania strumieniowego w wersji 2.0 mają zmiany rozliczeń i funkcji. Aby uzyskać bardziej szczegółowe informacje, zobacz StreamingEndpointVersion właściwość udokumentowaną poniżej.
Automatycznie zainicjowany punkt końcowy przesyłania strumieniowego ma nazwę "Default" i nie można go usunąć. Stan punktu końcowego przesyłania strumieniowego to Zatrzymano. Aby rozpocząć przesyłanie strumieniowe, musisz uruchomić punkt końcowy przesyłania strumieniowego.
Jeśli konto zostało utworzone za pośrednictwem klasycznego portalu Azure, a usługa Azure CDN jest dostępna w regionie, domyślnie konto będzie mieć integrację usługi CDN ("CdnEnabled":true, "CdnProvider":StandardVerizon i "CdnProfile":AzureMediaStreamingPlatformCdnProfile).
W większości przypadków należy zachować włączoną sieć CDN. Jeśli jednak przewidujesz maksymalną współbieżność poniżej 500 osób wyświetlających, zaleca się wyłączenie usługi CDN, ponieważ jest ona skalowana najlepiej w przypadku współbieżności.
Omówienie punktów końcowych przesyłania strumieniowego w warstwie Classic, Standard, Premium
Zaawansowane funkcje opisane w tej sekcji obejmują dynamiczne tworzenie pakietów i szyfrowanie dynamiczne.
Tabela zawiera podsumowanie zachowania:
| Typ | Wersja | Jednostki skalowania | Funkcje zaawansowane | CDN | Rozliczenia |
|---|---|---|---|---|---|
| Klasyczny | 1.0 | 0 | Nie dotyczy | NA | Bezpłatna |
| Standardowy punkt końcowy przesyłania strumieniowego (zalecany) | 2.0 | 0 | Tak | Tak | Płatna |
| Punkt końcowy przesyłania strumieniowego Premium | 1.0 | > 0 | Tak | Tak | Płatna |
| Punkt końcowy przesyłania strumieniowego Premium | 2.0 | > 0 | Tak | Tak | Płatna |
Zaleca się uaktualnienie klasycznych punktów końcowych przesyłania strumieniowego do standardowych punktów końcowych przesyłania strumieniowego, aby uzyskać lepsze środowisko i zaawansowane funkcje. Standardowe przesyłanie strumieniowe automatycznie skaluje również przepustowość wychodzącą.
Typ Standardowy jest zalecany w przypadku niemal wszystkich scenariuszy przesyłania strumieniowego i każdej liczby odbiorców. W przypadku klientów z bardzo wymagającymi wymaganiami usługa AMS oferuje również punkty końcowe przesyłania strumieniowego Premium , których można użyć do skalowania pojemności w poziomie dla największych odbiorców internetowych. Jeśli oczekujesz dużej liczby odbiorców i współbieżnych osób przeglądających, skontaktuj się z nami, aby uzyskać wskazówki dotyczące tego, czy chcesz przejść do typu Premium . Dobrym wpisem po przewodniku jest skontaktowanie się z nami (amsstreaming w microsoft.com), jeśli spodziewasz się współbieżnego rozmiaru odbiorców większego niż 50 000 widzów.
Możesz przejść do typu Premium , dostosowując jednostki skalowania. Jednostki skalowania zapewniają dedykowaną pojemność ruchu wychodzącego, którą można kupić w przyrostach 200 Mb/s. W przypadku korzystania z typu Premium każda włączona jednostka zapewnia dodatkową przepustowość w aplikacji. Aby uzyskać więcej informacji, zobacz How to Scale StreamingEndpoint (Jak skalować przesyłanie strumienioweEndpoint).
Aby uzyskać więcej informacji, zobacz Streaming endpoints overview (Omówienie punktów końcowych przesyłania strumieniowego).
Właściwości i operacje punktu końcowego przesyłania strumieniowego
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 Setup for Media Services REST API Development (Konfigurowanie tworzenia interfejsu API REST usługi Media Services) i Connecting to Media Services with the Media Services REST API (Nawiązywanie połączenia z usługą Media Services za pomocą interfejsu API REST usługi Media Services).
Ta sekcja zawiera omówienie StreamingEndpoint jednostki, a także pokazuje, jak wykonywać różne operacje za pomocą interfejsu API REST usługi Media Services.
Jednostka StreamingEndpoint
Jednostka StreamingEndpoint zawiera następujące właściwości:
| Właściwość | Typ | Opis |
|---|---|---|
IdTylko do odczytu. Ustawiane przez usługę Media Services. |
Edm.String | Identyfikator punktu końcowego przesyłania strumieniowego przypisany podczas tworzenia. Format to: nb:oid:UUID:<GUID>. |
Name |
Edm.String | Przyjazna nazwa usługi StreamingEndpoint. — Musi być unikatowa na koncie usługi Media Services. - Maksymalna długość = 32 znaki. — Nie można zawierać spacji. - Łączniki i znaki alfanumeryczne. — Nie można rozpocząć ani zakończyć łącznikiem. |
Description |
Edm.String | Opis punktu końcowego przesyłania strumieniowego. Maksymalna długość to 256 znaków. |
CreatedTylko do odczytu. Ustawiane przez usługę Media Services. |
Edm.DateTime | Utworzone przez usługę Microsoft Azure Media Services Podgląd transmisji strumieniowej na żywo. |
StateTylko do odczytu. Ustaw przez usługę Media Services. |
Edm.Int32 | Wartości właściwości obejmują: -Zatrzymany. Początkowy stan punktu przesyłania strumieniowego po utworzeniu. -Zaczynając. Punkt StreamingEndpoint przechodzi do stanu uruchomienia. -Uruchomiona. Punkt StreamingEndpoint może przesyłać strumieniowo zawartość do klientów. -Skalowanie. Jednostki przesyłania strumieniowego (ScaleUnits) są zwiększane lub zmniejszane. -Zatrzymanie. Punkt StreamingEndpoint przechodzi do stanu zatrzymany. |
HostNameTylko do odczytu. Ustaw przez usługę Media Services. |
Edm.String | Domyślna nazwa hosta punktu końcowego przesyłania strumieniowego. |
LastModifiedTylko do odczytu. Ustaw przez usługę Media Services. |
Edm.DateTime | Czas ostatniej aktualizacji dla tej jednostki. |
ScaleUnitsTylko do odczytu. |
Edm.Int32 | Liczba punktów końcowych przesyłania strumieniowego w warstwie Premium przydzielonych do wdrożenia usługi StreamingEndpoint. Gdy punkt streamingEndpoint jest w Running stanie, jednostki przesyłania strumieniowego w punkcie StreamingEndpoint można skalować w górę, wywołując operację Scale .Ta właściwość kontroluje również typ punktu końcowego przesyłania strumieniowego z kombinacją wersji punktu końcowego przesyłania strumieniowego. Jeśli wersja punktu końcowego przesyłania strumieniowego to 1.0 i ScaleUnits=0, punkt końcowy przesyłania strumieniowego jest typu klasycznego . Następujące właściwości przesyłania strumieniowego Punktu końcowego można skonfigurować tylko wtedy, gdy punkt końcowy przesyłania strumieniowego jest standardowy lub premium: AccessControl, , CustomHostNames, CacheControlCrossSiteAccessPolicies. |
CdnEnabledTa właściwość została dodana w usłudze Media Services 2.9. |
Edm.Boolean |
Wskazuje, czy integracja usługi Azure CDN dla tego punktu streamingendpoint jest domyślnie włączona (wyłączona). Aby ustawić CdnEnabled wartość true, punkt streamingEndpoint musi mieć co najmniej jeden punkt końcowy przesyłania strumieniowego w warstwie Premium (ScaleUnits) dla wersji 1.0 StreamingEndpoints i być w stanie zatrzymania. Tę właściwość można ustawić, jeśli wersja streamingEndpoint ma wartość 2.0 niezależnie od wartości ScaleUnits (zapoznaj się z punktem końcowym przesyłania strumieniowego w warstwie Standardowa ) Użyj interfejsu API REST operacji , aby sprawdzić stan. Po włączeniu tej opcji następujące konfiguracje są wyłączone: CustomHostNames i AccessControl.Uwaga: nie wszystkie centra danych obsługują integrację usługi Azure CDN. Aby sprawdzić, czy centrum danych ma dostępną integrację z usługą Azure CDN, wykonaj następujące czynności: — Spróbuj ustawić wartość CdnEnabled true.- Sprawdź zwrócony wynik dla elementu HTTP Error Code 412 (wstępnie wstępnie obliczony) z komunikatem "Właściwość CdnEnabled punktu końcowego przesyłania strumieniowego nie może być ustawiona na wartość true, ponieważ możliwości usługi CDN nie są dostępne w bieżącym regionie".Jeśli wystąpi ten błąd, centrum danych nie obsługuje go. Spróbuj użyć innego centrum danych. |
CdnProviderTa właściwość została dodana w usłudze Media Services 2.15. |
Edm.String | Po włączeniu usługi CDN ("CdnEnabled":true) można również przekazać wartości CdnProvider. Dostawca cdnProvider kontroluje, który dostawca będzie używany. Obecnie obsługiwane są trzy wartości: "StandardVerizon", "PremiumVerizon" i "StandardAkamai". Jeśli nie podano żadnej wartości i jest używana wartość "CdnEnabled":true, jest używana wartość "StandardVerizon" (czyli wartość domyślna). Przykład: "CdnProvider":"StandardAkamai". Uwaga: Punkty streamingEndpoint, które są "CDNEnabled":true ze starszymi wersjami usługi AMS (<2.15) ma starszą integrację usługi CDN i używa dostawcy CDN "StandardVerizon". Zaleca się przeprowadzenie migracji punktów StreamingEndpoint do nowszej integracji usługi CDN w celu uzyskania lepszego środowiska i pełnej funkcji. |
CdnProfileTa właściwość została dodana w usłudze Media Services 2.15. |
Edm.String | Po włączeniu usługi CDN ("CdnEnabled":true) można również przekazać wartości cdnProfile. "CdnProfile" to nazwa profilu usługi CDN, w którym zostanie utworzony punkt końcowy usługi CDN. Możesz podać istniejący plik CdnProfile lub użyć nowego. Jeśli wartość ma wartość NULL i "CdnEnabled":true, zostanie użyta domyślna wartość "AzureMediaStreamingPlatformCdnProfile". Jeśli podany plik CdnProfile już istnieje, w nim zostanie utworzony punkt końcowy. Jeśli profil nie istnieje, zostanie utworzony automatycznie nowy profil. Przykład: "CdnProfile":"AzureMediaStreamingPlatformCdnProfile". |
FreeTrialEndTimeTylko do odczytu. Ta właściwość została dodana w usłudze Media Services 2.15. |
Edm.DateTime | Po utworzeniu nowego konta usługi Media Services domyślny standardowy punkt końcowy przesyłania strumieniowego jest automatycznie aprowizacji na koncie w stanie zatrzymania. Ten punkt końcowy obejmuje 15-dniowy okres bezpłatnej wersji próbnej i okres próbny rozpoczyna się po pierwszym uruchomieniu punktu końcowego. Bezpłatna wersja próbna nie ma zastosowania do istniejących kont, a data zakończenia nie zmienia się wraz z przejściami stanu, takimi jak zatrzymywanie/uruchamianie. Bezpłatna wersja próbna rozpoczyna się po raz pierwszy po uruchomieniu punktu końcowego przesyłania strumieniowego i kończy się po upływie 15 dni kalendarzowych. Bezpłatna wersja próbna ma zastosowanie tylko do domyślnego punktu końcowego przesyłania strumieniowego i nie ma zastosowania do dodatkowych punktów końcowych przesyłania strumieniowego. Po utworzeniu punktu końcowego i zatrzymaniu wartość "FreeTrialEndTime" jest ustawiona na wartość "0001-01-01T00:00:00Z". Po rozpoczęciu 15 dni zostanie dodanych do daty rozpoczęcia, a wartość rozpoczyna się od daty zakończenia bezpłatnej wersji próbnej "FreeTrialEndTime":"2016-12-16T18:01:47.8524725Z". Wartości punktów końcowych przesyłania strumieniowego, które nie kwalifikują się do bezpłatnej wersji próbnej, będą zawsze "FreeTrialEndTime":"0001-01-01T00:00Z" niezależnie od stanu. Przykłady: "FreeTrialEndTime":"2016-12-16T18:01:47.8524725Z" "FreeTrialEndTime":"0001-01-01T00:00:00Z" |
StreamingEndpointVersionTa właściwość została dodana w usłudze Media Services 2.15. |
Edm.String | Kombinacja parametrów StreamingEndpointVersion i ScaleUnits kontroluje typ punktu końcowego przesyłania strumieniowego. Każdy punkt końcowy przesyłania strumieniowego utworzony przed aktualizacją 2.15 (10 stycznia 2017 r.) będzie miał wartość "StreamingEndpointVersion":"1.0" i punkty końcowe przesyłania strumieniowego utworzone po aktualizacji będą miały wartość "StreamingEndpointVersion":"2.0". Punkty końcowe przesyłania strumieniowego, które są w wersji 1.0, nie zostaną automatycznie uaktualnione do wersji 2.0, ale można jawnie uaktualnić do wersji "StreamingEndpointVersion":"2.0". Punkty końcowe przesyłania strumieniowego z elementami "ScaleUnits":0 i "StreamingEndpointVersion":"1.0" będą traktowane jako klasyczne punkty końcowe przesyłania strumieniowego, które nie mają zaawansowanych funkcji, takich jak dynamiczne pakowanie lub szyfrowanie dynamiczne. Punkty końcowe przesyłania strumieniowego z wartością "ScaleUnits" > 0 (niezależnie od tego, czy wartość "StreamingEndpointVersion" jest ustawiona na wersję "1.0" lub wersję "2.0") to jednostki premium . Standardowe punkty końcowe przesyłania strumieniowego z elementami "ScaleUnits":0 i "StreamingEndpointVersion":"2.0" będą zawierać te same funkcje co jednostki Premium (w tym dynamiczne pakowanie i dynamiczne szyfrowanie). Klasyczny punkt końcowy przesyłania strumieniowego można uaktualnić do standardu , ustawiając wersję na "StreamingEndpointVersion":"2.0". Jest to operacja jednokierunkowa; nie można obniżyć wersji 2.0 do wersji 1.0. Uważaj, że nie można wycofać tej operacji i ma wpływ na ceny. Propagacja nowej konfiguracji może potrwać do 30 minut. W tym przedziale czasu punkt końcowy będzie działać w trybie obniżonej wydajności i może wystąpić błędy dla dynamicznych żądań tworzenia pakietów i szyfrowania dynamicznego. Przykłady: "StreamingEndpointVersion":"2.0" "StreamingEndpointVersion":"1.0" |
CustomHostNamesOpcjonalny. |
Collection(Edm.String) | Służy do konfigurowania punktu końcowego przesyłania strumieniowego w celu akceptowania ruchu kierowanego do niestandardowej nazwy hosta. Umożliwia to łatwiejsze konfigurowanie zarządzania ruchem za pośrednictwem globalnego usługi Traffic Manager (GTM), a także dla nazw domen markowych, które mają być używane jako nazwa punktu końcowego przesyłania strumieniowego. Własność nazwy domeny musi zostać potwierdzona przez usługę Azure Media Services. Usługa Azure Media Services weryfikuje własność nazwy domeny, wymagając CName rekordu zawierającego identyfikator konta usługi Azure Media Services jako składnik, który ma zostać dodany do domeny w użyciu. Na przykład w przypadku "sports.contoso.com" jako niestandardowej nazwy hosta punktu końcowego przesyłania strumieniowego należy skonfigurować rekord "<accountId.contoso.com>", aby wskazywał jedną z nazw hostów weryfikacji usługi Media Services. Nazwa hosta weryfikacji składa się z nazw verifydn.<mediaservices-dns-zone>. Poniższa tabela zawiera oczekiwane strefy DNS, które mają być używane w rekordzie weryfikacji dla różnych regionów platformy Azure.Ameryka Północna, Europa, Singapur, Hongkong, Japonia: - mediaservices.windows.net - verifydns.mediaservices.windows.net Chiny: - mediaservices.chinacloudapi.cn - verifydns.mediaservices.chinacloudapi.cn Na przykład rekord mapujący CName wartość "945a4c4e-28ea-45cd-8ccb-a519f6b700ad.contoso.com" na "verifydns.mediaservices.windows.net" okazuje się, że domena usługi Azure Media Services o identyfikatorze 945a4c4e-28ea-45cd-8ccb-a519f6f6b700ad ma własność domeny contoso.com, co umożliwi korzystanie z dowolnej nazwy w contoso.com jako niestandardowej nazwy hosta dla punktu końcowego przesyłania strumieniowego w ramach tego konta.Aby znaleźć wartość identyfikatora usługi Media Service, przejdź do Azure Portal i wybierz konto usługi Media Service. Identyfikator USŁUGI MEDIA SERVICE jest wyświetlany po prawej stronie pulpitu nawigacyjnego. Ostrzeżenie: Jeśli istnieje próba ustawienia niestandardowej nazwy hosta bez odpowiedniej weryfikacji rekordu CName , odpowiedź DNS zakończy się niepowodzeniem, a następnie zostanie zapisana w pamięci podręcznej przez jakiś czas. Po utworzeniu odpowiedniego rekordu może upłynąć trochę czasu, dopóki buforowana odpowiedź nie zostanie ponownie wycofana. W zależności od dostawcy DNS dla domeny niestandardowej może upłynąć od kilku minut do godziny, aby ponownie sprawdzić rekord.Oprócz mapowania na element należy utworzyć inny CName element, który mapuje niestandardową nazwę hosta (na przykład sports.contoso.com) na nazwę hosta usługi Media Services StreamingEndpont (na przykład amstest.streaming.mediaservices.windows.net).verifydns.<mediaservices-dns-zone>CName<accountId>.<parent domain>Uwaga: Punkty końcowe przesyłania strumieniowego znajdujące się w tym samym centrum danych nie mogą współużytkować tej samej niestandardowej nazwy hosta. Ta właściwość jest prawidłowa dla punktów końcowych przesyłania strumieniowego w warstwie Standardowa i Premium i może być ustawiana w przypadku wartości "CdnEnabled":false Należy pamiętać, że obecnie usługa AMS nie obsługuje protokołu SSL z domenami niestandardowymi. |
AccessControl |
StreamingEndpointAccessControl ComplexType | Służy do konfigurowania następujących ustawień zabezpieczeń dla tego punktu końcowego przesyłania strumieniowego: klucze uwierzytelniania nagłówka podpisu Akamai i adresy IP, które mogą łączyć się z tym punktem końcowym. Uwaga: ta właściwość jest prawidłowa dla punktów końcowych przesyłania strumieniowego w warstwie Standardowa i Premium i może być ustawiana w przypadku ustawienia "CdnEnabled":false |
CacheControl |
StreamingEndpointCacheControl | Służy do konfigurowania okresu istnienia pamięci podręcznej zasobów dla zasobów obsługiwanych za pośrednictwem tego punktu końcowego przesyłania strumieniowego. |
CrossSiteAccessPolicies |
CrossSiteAccessPolicies | Służy do określania zasad dostępu między lokacjami dla różnych klientów. Aby uzyskać więcej informacji, zobacz Specyfikacja pliku zasad między domenami i Udostępnianie usługi w granicach domeny. |
StreamingEndpointCacheControl
| Nazwa | Typ | Opis |
|---|---|---|
MaxAgeOpcjonalny. |
Edm.Int64 | Zastępuje domyślny nagłówek kontrolki pamięci podręcznej HTTP max-age ustawiony przez punkt końcowy przesyłania strumieniowego na fragmentach multimediów i manifestach na żądanie. Wartość jest ustawiana w sekundach. |
StreamingEndpointAccessControl ComplexType
| Nazwa | Typ | Opis |
|---|---|---|
Akamai |
AkamaiAccessControl | Kontrola dostępu Akamai. |
IP |
IPAccessControl | Kontrola dostępu do adresów IP. |
AkamaiAccessControl
| Nazwa | Typ | Opis |
|---|---|---|
| AkamaiSignatureHeaderAuthenticationKeyList | AkamaiSignatureHeaderAuthenticationKey ComplexType | Zawiera informacje o kluczach uwierzytelniania nagłówka Akamai Signature. |
IPAccessControl
| Nazwa | Typ | Opis |
|---|---|---|
| Zezwalaj | IPRange ComplexType | Definiuje adresy IP, które mogą łączyć się z punktem końcowym przesyłania strumieniowego. Uwaga: ustawienie tej wartości na wartość null zezwala na łączenie wszystkich adresów źródłowych IP. Ustawienie go na pusty ciąg ("") umożliwia nikomu nawiązywanie połączenia. |
AkamaiSignatureHeaderAuthenticationKey ComplexType
W tym typie opisano ustawienia uwierzytelniania Akamai G20. Uwierzytelnianie Akamai to schemat uwierzytelniania komunikatów typu keyed-hash. Klucz uwierzytelniania jest wpisem tajnym udostępnianym przez usługę Akamai CDN i usługę Azure Media Origin Streaming Service. Usługa Azure Media Services obsługuje tylko wersję 3, która używa HMAC-MD5.
| Nazwa | Typ | Opis |
|---|---|---|
Identifier |
Edm.String | Identyfikator klucza uwierzytelniania. Jest to nonce dostarczone przez Akamai. |
Expiration |
Edm.DateTime | Wartość data/godzina określająca, kiedy wygasa uwierzytelnianie Akamai |
Base64Key |
Edm.String | Klucz uwierzytelniania zakodowany w formacie Base64, który będzie używany przez sieć CDN. Klucz uwierzytelniania dostarczony przez Akamai jest ciągiem zakodowanym w formacie ASCII i musi zostać przekonwertowany na bajty, a następnie zakodowany w formacie Base64. |
W poniższym przykładzie w języku C# pokazano, jak przekonwertować klucz uwierzytelniania Akamai na base64:
string akamaiKey = "01234567890123456789012345678901";
string base64Key = Convert.ToBase64String(System.Text.Encoding.ASCII.GetBytes(akamaiKey);
IPRange ComplexType
| Nazwa | Typ | Opis |
|---|---|---|
Name |
Edm.String | Przyjazna nazwa dla tego zakresu adresów IP. |
Address |
Edm.String | Podstawowy adres IP reprezentacji podsieci (na przykład:192.168.0.1). |
SubnetPrefixLength |
Edm.Int32 | Liczba znaczących bitów maski podsieci (na przykład w następującym adresie IP 192.168.0.1/24, 24 reprezentuje liczbę znaczących bitów). |
Tworzenie punktu końcowego przesyłania strumieniowego
Utwórz nową usługę StreamingEndpoint.
Żądanie
| Metoda | Identyfikator URI żądania | Wersja PROTOKOŁU HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoint> | HTTP/1.1 |
Przykładowe żądanie
Możesz wypróbować poniższy przykład na karcie Composer programu Fiddler.
Aby uzyskać najnowszą wersję x-ms-version:, zobacz Artykuł Usługa Media Services REST.
Nagłówki żądań:
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>
Treść żądania:
{
"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>"
}
}
W przypadku powodzenia zostanie zwrócony kod stanu Zaakceptowane 202 wraz z reprezentacją utworzonej jednostki w treści odpowiedzi.
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>"
}
}
Kod stanu Akceptowany kod stanu 202 wskazuje operację asynchroniczną, w tym przypadku wartość nagłówka operation-id jest również udostępniana do sondowania i śledzenia stanu długotrwałych operacji, takich jak uruchamianie lub zatrzymywanie punktu końcowego przesyłania strumieniowego. Przekaż wartość nagłówka operation-id do jednostki operacji, aby pobrać stan. Aby uzyskać więcej informacji, zobacz Ręczne sondowanie Long-Running Operacje.
Uruchamianie punktu końcowego przesyłania strumieniowego
Uruchom określony punkt końcowy przesyłania strumieniowego. Punkt końcowy przesyłania strumieniowego można uruchomić tylko wtedy, gdy znajduje się w stanie Zatrzymano . Jakiś czas po uruchomieniu elementu StreamingEdpoint stan zmieni się na Running.
Aby zatrzymać przesyłanie strumieniowe w późniejszym momencie, wywołaj operację Zatrzymywanie .
Dostępne akcje w stanie Uruchomiono .
| Stan | Jednostki przesyłania strumieniowego | Opis | Dostępne akcje |
|---|---|---|---|
| Uruchomienie | 0 | Przesyłanie strumieniowe ze standardowego punktu końcowego przesyłania strumieniowego. | Zatrzymywanie, skalowanie |
| Uruchomienie | > 0 | Przesyłanie strumieniowe z punktu końcowego przesyłania strumieniowego w warstwie Premium. | Zatrzymywanie, skalowanie |
Żądanie
| Metoda | Identyfikator URI żądania | Wersja protokołu HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Start | HTTP/1.1 |
Przykładowe żądanie
Możesz wypróbować poniższy przykład na karcie Kompozytor programu Fiddler.
Nagłówki żądań:
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>
W przypadku powodzenia zwracany jest kod stanu Zaakceptowane 202 . Akceptowany kod stanu 202 wskazuje operację asynchroniczną, w takim przypadku wartość nagłówka operation-id jest również udostępniana do sondowania i śledzenia stanu długotrwałych operacji, takich jak uruchamianie lub zatrzymywanie punktu przesyłania strumieniowego. Przekaż wartość nagłówka operation-id do jednostki operacji, aby pobrać stan. Aby uzyskać więcej informacji, zobacz Ręczne sondowanie Long-Running Operacje.
Zatrzymywanie punktów końcowych przesyłania strumieniowego
Zatrzymaj określony punkt końcowy przesyłania strumieniowego. Punkt końcowy przesyłania strumieniowego można zatrzymać tylko wtedy, gdy znajduje się w stanie Uruchomiono .
Dostępne akcje w stanie Zatrzymano .
| Stan | Jednostki przesyłania strumieniowego | Opis | Dostępne akcje |
|---|---|---|---|
| Zatrzymano | 0 | Nie przesyłaj strumieniowo. | Uruchamianie, skalowanie |
| Zatrzymano | > 0 | Nie przesyłaj strumieniowo. | Uruchamianie, skalowanie |
Żądanie
| Metoda | Identyfikator URI żądania | Wersja protokołu HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Stop | HTTP/1.1 |
Przykładowe żądanie
Możesz wypróbować poniższy przykład na karcie Kompozytor programu Fiddler.
Aby uzyskać najnowszą wersję x-ms-version:, zobacz Media Services REST.
Nagłówki żądań:
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>
W przypadku powodzenia zwracany jest kod stanu Zaakceptowane 202 . Akceptowany kod stanu 202 wskazuje operację asynchroniczną, w takim przypadku wartość nagłówka operation-id jest również udostępniana do sondowania i śledzenia stanu długotrwałych operacji, takich jak uruchamianie lub zatrzymywanie punktu przesyłania strumieniowego. Przekaż wartość nagłówka operation-id do jednostki operacji, aby pobrać stan. Aby uzyskać więcej informacji, zobacz Ręczne sondowanie Long-Running Operacje.
Skalowanie punktów końcowych przesyłania strumieniowego
Dynamicznie aktualizuje pojemność jednostki przesyłania strumieniowego w stanie uruchomienia i zmienia typ punktu końcowego przesyłania strumieniowego w warstwie Standardowa do punktu końcowego przesyłania strumieniowego w warstwie Premium, jeśli zostanie zaktualizowany z "ScaleUnits":0.
Żądanie
| Metoda | Identyfikator URI żądania | Wersja protokołu HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Scale | HTTP/1.1 |
Przykładowe żądanie
Możesz wypróbować poniższy przykład na karcie Kompozytor programu Fiddler.
Aby uzyskać najnowszą wersję x-ms-version:, zobacz Media Services REST.
Nagłówki żądań:
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>
Treść żądania:
{"scaleUnits" : 2}
W przypadku powodzenia zwracany jest kod stanu Zaakceptowane 202 . Akceptowany kod stanu 202 wskazuje operację asynchroniczną, w takim przypadku wartość nagłówka operation-id jest również udostępniana do sondowania i śledzenia stanu długotrwałych operacji, takich jak uruchamianie lub zatrzymywanie punktu przesyłania strumieniowego. Przekaż wartość nagłówka operation-id do jednostki operacji, aby pobrać stan. Aby uzyskać więcej informacji, zobacz Ręczne sondowanie Long-Running Operacje.
Wyświetlanie listy punktów końcowych
Punkty przesyłania strumieniowego są pobierane przy użyciu żądania HTTP GET.
Żądanie
| Metoda | Identyfikator URI żądania | Wersja protokołu HTTP |
|---|---|---|
| GET | Pobierz wszystkie punkty końcowe przesyłania strumieniowego: <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints> Pobierz określony punkt końcowy przesyłania strumieniowego. <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') |
HTTP/1.1 |
Przykładowe żądanie
Możesz wypróbować poniższy przykład na karcie Kompozytor programu Fiddler.
Aby uzyskać najnowszą wersję x-ms-version:, zobacz Media Services REST.
Nagłówki żądań:
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>
W przypadku powodzenia ta operacja zwraca kod stanu OK 200 OK i listę wszystkich punktów StreamingEndpoint utworzonych na koncie usługi Media Services.
Aktualizowanie punktów końcowych przesyłania strumieniowego
Zaktualizuj punkt StreamingEndpoint przy użyciu nowych wartości właściwości. Jest to operacja asynchroniczna, jeśli punkt końcowy przesyłania strumieniowego jest uruchomiony i ustawienia zostaną zmienione.
Żądanie
| Metoda | Identyfikator URI żądania | Wersja PROTOKOŁU HTTP |
|---|---|---|
| PATCH/PUT/MERGE Aby uzyskać więcej informacji na temat tych operacji, zobacz PATCH/PUT/MERGE. |
<https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') | HTTP/1.1 |
Przykładowe żądanie
Możesz wypróbować poniższy przykład na karcie Composer programu Fiddler. W przykładzie jest aktualizowana wartość MaxAge .
Aby uzyskać najnowszą wersję x-ms-version:, zobacz Artykuł Usługa Media Services REST.
Nagłówki żądań:
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>
Treść żądania:
{"CacheControl":{"MaxAge":"2000"}}
Jeśli aktualizacja zostanie ukończona synchronicznie, zwraca kod stanu brak zawartości 204 ; w przeciwnym razie zwraca kod stanu Zaakceptowane 202 . Kod stanu Akceptowany kod stanu 202 wskazuje operację asynchroniczną, w tym przypadku wartość nagłówka operation-id jest również udostępniana do sondowania i śledzenia stanu długotrwałych operacji, takich jak uruchamianie lub zatrzymywanie punktu końcowego przesyłania strumieniowego. Przekaż wartość nagłówka operation-id do jednostki operacji, aby pobrać stan. Aby uzyskać więcej informacji, zobacz Ręczne sondowanie Long-Running Operacje.
Usuwanie punktów końcowych przesyłania strumieniowego
Usuń punkt końcowy przesyłania strumieniowego. Punkt końcowy przesyłania strumieniowego można usunąć tylko wtedy, gdy jest w stanie Zatrzymano .
Żądanie
| Metoda | Identyfikator URI żądania | Wersja PROTOKOŁU HTTP |
|---|---|---|
| DELETE | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') | HTTP/1.1 |
Przykładowe żądanie
Możesz wypróbować poniższy przykład na karcie Composer programu Fiddler.
Aby uzyskać najnowszą wersję x-ms-version:, zobacz Artykuł Usługa Media Services REST.
Nagłówki żądań:
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>
W przypadku powodzenia zostanie zwrócony kod stanu Zaakceptowane 202 . Kod stanu Akceptowany kod stanu 202 wskazuje operację asynchroniczną, w tym przypadku wartość nagłówka operation-id jest również udostępniana do sondowania i śledzenia stanu długotrwałych operacji, takich jak uruchamianie lub zatrzymywanie punktu końcowego przesyłania strumieniowego. Przekaż wartość nagłówka operation-id do jednostki operacji, aby pobrać stan. Aby uzyskać więcej informacji, zobacz Ręczne sondowanie Long-Running Operacje.