StreamingEndpoint
Wichtig
Ab Media Services 2.7 heißt die Entität OriginStreamingEndpoint.
Die Entität StreamingEndpoint stellt einen Streamingdienst dar, der Inhalte direkt an eine Clientplayeranwendung oder an ein Netzwerk für die Inhaltsübermittlung (Content Delivery Network, CDN) für die weitere Bereitstellung übermitteln kann. Ab Version 2.9 stellt Microsoft Azure Media Services die Azure CDN-Integration bereit (weitere Informationen finden Sie in der CdnEnabled unten dokumentierten Eigenschaft). Der ausgehende Stream eines StreamingEndpoint-Diensts kann ein Livestream oder ein Video-On-Demand-Objekt in Ihrem Media Services-Konto sein.
Jedes Azure Media Services-Konto (AMS) enthält einen StreamingEndpoint-Standardkonto. Unter dem Konto können zusätzliche StreamingEndpoints erstellt werden. Ab Media Services 2.15 (veröffentlicht am 10. Januar 2017) gibt es zwei StreamingEndpoint-Versionen: 1.0 und 2.0. Außerdem gibt es drei Arten von StreamingEndpoints: Klassisch, **Standard oder Premium.
Media Services-Konten, die vor dem AMS REST 2.15-Update erstellt wurden, enthalten standardmäßig klassische Streamingendpunkte, Version 1.0. Sie können ein Upgrade auf Version 2.0 durchführen, sie können kein Downgrade auf 1.0 durchführen. AMS-Konten, die nach dem Update 2.15 erstellt wurden, enthalten standardmäßig Standard-Streamingendpunkte, Version 2.0. Streamingendpunkte der Version 2.0 weisen Abrechnungs- und Featureänderungen auf. Ausführlichere Informationen finden Sie in der StreamingEndpointVersion unten dokumentierten Eigenschaft.
Der automatisch bereitgestellte StreamingEndpoint hat den Namen "Standard" und kann nicht gelöscht werden. Der Status des StreamingEndpoints ist Beendet. Zum Starten des Streamings müssen Sie den Streamingendpunkt starten.
Wenn Sie das Konto über das klassische Azure-Portal erstellt haben und Azure CDN in der Region verfügbar ist, verfügt das Konto standardmäßig über die CDN-Integration ("CdnEnabled":true, "CdnProvider":StandardVerizon und "CdnProfile":AzureMediaStreamingPlatformCdnProfile).
In den meisten Fällen sollten Sie CDN aktiviert lassen. Wenn Sie jedoch von einer maximalen Parallelität von weniger als 500 Benutzern ausgehen, wird empfohlen, das CDN zu deaktivieren, da sich das CDN am besten mit Parallelität skalieren lässt.
Übersicht über klassische, Standard- und Premium-Streamingendpunkte
Zu den in diesem Abschnitt beschriebenen erweiterten Features gehören dynamisches Verpacken und dynamische Verschlüsselung.
Die folgende Tabelle fasst dieses Verhalten zusammen:
| type | Version | ScaleUnits | Erweiterte Funktionen | CDN | Abrechnung |
|---|---|---|---|---|---|
| Klassisch | 1.0 | 0 | Nicht verfügbar | Nicht verfügbar | Kostenlos |
| Standard-Streamingendpunkt (empfohlen) | 2.0 | 0 | Ja | Ja | Kostenpflichtig |
| Premium-Streamingendpunkt | 1.0 | >0 | Ja | Ja | Kostenpflichtig |
| Premium-Streamingendpunkt | 2.0 | >0 | Ja | Ja | Kostenpflichtig |
Es wird empfohlen, Ihre klassischen Streamingendpunkte auf Standard-Streamingendpunkte zu aktualisieren, um eine bessere Benutzererfahrung und erweiterte Features zu erhalten. Standardstreaming skaliert auch die ausgehende Bandbreite automatisch.
Der Standard-Typ ist die empfohlene Option für nahezu alle Streamingszenarien und Zielgruppengrößen. Für Kunden mit extrem hohen Anforderungen bietet AMS auch Premium-Streamingendpunkte an, mit denen die Kapazität für die größte Internet-Zielgruppe skaliert werden kann. Wenn Sie eine große Zielgruppe und gleichzeitige Viewer erwarten, wenden Sie sich bitte an uns, um eine Anleitung zu erhalten, ob Sie zum Premium-Typ wechseln müssen. Ein guter Leitfadenbeitrag ist, uns zu kontaktieren (amsstreaming bei microsoft.com), wenn Sie eine gleichzeitige Zielgruppengröße von mehr als 50.000 Zuschauern erwarten.
Sie wechseln zu einem Premium-Typ , indem Sie Skalierungseinheiten anpassen. Skalierungseinheiten bieten Ihnen dedizierte Ausgangskapazität, die in Schritten von 200 MBit/s erworben werden kann. Bei Verwendung des Premium-Typs stellt jede aktivierte Einheit zusätzliche Bandbreitenkapazität für die Anwendung bereit. Weitere Informationen finden Sie unter Skalieren von StreamingEndpoint.
Weitere Informationen finden Sie unter Übersicht über Streamingendpunkte.
StreamingEndpoint-Eigenschaften und -Vorgänge
Wichtig
Wenn Sie in Media Services auf Entitäten zugreifen, müssen Sie bestimmte Headerfelder und Werte in Ihren HTTP-Anforderungen festlegen.
Weitere Informationen finden Sie unter Einrichten der Media Services-REST-API-Entwicklung und Herstellen einer Verbindung mit Media Services mit der Media Services-REST-API.
Dieser Abschnitt bietet eine Übersicht über die StreamingEndpoint Entität und zeigt auch, wie verschiedene Vorgänge mit der Media Services-REST-API ausgeführt werden.
Entität "StreamingEndpoint"
Die StreamingEndpoint Entität enthält die folgenden Eigenschaften:
| Eigenschaft | type | BESCHREIBUNG |
|---|---|---|
IdSchreibgeschützt. Wird von Media Services festgelegt. |
Edm.String | Die StreamingEndpoint-ID, die bei der Erstellung zugeordnet wird. Das Format lautet: nb:oid:UUID:<GUID>. |
Name |
Edm.String | Anzeigename für den "StreamingEndpoint"-Dienst. – Muss innerhalb Ihres Media Services-Kontos eindeutig sein. - Maximale Länge = 32 Zeichen. – Keine Leerzeichen enthalten. - Nur Bindestriche und alphanumerische Zeichen. – Kann nicht mit einem Bindestrich beginnen oder enden. |
Description |
Edm.String | Eine Beschreibung des "StreamingEndpoint". Die maximale Länge beträgt 256 Zeichen. |
CreatedSchreibgeschützt. Wird von Media Services festgelegt. |
Edm.DateTime | Erstellt vom Microsoft Azure Media Services Live Streaming Preview-Dienst. |
StateSchreibgeschützt. Wird von Media Services festgelegt. |
Edm.Int32 | Für diese Eigenschaft sind folgende Werte verfügbar: – Stopped: Der ursprüngliche Status eines "StreamingEndpoint" nach der Erstellung. – Starting: Der "StreamingEndpoint" befindet sich im Übergang in den Ausführungsstatus. – Running: Der "StreamingEndpoint" kann Inhalte an Clients streamen. – Scaling: Die Streamingeinheiten (ScaleUnits) werden vergrößert oder verringert. – Stopping: Der "StreamingEndpoint" befindet sich im Übergang in den Status Beendet. |
HostNameSchreibgeschützt. Wird von Media Services festgelegt. |
Edm.String | Standardmäßiger Streamingendpunkthostname. |
LastModifiedSchreibgeschützt. Wird von Media Services festgelegt. |
Edm.DateTime | Letzte Aktualisierungszeit für diese Entität. |
ScaleUnitsSchreibgeschützt. |
Edm.Int32 | Die Anzahl der Premium-Streamingendpunkte, die der StreamingEndpoint-Bereitstellung zugeordnet sind. Wenn sich der "StreamingEndpoint" im Status Running befindet, können die Streamingeinheiten auf dem "StreamingEndpoint" hochskaliert werden, indem der Vorgang Scale aufgerufen wird.Diese Eigenschaft steuert auch den Streamingendpunkttyp mit der Kombination der Streamingendpunktversion. Wenn Ihre Streamingendpunktversion 1.0 und ScaleUnits=0 ist, hat der Streamingendpunkt einen klassischen Typ. Die folgenden StreamingEndpoint-Eigenschaften können nur konfiguriert werden, wenn Ihr Streamingendpunkt Standard oder Premium ist: AccessControl, CustomHostNames, CacheControl, CrossSiteAccessPolicies. |
CdnEnabledDiese Eigenschaft wurde in Media Services 2.9 hinzugefügt. |
Edm.Boolean |
Gibt an, ob die Azure-CDN-Integration für diesen „StreamingEndpoint“ aktiviert ist (standardmäßig deaktiviert.) Um die CdnEnabled auf true festzulegen, muss streamingEndpoint mindestens einen Premium-Streamingendpunkt (ScaleUnits) für Version 1.0 StreamingEndpoints aufweisen und sich im Status beendet befinden. Sie können diese Eigenschaft festlegen, wenn StreamingEndpoint-Version unabhängig vom ScaleUnits-Wert 2.0 ist (siehe Standard-Streamingendpunkt). Verwenden Sie die Vorgangs-REST-API, um die status zu überprüfen. Nach der Aktivierung werden die folgenden Konfigurationen deaktiviert: CustomHostNames und AccessControl.Hinweis: Nicht alle Rechenzentren unterstützen die Azure CDN-Integration. Gehen Sie wie folgt vor, um zu überprüfen, ob die Azure CDN-Integration in Ihrem Rechenzentrum zur Verfügung steht: - Versuchen Sie, CdnEnabled auf TRUE festzulegen.– Überprüfen Sie das zurückgegebene Ergebnis für ein HTTP Error Code 412 (PreconditionFailed) mit der Meldung "CdnEnabled-Eigenschaft des Streamingendpunkts kann nicht auf TRUE festgelegt werden, da die CDN-Funktion in der aktuellen Region nicht verfügbar ist."Wenn dieser Fehler angezeigt wird, wird das CDN im Rechenzentrum nicht unterstützt. Versuchen Sie es mit einem anderen Rechenzentrum. |
CdnProviderDiese Eigenschaft wurde in Media Services 2.15 hinzugefügt. |
Edm.String | Wenn CDN aktiviert ist ("CdnEnabled":true), können Sie auch CdnProvider-Werte übergeben. CdnProvider steuert, welcher Anbieter verwendet wird. Derzeit werden drei Werte unterstützt: „StandardVerizon“, „PremiumVerizon“ und „StandardAkamai“. Wenn kein Wert angegeben wird und "CdnEnabled":true, wird "StandardVerizon" verwendet (dies ist der Standardwert.) Beispiel: "CdnProvider":"StandardAkamai". Hinweis: StreamingEndpoints, die mit älteren AMS-Versionen (<2.15) "CDNEnabled":true sind, verfügt über eine Legacy-CDN-Integration und verwendet den CDN-Anbieter "StandardVerizon". Es wird empfohlen, Ihre StreamingEndpoints zur neueren CDN-Integration zu migrieren, um eine bessere Erfahrung und vollständige Funktion zu erhalten. |
CdnProfileDiese Eigenschaft wurde in Media Services 2.15 hinzugefügt. |
Edm.String | Wenn CDN aktiviert ist ("CdnEnabled":true), können Sie auch CdnProfile-Werte übergeben. "CdnProfile" ist der Name des CDN-Profils, in dem der CDN-Endpunktpunkt erstellt wird. Sie können ein vorhandenes CdnProfile angeben oder ein neues verwenden. Wenn der Wert NULL und "CdnEnabled":true ist, wird der Standardwert "AzureMediaStreamingPlatformCdnProfile" verwendet. Wenn das bereitgestellte CdnProfile bereits vorhanden ist, wird unter diesem ein Endpunkt erstellt. Wenn das Profil nicht vorhanden ist, wird automatisch ein neues Profil erstellt. Beispiel: "CdnProfile":"AzureMediaStreamingPlatformCdnProfile". |
FreeTrialEndTimeSchreibgeschützt. Diese Eigenschaft wurde in Media Services 2.15 hinzugefügt. |
Edm.DateTime | Wenn ein neues Media Services-Konto erstellt wird, wird auch ein Standard-Streamingendpunkt automatisch unter dem Konto im Status beendet bereitgestellt. Dieser Endpunkt umfasst einen 15-tägigen kostenlosen Testzeitraum, und der Testzeitraum beginnt, wenn der Endpunkt zum ersten Mal gestartet wird. Die kostenlose Testversion gilt nicht für vorhandene Konten, und das Enddatum ändert sich nicht mit Zustandsübergängen wie Stop/Start. Die kostenlose Testversion beginnt beim ersten Starten des Streamingendpunkts und endet nach 15 Kalendertagen. Die kostenlose Testversion gilt nur für den Standardmäßigen Streamingendpunkt und nicht für zusätzliche Streamingendpunkte. Wenn der Endpunkt gerade erstellt wurde und sich im Zustand beendet befindet, wird der Wert von "FreeTrialEndTime" auf "0001-01-01T00:00:00Z" festgelegt. Wenn es gestartet wird, werden 15 Tage zum Startdatum hinzugefügt, und der Wert beginnt für das Enddatum der kostenlosen Testversion "FreeTrialEndTime":"2016-12-16T18:01:47.8524725Z". Werte für Streamingendpunkte, die nicht für eine kostenlose Testversion berechtigt sind, sind unabhängig vom Status immer "FreeTrialEndTime":"0001-01-01-01T00:00:00Z". Beispiele: "FreeTrialEndTime":"2016-12-16T18:01:47.8524725Z" "FreeTrialEndTime":"0001-01-01T00:00:00Z" |
StreamingEndpointVersionDiese Eigenschaft wurde in Media Services 2.15 hinzugefügt. |
Edm.String | Die Kombination aus StreamingEndpointVersion und ScaleUnits steuert den Streamingendpunkttyp. Alle Streamingendpunkte, die vor dem Update 2.15 (10. Januar 2017) erstellt wurden, verfügen über "StreamingEndpointVersion":"1.0" und streamingendpunkte, die nach dem Update erstellt wurden, verfügen über "StreamingEndpointVersion":"2.0". Streamingendpunkte, die Version 1.0 sind, werden nicht automatisch auf Version 2.0 aktualisiert, können aber explizit auf "StreamingEndpointVersion":"2.0" aktualisiert werden. Streamingendpunkte mit "ScaleUnits":0 und "StreamingEndpointVersion":"1.0" werden als klassische Streamingendpunkte betrachtet, die nicht über die erweiterten Features wie dynamische Paketerstellung oder dynamische Verschlüsselung verfügen. Streamingendpunkte mit "ScaleUnits" > 0 (unabhängig davon, ob "StreamingEndpointVersion" auf Version "1.0" oder Version "2.0" festgelegt ist) sind Premium-Einheiten . Standard-Streamingendpunkte mit "ScaleUnits":0 und "StreamingEndpointVersion":"2.0" enthalten die gleichen Features wie Premium-Einheiten (einschließlich dynamischer Paketerstellung und dynamischer Verschlüsselung). Sie können einen klassischen Streamingendpunkt auf Standard aktualisieren, indem Sie die Version auf "StreamingEndpointVersion":"2.0" festlegen. Dies ist ein unidirektionales Verfahren; Sie können Version 2.0 nicht auf 1.0 herabstufen. Beachten Sie, dass dieser Vorgang nicht rückgängig gemacht werden kann und Auswirkungen auf die Kosten hat. Es kann bis zu 30 Minuten dauern, bis diese neue Konfiguration weitergegeben wird. Während dieses Zeitraums funktioniert der Endpunkt im heruntergestuften Modus, und es kann zu Fehlern bei dynamischen Paketerstellungs- und dynamischen Verschlüsselungsanforderungen kommen. Beispiele: "StreamingEndpointVersion":"2.0" "StreamingEndpointVersion":"1.0" |
CustomHostNamesOptional. |
Collection(Edm.String) | Wird verwendet, um einen Streamingendpunkt so zu konfigurieren, dass an einen benutzerdefinierten Hostnamen gerichteter Datenverkehr akzeptiert wird. Dies ermöglicht eine einfachere Datenverkehr-Verwaltungskonfiguration über einen globalen Traffic Manager (GTM) und ebenso für mit Branding versehene Domänennamen, die als Name des Streamingendpunkts verwendet werden. Der Besitz des Domänennamens muss in Azure Media Services bestätigt werden. In Azure Media Services wird der Besitz des Domänennamens durch Anfordern eines CName-Eintrags überprüft, der die Azure Media Services-Konto-ID als Komponente enthält, die der verwendeten Domäne hinzuzufügen ist. Damit "sports.contoso.com" beispielsweise als benutzerdefinierter Hostname für den Streamingendpunkt verwendet werden kann, muss ein Datensatz für "<accountId.contoso.com>" so konfiguriert werden, dass er auf einen der Media Services-Überprüfungshostnamen verweist. Der Name des Überprüfungshosts besteht aus verifydns.<mediaservices-dns-zone>. Im Folgenden sind die erwarteten DNS-Zonen aufgeführt, die im Überprüfungseintrag für verschiedene Azure-Regionen zu verwenden sind.Nordamerika, Europa, Singapur, Hongkong, Japan: - mediaservices.windows.net - verifydns.mediaservices.windows.net China: - mediaservices.chinacloudapi.cn - verifydns.mediaservices.chinacloudapi.cn Ein CName-Eintrag, der eine Zuordnung von „945a4c4e-28ea-45cd-8ccb-a519f6b700ad.contoso.com“ zu „verifydns.mediaservices.windows.net“ vornimmt, beweist z.B., dass die Azure Media Services-ID 945a4c4e-28ea-45cd-8ccb-a519f6b700ad den Besitz der Domäne contoso.com hat, sodass alle Namen unter contoso.com als benutzerdefinierter Hostname für einen Streamingendpunkt in diesem Konto verwendet werden können.Um den Wert der Mediendienst-ID zu suchen, wählen Sie im Azure-Portal Ihr Mediendienstkonto aus. Die MEDIENDIENST-ID wird rechts auf der Seite DASHBOARD angezeigt. Warnung: Wenn versucht wird, einen benutzerdefinierten Hostnamen festzulegen, ohne dass der CName-Eintrag ordnungsgemäß überprüft wird, treten bei der DNS-Antwort Fehler auf, und die Antwort wird dann einige Zeit zwischengespeichert. Nachdem ein entsprechender Eintrag eingerichtet wurde, kann es eine Weile dauern, bis die zwischengespeicherte Antwort erneut überprüft wird. Abhängig vom DNS-Anbieter der benutzerdefinierten Domäne kann die erneute Überprüfung des Eintrags zwischen einigen Minuten bis zu einer Stunde dauern.Zusätzlich zu dem CName-Eintrag, der die Zuordnung von <accountId>.<parent domain> zu verifydns.<mediaservices-dns-zone> definiert, müssen Sie einen anderen CName-Eintrag erstellen, der den benutzerdefinierten Hostnamen (z.B. sports.contoso.com) dem Hostnamen des Media Services-Streamingendpunkts zuordnet (z.B. amstest.streaming.mediaservices.windows.net).Hinweis: Für Streamingendpunkte, die sich im selben Rechenzentrum befinden, kann nicht der gleiche benutzerdefinierte Hostname verwendet werden. Diese Eigenschaft ist für Standard- und Premium-Streamingendpunkte gültig und kann bei "CdnEnabled":false festgelegt werden. Beachten Sie, dass SSL mit benutzerdefinierten Domänen derzeit nicht von AMS unterstützt wird. |
AccessControl |
StreamingEndpointAccessControl ComplexType | Wird zum Konfigurieren der folgenden Sicherheitseinstellungen für den Streamingendpunkt verwendet: Authentifizierungsschlüssel und IP-Adressen der Unterschriftenkopfzeilen-Authentifizierung von Akamai, über die eine Verbindung mit dem Endpunkt zulässig ist. Hinweis: Diese Eigenschaft ist für Standard- und Premium-Streamingendpunkte gültig und kann bei "CdnEnabled":false festgelegt werden. |
CacheControl |
StreamingEndpointCacheControl | Wird zum Konfigurieren der Medienobjekt-Zwischenspeicherlebenszeit für über diesen Streamingendpunkt verarbeitete Medienobjekte verwendet. |
CrossSiteAccessPolicies |
CrossSiteAccessPolicies | Wird zum Angeben von websiteübergreifenden Zugriffsrichtlinien für verschiedene Clients verwendet. Weitere Informationen finden Sie unter Cross-domain policy file specification (Dateispezifikation für domänenübergreifende Richtlinien) und Making a Service Available Across Domain Boundaries (Verfügbarmachen eines Diensts über Netzwerkgrenzen hinweg). |
StreamingEndpointCacheControl
| Name | type | BESCHREIBUNG |
|---|---|---|
MaxAgeOptional. |
Edm.Int64 | Überschreibt den standardmäßigen Max-Age-HTTP-Cache Control Header, der vom Streamingendpunkt für Medienfragmente und On-Demand-Manifeste festgelegt wird. Der Wert wird in Sekunden festgelegt. |
StreamingEndpointAccessControl ComplexType
| Name | type | BESCHREIBUNG |
|---|---|---|
Akamai |
AkamaiAccessControl | Akamai-Zugriffssteuerung. |
IP |
IPAccessControl | IP-Zugriffssteuerung. |
AkamaiAccessControl
| Name | type | BESCHREIBUNG |
|---|---|---|
| AkamaiSignatureHeaderAuthenticationKeyList | AkamaiSignatureHeaderAuthenticationKey ComplexType | Enthält Informationen über Unterschriftenkopfzeilen-Authentifizierungsschlüssel von Akamai. |
IPAccessControl
| Name | type | BESCHREIBUNG |
|---|---|---|
| Allow | IPRange ComplexType | Definiert die IP-Adressen, die eine Verbindung mit dem Streamingendpunkt herstellen können. Hinweis: Wenn Sie diesen Wert auf NULL festlegen, können alle IP-Quelladressen eine Verbindung herstellen. Bei Festlegung auf eine leere Zeichenfolge (“”) kann keine Adresse eine Verbindung herstellen. |
AkamaiSignatureHeaderAuthenticationKey ComplexType
Dieser Typ beschreibt die Akamai G20-Authentifizierungseinstellungen. Akamai Authentication ist ein Authentifizierungsschema für Schlüsselhashnachrichten. Der Authentifizierungsschlüssel ist ein Geheimnis, das vom Akamai CDN und dem Azure Media Origin Streaming Service gemeinsam genutzt wird. Azure Media Services unterstützt nur Version 3, die HMAC-MD5 verwendet.
| Name | type | BESCHREIBUNG |
|---|---|---|
Identifier |
Edm.String | Der Bezeichner für den Authentifizierungsschlüssel. Dies ist die Nonce, die von Akamai bereitgestellt wird. |
Expiration |
Edm.DateTime | DateTime-Wert, der angibt, wann die Akamai-Authentifizierung abläuft |
Base64Key |
Edm.String | Base64-codierter Authentifizierungsschlüssel, der vom CDN verwendet wird. Der von Akamai bereitgestellte Authentifizierungsschlüssel ist eine ASCII-codierte Zeichenfolge. Er muss in Bytes konvertiert und dann base64 codiert werden. |
Das folgende C#-Beispiel zeigt, wie Sie den Akamai-Authentifizierungsschlüssel in base64 konvertieren:
string akamaiKey = "01234567890123456789012345678901";
string base64Key = Convert.ToBase64String(System.Text.Encoding.ASCII.GetBytes(akamaiKey);
IPRange ComplexType
| Name | type | BESCHREIBUNG |
|---|---|---|
Name |
Edm.String | Ein Anzeigename für diesen IP-Bereich. |
Address |
Edm.String | Die Basis-IP-Adresse für die Subnetzdarstellung (beispielsweise 192.168.0.1). |
SubnetPrefixLength |
Edm.Int32 | Die Anzahl der signifikanten Bits für die Subnetzmaske (beispielsweise stellt 24 in der IP-Adresse "192.168.0.1/24" die Anzahl an signifikanten Bits dar). |
Create StreamingEndpoint
Erstellen Sie einen neuen "StreamingEndpoint"-Dienst.
Anforderung
| Methode | Anforderungs-URI | HTTP-Version |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoint> | HTTP/1.1 |
Beispiel für eine Anforderung
Sie können das folgende Beispiel auf der Registerkarte "Fiddler's Composer" ausprobieren.
Informationen zum Aktuellen x-ms-version:finden Sie unter Media Services REST.
Anforderungsheader:
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>
Anforderungstext:
{
"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>"
}
}
Bei Erfolg wird der Statuscode 202 Accepted mit einer Darstellung der erstellten Entität im Antworttext zurückgegeben.
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>"
}
}
Der Statuscode 202 Accepted zeigt einen asynchronen Vorgang an, wobei der Vorgangs-ID-Headerwert ebenfalls bereitgestellt wird, der beim Abrufen und Nachverfolgen des Status langer Vorgänge, wie beispielsweise das Starten und Beenden eines "StreamingEndpoint", verwendet wird. Übergeben Sie den Vorgangs-ID-Headerwert an die Vorgangsentität, um den Status abzurufen. Weitere Informationen finden Sie unter Manuelles Abfragen von Long-Running Vorgängen.
Start StreamingEndpoint
Starten Sie den angegebenen "StreamingEndpoint". Ein "StreamingEndpoint" kann nur gestartet werden, wenn er sich im Status Stopped befindet. Einige Zeit nach dem Starten des StreamingEdpoints ändert sich der Zustand in Running.
Um das Streaming zu einem späteren Zeitpunkt zu beenden, rufen Sie den Stop-Vorgang auf.
Verfügbare Aktionen im Status Wird ausgeführt .
| State | Streaming-Einheiten | BESCHREIBUNG | Verfügbare Aktionen |
|---|---|---|---|
| Wird ausgeführt | 0 | Streaming vom Standard-Streamingendpunkt. | Stop, Scale |
| Wird ausgeführt | >0 | Streaming vom Premium-Streamingendpunkt. | Stop, Scale |
Anforderung
| Methode | Anforderungs-URI | HTTP-Version |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Start | HTTP/1.1 |
Beispiel für eine Anforderung
Sie können das folgende Beispiel auf der Registerkarte "Fiddler es Composer" ausprobieren.
Anforderungsheader:
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>
Bei Erfolg wird der Statuscode 202 Accepted zurückgegeben. Der Statuscode 202 Accepted zeigt einen asynchronen Vorgang an, wobei der Vorgangs-ID-Headerwert ebenfalls bereitgestellt wird, der beim Abrufen und Nachverfolgen des Status langer Vorgänge, wie beispielsweise das Starten und Beenden eines "StreamingEndpoint", verwendet wird. Übergeben Sie den Vorgangs-ID-Headerwert an die Vorgangsentität, um den Status abzurufen. Weitere Informationen finden Sie unter Manuelles Abrufen von Long-Running Vorgängen.
Beenden von "StreamingEndpoint"
Beenden Sie den angegebenen "StreamingEndpoint". Ein "StreamingEndpoint" kann nur beendet werden, wenn er sich im Status Running befindet.
Verfügbare Aktionen im Status Beendet .
| State | Streaming-Einheiten | BESCHREIBUNG | Verfügbare Aktionen |
|---|---|---|---|
| Beendet | 0 | Streamen wird nicht ausgeführt. | Start, Scale |
| Beendet | >0 | Streamen wird nicht ausgeführt. | Start, Scale |
Anforderung
| Methode | Anforderungs-URI | HTTP-Version |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Stop | HTTP/1.1 |
Beispiel für eine Anforderung
Sie können das folgende Beispiel auf der Registerkarte "Fiddler es Composer" ausprobieren.
Informationen zum Aktuellen x-ms-version:finden Sie unter Media Services REST.
Anforderungsheader:
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>
Bei Erfolg wird der Statuscode 202 Accepted zurückgegeben. Der Statuscode 202 Accepted zeigt einen asynchronen Vorgang an, wobei der Vorgangs-ID-Headerwert ebenfalls bereitgestellt wird, der beim Abrufen und Nachverfolgen des Status langer Vorgänge, wie beispielsweise das Starten und Beenden eines "StreamingEndpoint", verwendet wird. Übergeben Sie den Vorgangs-ID-Headerwert an die Vorgangsentität, um den Status abzurufen. Weitere Informationen finden Sie unter Manuelles Abrufen von Long-Running Vorgängen.
Skalieren eines "StreamingEndpoint"
Aktualisiert dynamisch die Kapazität der Streamingeinheit, während sich der Status "Ausgeführt" befindet, und ändert den Typ von "Standard-Streamingendpunkt" in "Premium-Streamingendpunkt", wenn er von "ScaleUnits":0 aktualisiert wird.
Anforderung
| Methode | Anforderungs-URI | HTTP-Version |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Scale | HTTP/1.1 |
Beispiel für eine Anforderung
Sie können das folgende Beispiel auf der Registerkarte "Fiddler es Composer" ausprobieren.
Informationen zum Aktuellen x-ms-version:finden Sie unter Media Services REST.
Anforderungsheader:
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>
Anforderungstext:
{"scaleUnits" : 2}
Bei Erfolg wird der Statuscode 202 Accepted zurückgegeben. Der Statuscode 202 Accepted zeigt einen asynchronen Vorgang an, wobei der Vorgangs-ID-Headerwert ebenfalls bereitgestellt wird, der beim Abrufen und Nachverfolgen des Status langer Vorgänge, wie beispielsweise das Starten und Beenden eines "StreamingEndpoint", verwendet wird. Übergeben Sie den Vorgangs-ID-Headerwert an die Vorgangsentität, um den Status abzurufen. Weitere Informationen finden Sie unter Manuelles Abrufen von Long-Running Vorgängen.
Auflisten von "StreamingEndpoints"
"StreamingEndpoints" werden mithilfe einer GET HTTP-Anforderung abgerufen.
Anforderung
| Methode | Anforderungs-URI | HTTP-Version |
|---|---|---|
| GET | Abrufen aller "StreamingEndpoints": <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints> Rufen Sie den angegebenen "StreamingEndpoint" ab. <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') |
HTTP/1.1 |
Beispiel für eine Anforderung
Sie können das folgende Beispiel auf der Registerkarte "Fiddler es Composer" ausprobieren.
Informationen zum Aktuellen x-ms-version:finden Sie unter Media Services REST.
Anforderungsheader:
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>
Bei erfolgreicher Ausführung wird der Code 200 OK status und eine Liste aller StreamingEndpoints zurückgegeben, die in Ihrem Media Services-Konto erstellt wurden.
Aktualisieren von "StreamingEndpoints"
Aktualisieren Sie einen "StreamingEndpoint" mit neuen Eigenschaftenwerten. Dies ist ein asynchroner Vorgang, wenn der "StreamingEndpoint" ausgeführt wird und die Einstellungen geändert werden.
Anforderung
| Methode | Anforderungs-URI | HTTP-Version |
|---|---|---|
| PATCH/PUT/MERGE Weitere Informationen zu diesen Vorgängen finden Sie unter PATCH, PUT, MERGE. |
<https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') | HTTP/1.1 |
Beispiel für eine Anforderung
Sie können das folgende Beispiel auf der Registerkarte "Fiddler's Composer" ausprobieren. Im Beispiel wird der MaxAge-Wert aktualisiert.
Informationen zum Aktuellen x-ms-version:finden Sie unter Media Services REST.
Anforderungsheader:
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>
Anforderungstext:
{"CacheControl":{"MaxAge":"2000"}}
Wird die Aktualisierung synchron beendet, wird der Statuscode 204 No Content zurückgegeben; anderfalls wird der Statuscode 202 Accepted zurückgegeben. Der Statuscode 202 Accepted zeigt einen asynchronen Vorgang an, wobei der Vorgangs-ID-Headerwert ebenfalls bereitgestellt wird, der beim Abrufen und Nachverfolgen des Status langer Vorgänge, wie beispielsweise das Starten und Beenden eines "StreamingEndpoint", verwendet wird. Übergeben Sie den Vorgangs-ID-Headerwert an die Vorgangsentität, um den Status abzurufen. Weitere Informationen finden Sie unter Manuelles Abfragen von Long-Running Vorgängen.
Löschen von "StreamingEndpoints"
Löschen Sie einen "StreamingEndpoint". Ein "StreamingEndpoint" kann nur gelöscht werden, wenn er sich im Status Stopped befindet.
Anforderung
| Methode | Anforderungs-URI | HTTP-Version |
|---|---|---|
| Delete | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') | HTTP/1.1 |
Beispiel für eine Anforderung
Sie können das folgende Beispiel auf der Registerkarte "Fiddler's Composer" ausprobieren.
Informationen zum Aktuellen x-ms-version:finden Sie unter Media Services REST.
Anforderungsheader:
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>
Bei Erfolg wird der Statuscode 202 Accepted zurückgegeben. Der Statuscode 202 Accepted zeigt einen asynchronen Vorgang an, wobei der Vorgangs-ID-Headerwert ebenfalls bereitgestellt wird, der beim Abrufen und Nachverfolgen des Status langer Vorgänge, wie beispielsweise das Starten und Beenden eines "StreamingEndpoint", verwendet wird. Übergeben Sie den Vorgangs-ID-Headerwert an die Vorgangsentität, um den Status abzurufen. Weitere Informationen finden Sie unter Manuelles Abfragen von Long-Running Vorgängen.