Sdílet prostřednictvím


Koncový bod streamování

Důležité

Od verze Media Services 2.7 Origin se entita přejmenovala na StreamingEndpoint.

Entita StreamingEndpoint představuje službu streamování, která může doručovat obsah přímo do aplikace klientského přehrávače nebo do sítě pro doručování obsahu (CDN) za účelem další distribuce. Od verze 2.9 Microsoft Azure Media Services poskytuje integraci Azure CDN (další informace najdete ve CdnEnabled vlastnosti popsané níže). Odchozí datový proud ze služby StreamingEndpoint může být živý stream nebo prostředek videa na vyžádání ve vašem účtu Media Services.

Každý účet Služby Azure Media Services (AMS) obsahuje výchozí koncový bod streamování. Pod účtem je možné vytvořit další koncové body streamování. Počínaje verzí Media Services 2.15 (vydaná 10. ledna 2017) existují dvě verze StreamingEndpoint: 1.0 a 2.0. Existují také tři typy koncových bodů streamování: Classic, **Standard nebo Premium.

Účty Media Services vytvořené před aktualizací AMS REST 2.15 ve výchozím nastavení zahrnují klasické koncové body streamování verze 1.0. Můžete upgradovat na verzi 2.0, nemůžete downgradovat na verzi 1.0. Účty AMS vytvořené po aktualizaci 2.15 ve výchozím nastavení zahrnují standardní koncové body streamování verze 2.0. U koncových bodů streamování verze 2.0 došlo ke změnám fakturace a funkcí. Podrobnější informace najdete v StreamingEndpointVersion níže uvedené vlastnosti.

Automaticky zřízený StreamingEndpoint má název Výchozí a nelze ho odstranit. Koncový bod streamování je ve stavu Zastaveno. Pokud chcete spustit streamování, musíte spustit koncový bod streamování.

Pokud jste účet vytvořili prostřednictvím portálu Azure Classic a v této oblasti je dostupná služba Azure CDN, bude mít účet ve výchozím nastavení integraci CDN ("CdnEnabled":true, "CdnProvider":StandardVerizon and "CdnProfile":AzureMediaStreamingPlatformCdnProfile).

Ve většině případů byste měli síť CDN ponechat povolenou. Pokud však předpokládáte, že budete mít maximálně 500 souběžných diváků, doporučujeme síť CDN zakázat, protože se nejlépe škáluje s vysokou souběžností.

Přehled koncových bodů streamování Classic, Standard a Premium

Mezi pokročilé funkce popsané v této části patří dynamické balení a dynamické šifrování.

Tabulka shrnuje chování:

Typ Verze ScaleUnits Pokročilé funkce CDN Fakturace
Klasický 1.0 0 Není k dispozici Není k dispozici Free
Koncový bod streamování Standard (doporučeno) 2.0 0 Ano Ano Placené
Koncový bod streamování Premium 1.0 >0 Ano Ano Placené
Koncový bod streamování Premium 2.0 >0 Ano Yes Placené

Doporučujeme upgradovat klasické koncové body streamování na standardní koncové body streamování, abyste získali lepší prostředí a pokročilé funkce. Standardní streamování také automaticky škáluje odchozí šířku pásma.

Typ Standard je doporučenou možností pro v podstatě všechny scénáře streamování a velikosti cílové skupiny. Zákazníkům s extrémně náročnými požadavky nabízí AMS také koncové body streamování Premium , které je možné použít k horizontálnímu navýšení kapacity pro největší cílové skupiny na internetu. Pokud očekáváte velké cílové skupiny a souběžné diváky, kontaktujte nás a požádejte nás o pokyny, jestli je potřeba přejít na typ Premium . Dobrým příspěvkem průvodce je kontaktovat nás (amsstreaming na microsoft.com), pokud očekáváte souběžnou cílovou skupinu větší než 50 000 diváků.

Na typ Premium přejdete úpravou jednotek škálování. Jednotky škálování poskytují vyhrazenou výchozí kapacitu, kterou je možné zakoupit v přírůstcích po 200 Mb/s. Při použití typu Premium každá povolená jednotka poskytuje aplikaci další kapacitu šířky pásma. Další informace najdete v tématu Postup škálování streamováníEndpoint.

Další informace najdete v přehledu koncových bodů streamování.

Vlastnosti a operace StreamingEndpoint

Důležité

Při přístupu k entitám ve službě Media Services musíte v požadavcích HTTP nastavit specifická pole hlaviček a hodnoty.
Další informace najdete v tématu Nastavení pro vývoj rozhraní REST API služby Media Services a připojení ke službě Media Services pomocí rozhraní REST API služby Media Services.

Tato část poskytuje přehled StreamingEndpoint entity a také ukazuje, jak provádět různé operace pomocí rozhraní REST API služby Media Services.

Entita StreamingEndpoint

Entita StreamingEndpoint obsahuje následující vlastnosti:

Vlastnost Typ Description
Id

Jen pro čtení. Nastaveno službou Media Services.
Edm.String ID koncového bodu streamování, které se přiřadí při vytvoření. Formát je: nb:oid:UUID:<GUID>.
Name Edm.String Popisný název služby StreamingEndpoint

– Musí být jedinečný v rámci vašeho účtu Media Services.

- Maximální délka = 32 znaků.

– Nesmí obsahovat mezery.

– Pouze pomlčky a alfanumerické znaky.

– Nesmí začínat ani končit spojovníkem.
Description Edm.String Popis koncového bodu streamování. Maximální délka je 256 znaků.
Created

Jen pro čtení. Nastaveno službou Media Services.
Edm.DateTime Vytvořeno službou Microsoft Azure Media Services Live Streaming Preview.
State

Jen pro čtení. Nastaveno službou Media Services.
Edm.Int32 Mezi hodnoty vlastnosti patří:

-Zastavil. Počáteční stav streamovacího koncového bodu po vytvoření.

-Spuštění. Koncový bod streamování přechází do spuštěného stavu.

-Spuštění. StreamingEndpoint dokáže streamovat obsah do klientů.

-Měřítka. Jednotky streamování (ScaleUnits) se zvyšují nebo snižují.

-Zastavení. Koncový bod streamování přechází do zastaveného stavu.
HostName

Jen pro čtení. Nastaveno službou Media Services.
Edm.String Výchozí název hostitele koncového bodu streamování
LastModified

Jen pro čtení. Nastaveno službou Media Services.
Edm.DateTime Čas poslední aktualizace této entity.
ScaleUnits

Jen pro čtení.

Edm.Int32 Počet koncových bodů streamování premium přidělených pro nasazení StreamingEndpoint. Pokud je koncový bod streamování ve Running stavu , jednotky streamování v koncovém bodu streamování lze vertikálně navýšit voláním Scale operace.

Tato vlastnost také řídí typ koncového bodu streamování pomocí kombinace verze koncového bodu streamování. Pokud je verze koncového bodu streamování verze 1.0 a ScaleUnits=0, je koncový bod streamování klasického typu.

Následující vlastnosti streamingEndpoint je možné nakonfigurovat pouze v případě, že je váš koncový bod streamování Standard nebo Premium: AccessControl, CustomHostNames, CacheControl, . CrossSiteAccessPolicies
CdnEnabled

Tato vlastnost byla přidána ve službě Media Services 2.9.
Edm.Boolean Určuje, jestli je integrace Azure CDN pro tento koncový bod streamování povolená (ve výchozím nastavení je zakázaná).

Pokud chcete nastavit CdnEnabled hodnotu true, musí mít Koncový bod streamování alespoň jeden koncový bod streamování Premium (ScaleUnits) pro streamingendpoints verze 1.0 a musí být v zastaveném stavu. Tuto vlastnost můžete nastavit, pokud je verze StreamingEndpoint 2.0 bez ohledu na hodnotu ScaleUnits (viz standardní koncový bod streamování). Ke kontrole stavu použijte rozhraní REST API pro operace . Jakmile je povolená, zablokují se následující konfigurace: CustomHostNames a AccessControl.

Poznámka: Ne všechna datacentra podporují integraci Azure CDN. Pokud chcete zkontrolovat, jestli má vaše datové centrum k dispozici integraci Azure CDN, postupujte takto:

- Zkuste nastavit hodnotu CdnEnabled na true.

– Zkontrolujte vrácený výsledek HTTP Error Code 412 (Předběžné selhání) se zprávou "Vlastnost CdnEnabled koncového bodu streamování nejde nastavit na hodnotu true, protože funkce CDN není v aktuální oblasti dostupná."

Pokud se zobrazí tato chyba, datové centrum ji nepodporuje. Měli byste vyzkoušet jiné datové centrum.
CdnProvider

Tato vlastnost byla přidána ve službě Media Services 2.15.
Edm.String Pokud je povolená síť CDN ("CdnEnabled":true), můžete také předat hodnoty CdnProvider. CdnProvider určuje, který zprostředkovatel se použije. V současné době jsou podporovány tři hodnoty: StandardVerizon, PremiumVerizon a StandardAkamai. Pokud se nezadá žádná hodnota a CdnEnabled:true, použije se StandardVerizon (výchozí hodnota).
Příklad: "CdnProvider":"StandardAkamai".

Poznámka: StreamingEndpoints, které jsou "CDNEnabled":true ve starších verzích AMS (<2.15) má starší integraci CDN a používá poskytovatele CDN StandardVerizon. Doporučujeme migrovat streamovací koncové body na novější integraci CDN, abyste získali lepší prostředí a plnou funkci.
CdnProfile

Tato vlastnost byla přidána ve službě Media Services 2.15.
Edm.String Pokud je povolená síť CDN (CdnEnabled:true), můžete také předat hodnoty CdnProfile. CdnProfile je název profilu CDN, ve kterém se vytvoří bod koncového bodu CDN. Můžete zadat existující cdnProfile nebo použít nový. Pokud je hodnota NULL a "CdnEnabled":true, použije se výchozí hodnota AzureMediaStreamingPlatformCdnProfile. Pokud zadaný soubor CdnProfile již existuje, vytvoří se pod ním koncový bod. Pokud profil neexistuje, automaticky se vytvoří nový profil.
Příklad: "CdnProfile":"AzureMediaStreamingPlatformCdnProfile".
FreeTrialEndTime
Jen pro čtení.

Tato vlastnost byla přidána ve službě Media Services 2.15.
Edm.DateTime Při vytvoření nového účtu Media Services se v rámci tohoto účtu automaticky zřídí také výchozí standardní koncový bod streamování v zastaveném stavu. Tento koncový bod zahrnuje 15denní bezplatné zkušební období a zkušební období začíná při prvním spuštění koncového bodu. Bezplatná zkušební verze se nevztahuje na existující účty a koncové datum se nemění s přechody stavu, jako je zastavení/spuštění. Bezplatná zkušební verze se spustí při prvním spuštění koncového bodu streamování a skončí po 15 kalendářních dnech. Bezplatná zkušební verze se vztahuje pouze na výchozí koncový bod streamování a nevztahuje se na další koncové body streamování.

Když je koncový bod právě vytvořený a je v zastaveném stavu, hodnota FreeTrialEndTime se nastaví na 0001-01-01T00:00:00Z. Po spuštění se k počátečnímu datu přičte 15 dnů a hodnota začne představovat koncové datum bezplatné zkušební verze FreeTrialEndTime:"2016-12-16T18:01:47.8524725Z".
Hodnoty pro koncové body streamování, které nemají nárok na bezplatnou zkušební verzi, budou vždy FreeTrialEndTime:"0001-01-01T00:00:00Z" bez ohledu na stav.
Příklady:
"FreeTrialEndTime":"2016-12-16T18:01:47.8524725Z"
"FreeTrialEndTime":"0001-01-01T00:00:00Z"
StreamingEndpointVersion

Tato vlastnost byla přidána ve službě Media Services 2.15.
Edm.String Typ koncového bodu streamování řídí kombinace StreamingEndpointVersion a ScaleUnits. Všechny koncové body streamování vytvořené před aktualizací 2.15 (10. ledna 2017) budou mít hodnotu StreamingEndpointVersion:1.0 a koncové body streamování vytvořené po aktualizaci budou mít hodnotu StreamingEndpointVersion:"2.0".
Koncové body streamování, které jsou verze 1.0, se automaticky neupgradují na verzi 2.0, ale je možné je explicitně upgradovat na StreamingEndpointVersion:"2.0".
Koncové body streamování s "ScaleUnits":0 a "StreamingEndpointVersion":"1.0" budou považovány za klasické koncové body streamování, které nemají pokročilé funkce, jako je dynamické balení nebo dynamické šifrování.
Koncové body streamování s "ScaleUnits" > 0 (bez ohledu na to, jestli je vlastnost StreamingEndpointVersion nastavená na verzi 1.0 nebo 2.0) jsou jednotky premium .
Standardní koncové body streamování s "ScaleUnits":0 a "StreamingEndpointVersion":"2.0" budou obsahovat stejné funkce jako prémiové jednotky (které zahrnují dynamické balení a dynamické šifrování).
Klasický koncový bod streamování můžete upgradovat na standard nastavením verze na "StreamingEndpointVersion":"2.0".
Jedná se o jednosměrnou operaci; Nelze downgradovat verzi 2.0 na verzi 1.0. Mějte na pozoru, že tuto operaci nelze vrátit zpět a má dopad na ceny. Rozšíření této nové konfigurace může trvat až 30 minut. Během této doby bude koncový bod fungovat v režimu sníženého výkonu a u dynamických požadavků na balení a dynamické šifrování může docházet k chybám.

Příklady:
"StreamingEndpointVersion":"2.0"
"StreamingEndpointVersion":"1.0"
CustomHostNames

Nepovinný parametr.
Collection(Edm.String) Používá se ke konfiguraci koncového bodu streamování pro příjem provozu směrovaného na vlastní název hostitele. To umožňuje snadnější konfiguraci správy provozu prostřednictvím globálního traffic manageru (GTM) a také názvy domén se značkami, které se používají jako název koncového bodu streamování.

Azure Media Services musí potvrdit vlastnictví názvu domény. Azure Media Services ověřuje vlastnictví názvu domény tím, že vyžaduje přidání záznamu CName obsahujícího ID účtu služby Azure Media Services jako součásti do používané domény. Například pro sports.contoso.com, který se má použít jako vlastní název hostitele pro koncový bod streamování, musí být záznam accountId.contoso.com<> nakonfigurovaný tak, aby odkazoval na jeden z názvů hostitele pro ověření Media Services. Název hostitele pro ověření se skládá z verifydns.<mediaservices-dns-zone>. Následující tabulka obsahuje očekávané zóny DNS, které se mají použít v záznamu ověření pro různé oblasti Azure.

Severní Amerika, Evropa, Singapur, Hongkong, Japonsko:

- mediaservices.windows.net

- verifydns.mediaservices.windows.net

Čína:

- mediaservices.chinacloudapi.cn

- verifydns.mediaservices.chinacloudapi.cn

Například záznam, který mapuje "945a4c4e-28ea-45cd-8ccb-a519f6b700ad.contoso.com" na "verifydns.mediaservices.windows.net", CName potvrzuje, že ID služby Azure Media Services 945a4c4e-28ea-45cd-8ccb-a519f6b700ad má vlastnictví domény contoso.com, takže jakýkoli název v rámci contoso.com použít jako vlastní název hostitele pro koncový bod streamování v rámci tohoto účtu.

Hodnotu ID služby Media Service najdete tak, že přejdete na Azure Portal a vyberete svůj účet služby Media Service. ID SLUŽBY MEDIA SERVICE se zobrazí na pravé straně stránky ŘÍDICÍ PANEL.

Upozornění: Pokud dojde k pokusu o nastavení vlastního názvu hostitele bez řádného ověření záznamu CName , odpověď DNS selže a po určitou dobu se uloží do mezipaměti. Jakmile je zaveden správný záznam, může chvíli trvat, než se odpověď uložená v mezipaměti znovu aktualizuje. V závislosti na poskytovateli DNS pro vlastní doménu může opětovné ověření záznamu trvat několik minut až hodinu.

Kromě mapování na CName<accountId>.<parent domain>verifydns.<mediaservices-dns-zone>musíte vytvořit dalšíCName, který mapuje vlastní název hostitele (například sports.contoso.com) na název hostitele vaší služby Media Services StreamingEndpont (například ). amstest.streaming.mediaservices.windows.net

Poznámka: Koncové body streamování umístěné ve stejném datacentru nemůžou sdílet stejný vlastní název hostitele.
Tato vlastnost je platná pro koncové body streamování úrovně Standard a Premium a je možné ji nastavit v případě cdnEnabled:false.

Upozorňujeme, že AMS v současné době nepodporuje SSL s vlastními doménami.
AccessControl StreamingEndpointAccessControl ComplexType Používá se ke konfiguraci následujících nastavení zabezpečení pro tento koncový bod streamování: Ověřovací klíče hlavičky podpisu Akamai a IP adresy, které se mohou připojit k tomuto koncovému bodu.
Poznámka: Tato vlastnost je platná pro koncové body streamování úrovně Standard a Premium a dá se nastavit v případě cdnEnabled:false.
CacheControl StreamingEndpointCacheControl Slouží ke konfiguraci doby života mezipaměti prostředků pro prostředky obsluhované prostřednictvím tohoto koncového bodu streamování.
CrossSiteAccessPolicies CrossSiteAccessPolicies Slouží k určení zásad přístupu mezi lokalitami pro různé klienty. Další informace najdete v tématech Specifikace souboru zásad mezi doménami a Zpřístupnění služby napříč hranicemi domény.

StreamingEndpointCacheControl

Název Typ Description
MaxAge

Nepovinný parametr.
Edm.Int64 Přepíše výchozí hlavičku ovládacího prvku mezipaměti HTTP max-age nastavenou koncovým bodem streamování u fragmentů médií a manifestů na vyžádání. Hodnota se nastaví v sekundách.

StreamingEndpointAccessControl ComplexType

Název Typ Description
Akamai AkamaiAccessControl Řízení přístupu Akamai.
IP IPAccessControl Řízení přístupu k IP adresě.

AkamaiAccessControl

Název Typ Description
AkamaiSignatureHeaderAuthenticationKeyList AkamaiSignatureHeaderAuthenticationKey ComplexType Obsahuje informace o ověřovacích klíčích hlavičky podpisu Akamai.

IPAccessControl

Název Typ Description
Povolit IPRange ComplexType Definuje IP adresy, které se můžou připojit ke koncovému bodu streamování.

Poznámka: Nastavení této hodnoty na hodnotu null umožní připojení všech zdrojových IP adres. Nastavení na prázdný řetězec ("") neumožňuje, aby se nikdo připojil.

AkamaiSignatureHeaderAuthenticationKey ComplexType

Tento typ popisuje nastavení ověřování Akamai G20. Ověřování Akamai je schéma ověřování zpráv s hodnotou hash klíčů. Ověřovací klíč je tajný klíč sdílený sítí CDN Akamai a službou streamování Azure Media Origin. Služba Azure Media Services podporuje pouze verzi 3, která používá HMAC-MD5.

Název Typ Description
Identifier Edm.String Identifikátor ověřovacího klíče. Toto je nonce poskytovaná společností Akamai.
Expiration Edm.DateTime Hodnota DateTime, která určuje, kdy vyprší platnost ověřování Akamai
Base64Key Edm.String Ověřovací klíč s kódováním Base64, který bude používán cdn. Ověřovací klíč, který Akamai poskytuje, je řetězec kódovaný ASCII, který se musí převést na bajty a pak zakódovat base64.

Následující příklad jazyka C# ukazuje, jak převést ověřovací klíč Akamai na base64:

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

IPRange ComplexType

Název Typ Description
Name Edm.String Popisný název pro tento rozsah IP adres.
Address Edm.String Základní IP adresa pro reprezentaci podsítě (například:192.168.0.1).
SubnetPrefixLength Edm.Int32 Počet významných bitů pro masku podsítě (například v následující IP adrese 192.168.0.1/24 24 představuje počet významných bitů).

Vytvoření koncového bodu streamování

Vytvořte novou službu StreamingEndpoint.

Žádost

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
POST <https:// název_účtu.restv2>.<umístění.media.azure.net/api/StreamingEndpoint> HTTP/1.1

Ukázkový požadavek

Následující příklad si můžete vyzkoušet na kartě Fiddlerova skladatele.

Nejnovější verzi najdete v x-ms-version:tématu Media Services REST.

Hlavičky požadavku:

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>  
  

Text požadavku:

{    
   "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>"  
   }  
}  
  

V případě úspěchu se vrátí stavový kód 202 Accepted spolu s reprezentací vytvořené entity v těle odpovědi.

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>"  
   }  
}  
  

Stavový kód 202 Accepted označuje asynchronní operaci. V takovém případě je hodnota hlavičky operation-id k dispozici také pro použití při dotazování a sledování stavu dlouhotrvajících operací, jako je spuštění nebo zastavení StreamingEndpoint. Předáním hodnoty hlavičky operation-id do entity Operation (Operace) načtěte stav. Další informace najdete v tématu Operace ručního dotazování Long-Running.

Spustit koncový bod streamování

Spusťte zadaný koncový bod streamování. Koncový bod streamování se dá spustit, jenom když je ve stavu Zastaveno . Nějakou dobu po spuštění streamovaného bodu se stav změní na Running.
Pokud chcete streamování zastavit později, zavolejte operaci Stop .

Dostupné akce, pokud jsou ve stavu Spuštěno .

Stav Jednotky streamování Description Dostupné akce
Spuštěno 0 Streamování z koncového bodu streamování úrovně Standard. Zastavení, škálování
Spuštěno >0 Streamování z koncového bodu streamování Premium Zastavení, škálování

Žádost

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
POST <https:// název_účtu.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Start HTTP/1.1

Ukázkový požadavek

Následující příklad si můžete vyzkoušet na kartě Fiddlerova skladatele.

Hlavičky požadavku:

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>  
  

V případě úspěchu se vrátí stavový kód 202 Přijato . Stavový kód 202 Accepted označuje asynchronní operaci. V takovém případě je hodnota hlavičky operation-id k dispozici také pro použití při dotazování a sledování stavu dlouhotrvajících operací, jako je spuštění nebo zastavení StreamingEndpoint. Předáním hodnoty hlavičky operation-id do entity Operation (Operace) načtěte stav. Další informace najdete v tématu Operace ručního dotazování Long-Running.

Zastavení streamováníEndpoints

Zastavte zadaný koncový bod streamování. Koncový bod streamování se dá zastavit, jenom když je ve stavu Spuštěno .

Dostupné akce, když jsou ve stavu Zastaveno .

Stav Jednotky streamování Description Dostupné akce
Zastaveno 0 Nestreamuje se. Spuštění, škálování
Zastaveno >0 Nestreamuje se. Spuštění, škálování

Žádost

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
POST <https:// název_účtu.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Stop HTTP/1.1

Ukázkový požadavek

Následující příklad si můžete vyzkoušet na kartě Fiddlerova skladatele.

Nejnovější verzi najdete v x-ms-version:tématu Media Services REST.

Hlavičky požadavku:

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>  
  

V případě úspěchu se vrátí stavový kód 202 Přijato . Stavový kód 202 Accepted označuje asynchronní operaci. V takovém případě je hodnota hlavičky operation-id k dispozici také pro použití při dotazování a sledování stavu dlouhotrvajících operací, jako je spuštění nebo zastavení StreamingEndpoint. Předáním hodnoty hlavičky operation-id do entity Operation (Operace) načtěte stav. Další informace najdete v tématu Operace ručního dotazování Long-Running.

Škálování koncových bodů streamování

Dynamicky aktualizuje kapacitu jednotky streamování ve spuštěném stavu a změní typ z koncového bodu streamování Standard na Koncový bod streamování Premium, pokud je aktualizován z "ScaleUnits":0.

Žádost

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
POST <https:// název_účtu.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Scale HTTP/1.1

Ukázkový požadavek

Následující příklad si můžete vyzkoušet na kartě Fiddlerova skladatele.

Nejnovější verzi najdete v x-ms-version:tématu Media Services REST.

Hlavičky požadavku:

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>  
  

Text požadavku:

{"scaleUnits" : 2}  

V případě úspěchu se vrátí stavový kód 202 Přijato . Stavový kód 202 Accepted označuje asynchronní operaci. V takovém případě je hodnota hlavičky operation-id k dispozici také pro použití při dotazování a sledování stavu dlouhotrvajících operací, jako je spuštění nebo zastavení StreamingEndpoint. Předáním hodnoty hlavičky operation-id do entity Operation (Operace) načtěte stav. Další informace najdete v tématu Operace ručního dotazování Long-Running.

Výpis koncových bodů streamování

Koncové body streamování se načítají pomocí požadavku GET HTTP.

Žádost

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
GET Získejte všechny koncové body streamování:

<https:// název_účtu.restv2>.<umístění.media.azure.net/api/StreamingEndpoints>

Získejte zadaný koncový bod streamování.

<https:// název_účtu.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')
HTTP/1.1

Ukázkový požadavek

Následující příklad si můžete vyzkoušet na kartě Fiddlerova skladatele.

Nejnovější verzi najdete v x-ms-version:tématu Media Services REST.

Hlavičky požadavku:

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>  
  

V případě úspěchu vrátí tato operace stavový kód 200 OK a seznam všech koncových bodů streamování vytvořených ve vašem účtu Media Services.

Aktualizace koncových bodů streamování

Aktualizujte StreamingEndpoint novými hodnotami vlastností. Jedná se o asynchronní operaci, pokud je koncový bod streamování spuštěný a nastavení se změní.

Žádost

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
PATCH/PUT/MERGE

Další informace o těchto operacích najdete v tématu PATCH/PUT/MERGE.
<https:// název_účtu.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') HTTP/1.1

Ukázkový požadavek

Následující příklad si můžete vyzkoušet na kartě Fiddlerova skladatele. Příklad aktualizuje hodnotu MaxAge .

Nejnovější verzi najdete v x-ms-version:tématu Media Services REST.

Hlavičky požadavku:

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>  
  

Text požadavku:

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

Pokud se aktualizace dokončí synchronně, vrátí stavový kód 204 Žádný obsah ; v opačném případě vrátí stavový kód 202 Přijato . Stavový kód 202 Accepted označuje asynchronní operaci. V takovém případě je hodnota hlavičky operation-id k dispozici také pro použití při dotazování a sledování stavu dlouhotrvajících operací, jako je spuštění nebo zastavení StreamingEndpoint. Předáním hodnoty hlavičky operation-id do entity Operation (Operace) načtěte stav. Další informace najdete v tématu Operace ručního dotazování Long-Running.

Odstranit koncové body streamování

Odstraňte koncový bod streamování. Koncový bod streamování se dá odstranit jenom tehdy, když je ve stavu Zastaveno .

Žádost

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
DELETE <https:// název_účtu.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') HTTP/1.1

Ukázkový požadavek

Následující příklad si můžete vyzkoušet na kartě Fiddlerova skladatele.

Nejnovější verzi najdete v x-ms-version:tématu Media Services REST.

Hlavičky požadavku:

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>  
  

V případě úspěchu se vrátí stavový kód 202 Přijato . Stavový kód 202 Accepted označuje asynchronní operaci. V takovém případě je hodnota hlavičky operation-id k dispozici také pro použití při dotazování a sledování stavu dlouhotrvajících operací, jako je spuštění nebo zastavení StreamingEndpoint. Předáním hodnoty hlavičky operation-id do entity Operation (Operace) načtěte stav. Další informace najdete v tématu Operace ručního dotazování Long-Running.

Viz také

Kanál
Program
Operace