StreamingEindpunt
Belangrijk
Vanaf Media Services 2.7 is de naam van de Origin entiteit gewijzigd in StreamingEndpoint.
De StreamingEndpoint entiteit vertegenwoordigt een streamingservice die inhoud rechtstreeks aan een clientspelertoepassing of aan een CDN (Content Delivery Network) kan leveren voor verdere distributie. Vanaf versie 2.9 biedt Microsoft Azure Media Services de Azure CDN-integratie (zie de CdnEnabled eigenschap die hieronder wordt beschreven voor meer informatie). De uitgaande stream van een StreamingEndpoint-service kan een livestream of een video-on-demand asset in uw Media Services-account zijn.
Elk AMS-account (Azure Media Services) bevat een standaard StreamingEndpoint; extra StreamingEndpoints kunnen worden gemaakt onder het account. Vanaf Media Services 2.15 (uitgebracht op 10 januari 2017) zijn er twee StreamingEndpoint-versies: 1.0 en 2.0. Er zijn ook drie typen StreamingEndpoints: Classic, **Standard of Premium.
Media Services-accounts die zijn gemaakt vóór de update van AMS REST 2.15, bevatten standaard klassieke streaming-eindpunten, versie 1.0. U kunt upgraden naar versie 2.0, u kunt niet downgraden naar 1.0. AMS-accounts die zijn gemaakt na de update 2.15, bevatten standaard Standard-streaming-eindpunten, versie 2.0. Streaming-eindpunten van versie 2.0 hebben wijzigingen in facturering en functies. Zie de StreamingEndpointVersion eigenschap die hieronder wordt beschreven voor meer gedetailleerde informatie.
Het automatisch ingerichte StreamingEndpoint heeft de naam 'Default' en kan niet worden verwijderd. De status van het StreamingEndpoint is Gestopt. Als u wilt beginnen met streamen, moet u het streaming-eindpunt starten.
Als u het account hebt gemaakt via de klassieke Azure-portal en Azure CDN beschikbaar is in de regio, heeft het account standaard de CDN-integratie ("CdnEnabled":true, "CdnProvider":StandardVerizon en "CdnProfile":AzureMediaStreamingPlatformCdnProfile).
In de meeste gevallen moet u CDN ingeschakeld laten. Als u echter een maximale gelijktijdigheid verwacht van minder dan 500 kijkers, dan wordt het aanbevolen CDN uit te schakelen, omdat CDN het beste schaalt met gelijktijdigheid.
Overzicht van klassieke, Standard- en Premium-streaming-eindpunten
Geavanceerde functies die in deze sectie worden beschreven, zijn onder andere dynamische pakketten en dynamische versleuteling.
De tabel bevat een overzicht van het gedrag:
| Type | Versie | ScaleUnits | Geavanceerde functies | CDN | Billing |
|---|---|---|---|---|---|
| Klassiek | 1.0 | 0 | NA | NA | Gratis |
| Standaard streaming-eindpunt (aanbevolen) | 2,0 | 0 | Ja | Ja | Betaald |
| Premium-streaming-eindpunt | 1.0 | > 0 | Ja | Ja | Betaald |
| Premium-streaming-eindpunt | 2,0 | > 0 | Ja | Ja | Betaald |
Het wordt aanbevolen om uw klassieke streaming-eindpunten te upgraden naar Standard-streaming-eindpunten voor een betere ervaring en geavanceerde functies. Standaardstreaming schaalt ook de uitgaande bandbreedte automatisch.
Het Standard-type is de aanbevolen optie voor nagenoeg alle streaming-scenario's en doelgroepgrootten. Voor klanten met zeer veeleisende vereisten biedt AMS ook Premium-streaming-eindpunten, die kunnen worden gebruikt om de capaciteit uit te breiden voor de grootste internetpublieken. Als u grote doelgroepen en gelijktijdige kijkers verwacht, neem dan contact met ons op voor hulp over of u moet overstappen op het Premium-type . Een goede gidspost is om contact met ons op te neemt (amsstreaming op microsoft.com) als u een gelijktijdige doelgroep groter dan 50.000 kijkers verwacht.
U gaat over naar een Premium-type door schaaleenheden aan te passen. Schaaleenheden bieden u een toegewezen capaciteit voor uitgaand verkeer die kan worden aangeschaft in stappen van 200 Mbps. Bij gebruik van het Premium-type biedt elke ingeschakelde eenheid extra bandbreedte voor de toepassing. Zie StreamingEindpunt schalen voor meer informatie.
Zie Streaming endpoints overview (Overzicht van streaming-eindpunten) voor meer informatie.
StreamingEndpoint-eigenschappen en -bewerkingen
Belangrijk
Bij het openen van entiteiten in Media Services moet u specifieke headervelden en -waarden instellen in uw HTTP-aanvragen.
Zie Setup for Media Services REST API Development and Connect to Media Services with the Media Services REST API (Verbinding maken met Media Services met de Media Services REST API) voor meer informatie.
Deze sectie geeft een overzicht van de StreamingEndpoint entiteit en laat ook zien hoe u verschillende bewerkingen uitvoert met de Media Services REST API.
StreamingEndpoint-entiteit
De StreamingEndpoint entiteit bevat de volgende eigenschappen:
| Eigenschap | Type | Beschrijving |
|---|---|---|
IdAlleen-lezen. Ingesteld door Media Services. |
Edm.String | De StreamingEndpoint-id, toegewezen bij het maken. De indeling is: nb:oid:UUID:<GUID>. |
Name |
Edm.String | Beschrijvende naam voor de StreamingEndpoint-service. - Moet uniek zijn binnen uw Media Services-account. - Maximale lengte = 32 tekens. - Mag geen spaties bevatten. - Alleen afbreekstreepjes en alfanumerieke tekens. - Kan niet beginnen of eindigen met een afbreekstreepje. |
Description |
Edm.String | Beschrijving van het StreamingEndpoint. De maximale lengte is 256 tekens. |
CreatedAlleen-lezen. Ingesteld door Media Services. |
Edm.DateTime | Gemaakt door de Microsoft Azure Media Services Live Streaming Preview-service. |
StateAlleen-lezen. Ingesteld door Media Services. |
Edm.Int32 | Waarden voor de eigenschap zijn onder andere: -Gestopt. De initiële status van een StreamingEndpoint na het maken. -Beginnen. Het StreamingEndpoint gaat over naar de actieve status. -Met. StreamingEndpoint kan inhoud naar clients streamen. -Schalen. De streaming-eenheden (ScaleUnits) worden verhoogd of verlaagd. -Stoppen. Het StreamingEndpoint gaat over naar de status Gestopt. |
HostNameAlleen-lezen. Ingesteld door Media Services. |
Edm.String | Hostnaam van standaardstreaming-eindpunt. |
LastModifiedAlleen-lezen. Ingesteld door Media Services. |
Edm.DateTime | Tijdstip van laatste update voor deze entiteit. |
ScaleUnitsAlleen-lezen. |
Edm.Int32 | Het aantal premium streaming-eindpunten dat is toegewezen voor de StreamingEndpoint-implementatie. Wanneer het StreamingEndpoint de Running status heeft, kunnen de streaming-eenheden op het StreamingEndpoint omhoog worden geschaald door de Scale bewerking aan te roepen.Deze eigenschap bepaalt ook het type streaming-eindpunt met de combinatie van de versie van het streaming-eindpunt. Als uw streaming-eindpuntversie 1.0 en ScaleUnits=0 is, is het streaming-eindpunt van een klassiek type. De volgende eigenschappen van StreamingEndpoint kunnen alleen worden geconfigureerd als uw streaming-eindpunt Standard of Premium is: AccessControl, CustomHostNames, CacheControl, CrossSiteAccessPolicies. |
CdnEnabledDeze eigenschap is toegevoegd in Media Services 2.9. |
Edm.Boolean |
Hiermee wordt aangegeven of de Azure CDN-integratie voor dit StreamingEndpoint is ingeschakeld (standaard uitgeschakeld). Als u de CdnEnabled wilt instellen op true, moet het StreamingEndpoint ten minste één premium streaming-eindpunt (ScaleUnits) hebben voor versie 1.0 StreamingEndpoints en de status Gestopt hebben. U kunt deze eigenschap instellen als de StreamingEndpoint-versie 2.0 is, ongeacht de ScaleUnits-waarde (raadpleeg standaardstreamingseindpunt). Gebruik de REST API voor bewerkingen om de status te controleren. Zodra deze is ingeschakeld, worden de volgende configuraties uitgeschakeld: CustomHostNames en AccessControl.Opmerking: niet alle datacenters ondersteunen de Azure CDN-integratie. Ga als volgt te werk om te controleren of voor uw datacenter de Azure CDN-integratie beschikbaar is: - Probeer de CdnEnabled in te stellen op true.- Controleer het geretourneerde resultaat voor een HTTP Error Code 412 (PreconditionFailed) met het bericht 'De eigenschap CdnEnabled voor streaming-eindpunt kan niet worden ingesteld op true omdat CDN-mogelijkheid niet beschikbaar is in de huidige regio'.Als u deze fout krijgt, wordt deze niet ondersteund door het datacenter. Probeer een ander datacenter. |
CdnProviderDeze eigenschap is toegevoegd in Media Services 2.15. |
Edm.String | Wanneer CDN is ingeschakeld ("CdnEnabled":true), kunt u ook CdnProvider-waarden doorgeven. CdnProvider bepaalt welke provider wordt gebruikt. Momenteel worden drie waarden ondersteund: 'StandardVerizon', 'PremiumVerizon' en 'StandardAkamai'. Als er geen waarde wordt opgegeven en 'CdnEnabled':true, 'StandardVerizon' wordt gebruikt (dat is de standaardwaarde.) Voorbeeld: "CdnProvider":"StandardAkamai". Opmerking: StreamingEndpoints, die "CDNEnabled":true zijn met oudere AMS-versies (<2.15), heeft een verouderde CDN-integratie en maakt gebruik van de CDN-provider StandardVerizon. Het wordt aanbevolen om uw StreamingEndpoints te migreren naar de nieuwere CDN-integratie om een betere ervaring en volledige functie te krijgen. |
CdnProfileDeze eigenschap is toegevoegd in Media Services 2.15. |
Edm.String | Wanneer CDN is ingeschakeld ("CdnEnabled":true), kunt u ook CdnProfile-waarden doorgeven. 'CdnProfile' is de naam van het CDN-profiel waarin het CDN-eindpuntpunt wordt gemaakt. U kunt een bestaand CdnProfile opgeven of een nieuw bestand gebruiken. Als waarde NULL en CdnEnabled:true is, wordt de standaardwaarde AzureMediaStreamingPlatformCdnProfile gebruikt. Als het opgegeven CdnProfile al bestaat, wordt er een eindpunt onder gemaakt. Als het profiel niet bestaat, wordt er automatisch een nieuw profiel gemaakt. Voorbeeld: "CdnProfile":"AzureMediaStreamingPlatformCdnProfile". |
FreeTrialEndTimeAlleen-lezen. Deze eigenschap is toegevoegd in Media Services 2.15. |
Edm.DateTime | Wanneer een nieuw Media Services-account wordt gemaakt, wordt er ook automatisch een standaardstreaming-eindpunt ingericht onder het account, met de status Gestopt. Dit eindpunt omvat een gratis proefperiode van 15 dagen en de proefperiode begint wanneer het eindpunt voor de eerste keer wordt gestart. De gratis proefversie is niet van toepassing op bestaande accounts en de einddatum verandert niet met statusovergangen zoals stoppen/starten. De gratis proefversie start de eerste keer dat u het streaming-eindpunt start en eindigt na 15 kalenderdagen. De gratis proefversie is alleen van toepassing op het standaardstreaming-eindpunt en niet op aanvullende streaming-eindpunten. Wanneer het eindpunt zojuist is gemaakt en de status Gestopt heeft, wordt de waarde van 'FreeTrialEndTime' ingesteld op '0001-01-01T00:00:00Z'. Wanneer deze is gestart, worden 15 dagen toegevoegd aan de begindatum en begint de waarde voor de einddatum van de gratis proefversie "FreeTrialEndTime":"2016-12-16T18:01:47.8524725Z". Waarden voor streaming-eindpunten die niet in aanmerking komen voor een gratis proefversie, zijn altijd FreeTrialEndTime:"0001-01-01T00:00:00Z", ongeacht de status. Voorbeelden: "FreeTrialEndTime":"2016-12-16T18:01:47.8524725Z" "FreeTrialEndTime":"0001-01-01T00:00:00Z" |
StreamingEndpointVersionDeze eigenschap is toegevoegd in Media Services 2.15. |
Edm.String | De combinatie van StreamingEndpointVersion en ScaleUnits bepaalt het type streaming-eindpunt. Elk streaming-eindpunt dat is gemaakt vóór de update van 2.15 (10 januari 2017), heeft StreamingEndpointVersion:"1.0" en streaming-eindpunten die na de update zijn gemaakt, hebben StreamingEndpointVersion:"2.0". Streaming-eindpunten, die versie 1.0 zijn, worden niet automatisch bijgewerkt naar versie 2.0, maar kunnen expliciet worden bijgewerkt naar StreamingEndpointVersion:"2.0". Streaming-eindpunten met 'ScaleUnits':0 en StreamingEndpointVersion:"1.0" worden beschouwd als klassieke streaming-eindpunten, die niet over de geavanceerde functies beschikken, zoals dynamische pakketten of dynamische versleuteling. Streaming-eindpunten met ScaleUnits > 0 (ongeacht of de StreamingEndpointVersion is ingesteld op versie 1.0 of versie 2.0) zijn Premium-eenheden . Standaardstreaming-eindpunten met 'ScaleUnits':0 en "StreamingEndpointVersion":"2.0" bevatten dezelfde functies als premium-eenheden (waaronder dynamische pakketten en dynamische versleuteling.) U kunt een klassiek streaming-eindpunt upgraden naar standaard door de versie in te stellen op StreamingEndpointVersion:"2.0". Dit is eenrichtingsoperatie; u kunt versie 2.0 niet downgraden naar 1.0. Pas op dat deze bewerking niet kan worden teruggedraaid en invloed heeft op de prijzen. Het kan tot 30 minuten duren voordat deze nieuwe configuratie is doorgegeven. Tijdens deze periode werkt het eindpunt in de gedegradeerde modus en kunnen er fouten optreden voor dynamische pakketten en dynamische versleutelingsaanvragen. Voorbeelden: "StreamingEndpointVersion":"2.0" "StreamingEndpointVersion":"1.0" |
CustomHostNamesOptioneel. |
Collection(EDM.String) | Wordt gebruikt om een streaming-eindpunt te configureren voor het accepteren van verkeer dat is omgeleid naar een aangepaste hostnaam. Dit maakt een eenvoudigere configuratie van verkeerbeheer via een Global Traffic Manager (GTM) mogelijk en ook voor domeinnamen met een huisstijl die als de naam van het streaming-eindpunt kunnen worden gebruikt. Het eigendom van de domeinnaam moet worden bevestigd door Azure Media Services. Azure Media Services verifieert het eigendom van de domeinnaam door te vereisen dat een CName record met de Azure Media Services-account-id als onderdeel wordt toegevoegd aan het domein dat in gebruik is. Als u bijvoorbeeld 'sports.contoso.com' wilt gebruiken als een aangepaste hostnaam voor het streaming-eindpunt, moet een record voor '<accountId.contoso.com>' worden geconfigureerd om te verwijzen naar een van de hostnamen voor Media Services-verificatie. De naam van de verificatiehost bestaat uit verifydns.<mediaservices-dns-zone>. De volgende tabel bevat de verwachte DNS-zones die moeten worden gebruikt in de controlerecord voor verschillende Azure-regio's.Noord-Amerika, Europa, Singapore, Hongkong, Japan: - mediaservices.windows.net - verifydns.mediaservices.windows.net China: - mediaservices.chinacloudapi.cn - verifydns.mediaservices.chinacloudapi.cn Een record die bijvoorbeeld '945a4c4e-28ea-45cd-8ccb-a519f6b700ad.contoso.com' aan 'verifydns.mediaservices.windows.net' toewijst, CName bewijst dat de Azure Media Services-id 945a4c4e-28ea-45cd-8ccb-a519f6b700ad het eigendom heeft van het contoso.com-domein, waardoor elke naam onder contoso.com kan worden gebruikt als een aangepaste hostnaam voor een streaming-eindpunt onder dat account.Als u de waarde van de Media Service-id wilt vinden, gaat u naar de Azure Portal en selecteert u uw Media Service-account. De MEDIA SERVICE-id wordt rechts van de pagina DASHBOARD weergegeven. Waarschuwing: als er een poging wordt uitgevoerd om een aangepaste hostnaam in te stellen zonder de juiste verificatie van de CName record, mislukt het DNS-antwoord en wordt het vervolgens enige tijd in de cache opgeslagen. Zodra een juiste record is ingesteld, kan het even duren voordat het antwoord in de cache opnieuw wordt gevalideerd. Afhankelijk van de DNS-provider voor het aangepaste domein, kan het een paar minuten tot een uur duren voordat de record opnieuw wordt gevalideerd.Naast de CName die wordt toegewezen <accountId>.<parent domain> aan verifydns.<mediaservices-dns-zone>, moet u een andere CName maken waarmee de aangepaste hostnaam (bijvoorbeeld sports.contoso.com) wordt toegewezen aan de hostnaam van uw Media Services StreamingEndpont (bijvoorbeeld amstest.streaming.mediaservices.windows.net).Opmerking: streaming-eindpunten die zich in hetzelfde datacenter bevinden, kunnen niet dezelfde aangepaste hostnaam delen. Deze eigenschap is geldig voor Standard- en Premium-streaming-eindpunten en kan worden ingesteld wanneer 'CdnEnabled':false Houd er rekening mee dat AMS momenteel geen ondersteuning biedt voor SSL met aangepaste domeinen. |
AccessControl |
StreamingEndpointAccessControl ComplexType | Wordt gebruikt voor het configureren van de volgende beveiligingsinstellingen voor dit streaming-eindpunt: Verificatiesleutels voor Akamai-headers en IP-adressen die verbinding mogen maken met dit eindpunt. Opmerking: deze eigenschap is geldig voor Standard- en Premium-streaming-eindpunten en kan worden ingesteld wanneer 'CdnEnabled':false |
CacheControl |
StreamingEndpointCacheControl | Wordt gebruikt om de levensduur van de assetcache te configureren voor assets die via dit streaming-eindpunt worden geleverd. |
CrossSiteAccessPolicies |
CrossSiteAccessPolicies | Wordt gebruikt om toegangsbeleid voor meerdere sites voor verschillende clients op te geven. Zie Bestandsspecificatie voor meerdere domeinen en Een service beschikbaar maken tussen domeingrenzen voor meer informatie. |
StreamingEndpointCacheControl
| Naam | Type | Beschrijving |
|---|---|---|
MaxAgeOptioneel. |
Edm.Int64 | Overschrijft de standaard koptekst voor http-cachebeheer die is ingesteld door het streaming-eindpunt voor mediafragmenten en manifesten op aanvraag. De waarde wordt ingesteld in seconden. |
StreamingEndpointAccessControl ComplexType
| Naam | Type | Beschrijving |
|---|---|---|
Akamai |
AkamaiAccessControl | Akamai-toegangsbeheer. |
IP |
IPAccessControl | IP-toegangsbeheer. |
AkamaiAccessControl
| Naam | Type | Beschrijving |
|---|---|---|
| AkamaiSignatureHeaderAuthenticationKeyList | AkamaiSignatureHeaderAuthenticationKey ComplexType | Bevat informatie over Akamai Signature Header Authentication-sleutels. |
IPAccessControl
| Naam | Type | Beschrijving |
|---|---|---|
| Toestaan | IPRange ComplexType | Definieert de IP-adressen die verbinding kunnen maken met een streaming-eindpunt. Opmerking: als u deze waarde instelt op null, kunnen alle IP-bronadressen verbinding maken. Als u deze instelt op een lege tekenreeks ("") kan niemand verbinding maken. |
AkamaiSignatureHeaderAuthenticationKey ComplexType
Dit type beschrijft de akamai G20-verificatie-instellingen. Akamai-verificatie is een verificatieschema voor berichten met een sleutel-hash. De verificatiesleutel is een geheim dat wordt gedeeld door de Akamai CDN en de Azure Media Origin Streaming Service. Azure Media Services ondersteunt alleen versie 3, die gebruikmaakt van HMAC-MD5.
| Naam | Type | Description |
|---|---|---|
Identifier |
Edm.String | De id voor de verificatiesleutel. Dit is de nonce van Akamai. |
Expiration |
Edm.DateTime | DateTime-waarde die aangeeft wanneer de Akamai-verificatie verloopt |
Base64Key |
Edm.String | Base64-gecodeerde verificatiesleutel die wordt gebruikt door het CDN. De verificatiesleutel die door Akamai wordt geleverd, is een ASCII-gecodeerde tekenreeks en moet worden geconverteerd naar bytes en vervolgens met base64 worden gecodeerd. |
In het volgende C#-voorbeeld ziet u hoe u de Akamai-verificatiesleutel converteert naar base64:
string akamaiKey = "01234567890123456789012345678901";
string base64Key = Convert.ToBase64String(System.Text.Encoding.ASCII.GetBytes(akamaiKey);
IPRange ComplexType
| Naam | Type | Description |
|---|---|---|
Name |
Edm.String | Een beschrijvende naam voor dit IP-bereik. |
Address |
Edm.String | Het basis-IP-adres voor de subnetweergave (bijvoorbeeld:192.168.0.1). |
SubnetPrefixLength |
Edm.Int32 | Het aantal significante bits voor het subnetmasker (bijvoorbeeld in het volgende IP-adres 192.168.0.1/24 vertegenwoordigt 24 het aantal significante bits). |
StreamingEndpoint maken
Maak een nieuwe StreamingEndpoint-service.
Aanvraag
| Methode | Aanvraag-URI | HTTP-versie |
|---|---|---|
| POST | <https:// accountnaam.restv2>.<location.media.azure.net/api/StreamingEndpoint> | HTTP/1.1 |
Voorbeeldaanvraag
U kunt het volgende voorbeeld uitproberen op het tabblad Componist van Fiddler.
Zie Media Services REST voor de meest recente x-ms-version:versie.
Aanvraagheaders:
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>
Aanvraagtekst:
{
"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>"
}
}
Als dit lukt, wordt de statuscode 202 Geaccepteerd geretourneerd, samen met een weergave van de gemaakte entiteit in de antwoordtekst.
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>"
}
}
De statuscode 202 Geaccepteerd geeft een asynchrone bewerking aan. In dat geval wordt de waarde van de header operation-id ook opgegeven voor het pollen en bijhouden van de status van langlopende bewerkingen, zoals het starten of stoppen van een StreamingEndpoint. Geef de waarde van de header operation-id door aan de bewerkingsentiteit om de status op te halen. Zie Handmatig polling Long-Running bewerkingen voor meer informatie.
StreamingEindpunt starten
Start het opgegeven StreamingEndpoint. Een StreamingEndpoint kan alleen worden gestart wanneer het de status Gestopt heeft. Enige tijd na het starten van het StreamingEdpoint verandert de status in Running.
Als u het streamen op een later tijdstip wilt stoppen, roept u de stopbewerking aan.
Beschikbare acties in de status Wordt uitgevoerd .
| Staat | Streaming-eenheden | Beschrijving | Beschikbare acties |
|---|---|---|---|
| Wordt uitgevoerd | 0 | Streamen vanaf standard streaming-eindpunt. | Stoppen, schalen |
| Wordt uitgevoerd | > 0 | Streamen vanaf Premium Streaming-eindpunt. | Stoppen, schalen |
Aanvraag
| Methode | Aanvraag-URI | HTTP-versie |
|---|---|---|
| POST | <https:// accountnaam.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Start | HTTP/1.1 |
Voorbeeldaanvraag
U kunt het volgende voorbeeld uitproberen op het tabblad Componist van Fiddler.
Aanvraagheaders:
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>
Als dit lukt, wordt de statuscode 202 Geaccepteerd geretourneerd. De statuscode 202 Geaccepteerd geeft een asynchrone bewerking aan. In dat geval wordt de waarde van de header operation-id ook opgegeven voor het pollen en bijhouden van de status van langlopende bewerkingen, zoals het starten of stoppen van een StreamingEndpoint. Geef de waarde van de header operation-id door aan de bewerkingsentiteit om de status op te halen. Zie Handmatig polling Long-Running bewerkingen voor meer informatie.
StreamingEindpunten stoppen
Stop het opgegeven StreamingEndpoint. Een StreamingEndpoint kan alleen worden gestopt wanneer het de status Actief heeft.
Beschikbare acties in de status Gestopt .
| Staat | Streaming-eenheden | Beschrijving | Beschikbare acties |
|---|---|---|---|
| Gestopt | 0 | Niet streamen. | Starten, schalen |
| Gestopt | > 0 | Niet streamen. | Starten, schalen |
Aanvraag
| Methode | Aanvraag-URI | HTTP-versie |
|---|---|---|
| POST | <https:// accountnaam.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Stop | HTTP/1.1 |
Voorbeeldaanvraag
U kunt het volgende voorbeeld uitproberen op het tabblad Componist van Fiddler.
Zie Media Services REST voor de meest recente x-ms-version:versie.
Aanvraagheaders:
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>
Als dit lukt, wordt de statuscode 202 Geaccepteerd geretourneerd. De statuscode 202 Geaccepteerd geeft een asynchrone bewerking aan. In dat geval wordt de waarde van de header operation-id ook opgegeven voor het pollen en bijhouden van de status van langlopende bewerkingen, zoals het starten of stoppen van een StreamingEndpoint. Geef de waarde van de header operation-id door aan de bewerkingsentiteit om de status op te halen. Zie Handmatig polling Long-Running bewerkingen voor meer informatie.
StreamingEndpoints schalen
Hiermee wordt de capaciteit van de streaming-eenheid dynamisch bijgewerkt terwijl deze actief is en verandert het type van Standard Streaming-eindpunt in Premium Streaming-eindpunt als deze wordt bijgewerkt vanuit 'ScaleUnits':0.
Aanvraag
| Methode | Aanvraag-URI | HTTP-versie |
|---|---|---|
| POST | <https:// accountnaam.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Scale | HTTP/1.1 |
Voorbeeldaanvraag
U kunt het volgende voorbeeld uitproberen op het tabblad Componist van Fiddler.
Zie Media Services REST voor de meest recente x-ms-version:versie.
Aanvraagheaders:
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>
Aanvraagtekst:
{"scaleUnits" : 2}
Als dit lukt, wordt de statuscode 202 Geaccepteerd geretourneerd. De statuscode 202 Geaccepteerd geeft een asynchrone bewerking aan. In dat geval wordt de waarde van de header operation-id ook opgegeven voor het pollen en bijhouden van de status van langlopende bewerkingen, zoals het starten of stoppen van een StreamingEndpoint. Geef de waarde van de header operation-id door aan de bewerkingsentiteit om de status op te halen. Zie Handmatig polling Long-Running bewerkingen voor meer informatie.
StreamingEindpunten weergeven
StreamingEndpoints worden opgehaald met behulp van een GET HTTP-aanvraag.
Aanvraag
| Methode | Aanvraag-URI | HTTP-versie |
|---|---|---|
| GET | Alle StreamingEndpoints ophalen: <https:// accountnaam.restv2>.<location.media.azure.net/api/StreamingEndpoints> Haal het opgegeven StreamingEndpoint op. <https:// accountnaam.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') |
HTTP/1.1 |
Voorbeeldaanvraag
U kunt het volgende voorbeeld uitproberen op het tabblad Componist van Fiddler.
Zie Media Services REST voor de meest recente x-ms-version:versie.
Aanvraagheaders:
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>
Als dit lukt, retourneert deze bewerking een statuscode 200 OK en een lijst met alle StreamingEndpoints die in uw Media Services-account zijn gemaakt.
StreamingEndpoints bijwerken
Werk een StreamingEndpoint bij met nieuwe eigenschapswaarden. Dit is een asynchrone bewerking als het StreamingEndpoint wordt uitgevoerd en de instellingen worden gewijzigd.
Aanvraag
| Methode | Aanvraag-URI | HTTP-versie |
|---|---|---|
| PATCH/PUT/MERGE Zie PATCH/PUT/MERGE voor meer informatie over deze bewerkingen. |
<https:// accountnaam.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') | HTTP/1.1 |
Voorbeeldaanvraag
U kunt het volgende voorbeeld uitproberen op het tabblad Componist van Fiddler. In het voorbeeld wordt de waarde MaxAge bijgewerkt .
Zie Media Services REST voor de meest recente x-ms-version:versie.
Aanvraagheaders:
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>
Aanvraagtekst:
{"CacheControl":{"MaxAge":"2000"}}
Als de update synchroon wordt voltooid, wordt de statuscode 204 Geen inhoud geretourneerd; anders wordt de statuscode 202 Geaccepteerd geretourneerd. De statuscode 202 Geaccepteerd geeft een asynchrone bewerking aan. In dat geval wordt de waarde van de header operation-id ook opgegeven voor het pollen en bijhouden van de status van langlopende bewerkingen, zoals het starten of stoppen van een StreamingEndpoint. Geef de waarde van de header operation-id door aan de bewerkingsentiteit om de status op te halen. Zie Handmatig polling Long-Running bewerkingen voor meer informatie.
StreamingEndpoints verwijderen
Verwijder een StreamingEndpoint. Een StreamingEndpoint kan alleen worden verwijderd wanneer het de status Gestopt heeft.
Aanvraag
| Methode | Aanvraag-URI | HTTP-versie |
|---|---|---|
| DELETE | <https:// accountnaam.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') | HTTP/1.1 |
Voorbeeldaanvraag
U kunt het volgende voorbeeld uitproberen op het tabblad Componist van Fiddler.
Zie Media Services REST voor de meest recente x-ms-version:versie.
Aanvraagheaders:
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>
Als dit lukt, wordt de statuscode 202 Geaccepteerd geretourneerd. De statuscode 202 Geaccepteerd geeft een asynchrone bewerking aan. In dat geval wordt de waarde van de header operation-id ook opgegeven voor het pollen en bijhouden van de status van langlopende bewerkingen, zoals het starten of stoppen van een StreamingEndpoint. Geef de waarde van de header operation-id door aan de bewerkingsentiteit om de status op te halen. Zie Handmatig polling Long-Running bewerkingen voor meer informatie.