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.