StreamingEndpoint
Important
Depuis Media Services 2.7, l'entité Origin a été renommée en StreamingEndpoint.
L'entité StreamingEndpoint représente un service de diffusion en continu qui peut fournir du contenu directement à une application de lecteur cliente ou à un réseau de distribution de contenu (CDN) pour une distribution ultérieure. À compter de la version 2.9, Microsoft Azure Media Services fournit l’intégration d’Azure CDN (pour plus d’informations, consultez la CdnEnabled propriété documentée ci-dessous). Le flux sortant d’un service StreamingEndpoint peut être un flux en direct ou une ressource vidéo à la demande dans votre compte Media Services.
Chaque compte Azure Media Services (AMS) inclut un streamingEndpoint par défaut ; Vous pouvez créer des points streamingEndpoint supplémentaires sous le compte. À compter de Media Services 2.15 (publié le 10 janvier 2017), il existe deux versions de StreamingEndpoint : 1.0 et 2.0. Il existe également trois types de streamingEndpoints : Classic, **Standard ou Premium.
Les comptes Media Services créés avant la mise à jour d’AMS REST 2.15 incluent par défaut les points de terminaison de streaming classiques , version 1.0. Vous pouvez effectuer une mise à niveau vers la version 2.0. Vous ne pouvez pas passer à la version 1.0. Les comptes AMS créés après la mise à jour 2.15 incluent par défaut les points de terminaison de streaming Standard , version 2.0. Les points de terminaison de streaming version 2.0 ont des modifications de facturation et de fonctionnalités. Pour plus d’informations, consultez la StreamingEndpointVersion propriété documentée ci-dessous.
StreamingEndpoint provisionné automatiquement a le nom « Default » et ne peut pas être supprimé. L’état de StreamingEndpoint est Arrêté. Pour démarrer la diffusion en continu, vous devez démarrer le point de terminaison de streaming.
Si vous avez créé le compte via le portail Azure Classic et qu’Azure CDN est disponible dans la région, le compte aura l’intégration CDN par défaut (« CdnEnabled »:true, « CdnProvider »:StandardVerizon et « CdnProfile »:AzureMediaStreamingPlatformCdnProfile).
Dans la plupart des cas, vous devez conserver CDN activé. Cependant, si vous prévoyez un nombre maximal d’accès simultanés inférieur à 500 visiteurs, il est recommandé de désactiver le CDN, car celui-ci se met à l’échelle de façon optimale avec les accès simultanés.
Vue d’ensemble des points de terminaison de streaming Classic, Standard et Premium
Les fonctionnalités avancées décrites dans cette section incluent l’empaquetage dynamique et le chiffrement dynamique.
Le tableau ci-dessous récapitule le comportement :
| Type | Version | ScaleUnits | Fonctionnalités avancées | CDN | Facturation |
|---|---|---|---|---|---|
| Classique | 1.0 | 0 | N/D | N/D | Gratuit |
| Point de terminaison de streaming Standard (recommandé) | 2.0 | 0 | Oui | Oui | Payant |
| Point de terminaison de streaming Premium | 1.0 | >0 | Oui | Oui | Payant |
| Point de terminaison de streaming Premium | 2.0 | >0 | Oui | Oui | Payant |
Il est recommandé de mettre à niveau vos points de terminaison de streaming Classic vers des points de terminaison de streaming Standard pour bénéficier d’une meilleure expérience et de fonctionnalités avancées. Le streaming standard met également automatiquement à l’échelle la bande passante sortante.
Le type Standard est l’option recommandée pour pratiquement tous les scénarios de streaming et toutes les tailles d’audience. Pour les clients ayant des exigences extrêmement exigeantes, AMS offre également des points de terminaison de streaming Premium , qui peuvent être utilisés pour augmenter la capacité pour les plus grands publics Internet. Si vous vous attendez à un grand public et à des téléspectateurs simultanés, contactez-nous pour obtenir des conseils sur la nécessité de passer au type Premium . Un bon billet de guide est de nous contacter (amsstreaming à microsoft.com) si vous attendez une taille d’audience simultanée supérieure à 50 000 spectateurs.
Vous passez à un type Premium en ajustant les unités de mise à l’échelle. Les unités de mise à l’échelle vous fournissent une capacité de sortie dédiée qui peut être achetée par incréments de 200 Mbits/s. Quand vous utilisez le type Premium, chaque unité activée fournit une capacité de bande passante supplémentaire à l’application. Pour plus d’informations, consultez Guide pratique pour mettre à l’échelle StreamingEndpoint.
Pour plus d’informations, consultez Vue d’ensemble des points de terminaison de streaming.
Propriétés et opérations streamingEndpoint
Important
Lors de l’accès aux entités dans Media Services, vous devez définir les valeurs et les champs d’en-tête spécifiques dans vos requêtes HTTP.
Pour plus d’informations, consultez Configuration du développement d’API REST Media Services et Connexion à Media Services avec l’API REST Media Services.
Cette section donne une vue d’ensemble de l’entité StreamingEndpoint et montre également comment exécuter différentes opérations avec l’API REST Media Services.
Mettre à l'échelle des points de terminaison de diffusion en continu
Répertorier les points de terminaison de diffusion en continu
Mettre à jour des points de terminaison de diffusion en continu
Entité StreamingEndpoint
L’entité StreamingEndpoint contient les propriétés suivantes :
| Propriété | Type | Description |
|---|---|---|
IdLecture seule. Défini par Media Services. |
Edm.String | ID du point de terminaison de diffusion en continu affecté lors de la création. Le format est : nb:oid:UUID:<GUID>. |
Name |
Edm.String | Nom convivial du service StreamingEndpoint. - Doit être unique dans votre compte Media Services. - Longueur maximale = 32 caractères. - Impossible de contenir des espaces. - Traits d’union et caractères alphanumériques uniquement. - Impossible de commencer ou de se terminer par un trait d’union. |
Description |
Edm.String | Description du point de terminaison de diffusion en continu. La longueur maximale est de 256 caractères. |
CreatedLecture seule. Défini par Media Services. |
Edm.DateTime | Créé par le service Microsoft Azure Media Services Live Streaming Preview. |
StateLecture seule. Défini par Media Services. |
Edm.Int32 | Les valeurs de la propriété peuvent être : - Arrêté. État initial d'un point de terminaison de diffusion en continu après la création. - Démarrage en cours. Le point de terminaison de diffusion en continu est en cours de transition vers l'état En cours d'exécution. - Exécution en cours. Le point de terminaison de diffusion en continu est en mesure de diffuser du contenu vers des clients. - Mise à l’échelle. Les unités de diffusion (unités d'échelle) sont en cours d'augmentation ou de diminution. - Arrêt en cours. Le point de terminaison de diffusion en continu est en cours de transition vers l'état Arrêté. |
HostNameLecture seule. Défini par Media Services. |
Edm.String | Nom d'hôte du point de terminaison de diffusion en continu par défaut. |
LastModifiedLecture seule. Défini par Media Services. |
Edm.DateTime | Dernière mise à jour pour cette entité. |
ScaleUnitsLecture seule. |
Edm.Int32 | Nombre de points de terminaison de streaming Premium alloués pour le déploiement StreamingEndpoint. Quand le point de terminaison de diffusion en continu est dans l'état Running, les unités de diffusion en continu sur le point de terminaison de diffusion en continu peuvent être augmentées en appelant l'opération Scale.Cette propriété contrôle également le type de point de terminaison de streaming avec la combinaison de la version du point de terminaison de streaming. Si votre point de terminaison de streaming est version 1.0 et ScaleUnits=0, le point de terminaison de streaming est d’un type classique . Les propriétés de StreamingEndpoint suivantes ne peuvent être configurées que si votre point de terminaison de streaming est standard ou Premium : AccessControl, CustomHostNames, CacheControl, CrossSiteAccessPolicies. |
CdnEnabledCette propriété a été ajoutée dans Media Services 2.9. |
Edm.Boolean |
Indique si l'intégration d'Azure CDN pour cette entité StreamingEndpoint est activée (désactivée par défaut). Pour définir sur CdnEnabled true, streamingEndpoint doit avoir au moins un point de terminaison de streaming Premium (ScaleUnits) pour streamingEndpoints version 1.0 et être à l’état arrêté. Vous pouvez définir cette propriété si la version de StreamingEndpoint est 2.0, quelle que soit la valeur de ScaleUnits (reportez-vous au point de terminaison de streaming standard). Utilisez l’API REST Operation pour case activée le status. Une fois qu’il est activé, les configurations suivantes sont désactivées : CustomHostNames et AccessControl.Remarque : Tous les centres de données ne prennent pas en charge l’intégration d’Azure CDN. Pour vérifier si l’intégration d’Azure CDN est disponible pour votre centre de données, procédez comme suit : - Essayez de définir CdnEnabled sur true.- Vérifiez le résultat retourné pour un HTTP Error Code 412 (Condition préalableFailed) avec le message « La propriété CdnEnabled du point de terminaison de streaming ne peut pas être définie sur true, car la fonctionnalité CDN n’est pas disponible dans la région actuelle ».Si vous recevez cette erreur, cela signifie que le centre de données ne la prend pas en charge. Vous devez essayer un autre centre de données. |
CdnProviderCette propriété a été ajoutée dans Media Services 2.15. |
Edm.String | Lorsque CDN est activé (« CdnEnabled »:true), vous pouvez également passer des valeurs CdnProvider. CdnProvider contrôle le fournisseur qui sera utilisé. Actuellement, trois valeurs sont prises en charge : « StandardVerizon », « PremiumVerizon » et « StandardAkamai ». Si aucune valeur n’est fournie et que « CdnEnabled »:true, « StandardVerizon » est utilisé (c’est la valeur par défaut.) Exemple : « CdnProvider »:"StandardAkamai ». Remarque : StreamingEndpoints, qui sont « CDNEnabled »:true avec les anciennes versions d’AMS (<2.15) a une intégration CDN héritée et utilise le fournisseur CDN « StandardVerizon ». Il est recommandé de migrer vos points de terminaison de streaming vers l’intégration CDN plus récente pour bénéficier d’une meilleure expérience et d’une fonctionnalité complète. |
CdnProfileCette propriété a été ajoutée dans Media Services 2.15. |
Edm.String | Lorsque CDN est activé (« CdnEnabled »:true), vous pouvez également passer des valeurs CdnProfile. « CdnProfile » est le nom du profil CDN où le point de point de terminaison CDN sera créé. Vous pouvez fournir un CdnProfile existant ou en utiliser un nouveau. Si la valeur est NULL et « CdnEnabled »:true, la valeur par défaut « AzureMediaStreamingPlatformCdnProfile » est utilisée. Si le CdnProfile fourni existe déjà, un point de terminaison est créé sous celui-ci. Si le profil n’existe pas, un nouveau profil est créé automatiquement. Exemple : « CdnProfile »:"AzureMediaStreamingPlatformCdnProfile ». |
FreeTrialEndTimeLecture seule. Cette propriété a été ajoutée dans Media Services 2.15. |
Edm.DateTime | Lorsqu’un compte Media Services est créé, un point de terminaison de streaming standard par défaut est automatiquement provisionné sous le compte, à l’état arrêté. Ce point de terminaison comprend une période d’essai gratuit de 15 jours et la période d’essai commence lorsque le point de terminaison démarre pour la première fois. L’essai gratuit ne s’applique pas aux comptes existants et la date de fin ne change pas avec les transitions d’état telles que l’arrêt/le début. L’essai gratuit démarre la première fois que vous démarrez le point de terminaison de streaming et se termine après 15 jours calendaires. La version d’évaluation gratuite s’applique uniquement au point de terminaison de streaming par défaut et ne s’applique pas aux points de terminaison de streaming supplémentaires. Lorsque le point de terminaison vient d’être créé et qu’il est à l’état arrêté, la valeur de « FreeTrialEndTime » est définie sur « 0001-01-01T00:00:00Z ». Une fois démarré, 15 jours sont ajoutés à la date de début et la valeur commence représentant la date de fin de l’essai gratuit « FreeTrialEndTime » : « 2016-12-16T18:01:47.8524725Z ». Les valeurs des points de terminaison de streaming qui ne sont pas éligibles à l’essai gratuit seront toujours « FreeTrialEndTime »:"0001-01-01T00:00:00Z » quel que soit l’état. Exemples : « FreeTrialEndTime »:"2016-12-16T18:01:47.8524725Z » « FreeTrialEndTime »:"0001-01-01T00:00:00Z » |
StreamingEndpointVersionCette propriété a été ajoutée dans Media Services 2.15. |
Edm.String | La combinaison de StreamingEndpointVersion et ScaleUnits contrôle le type de point de terminaison de streaming. Tout point de terminaison de streaming créé avant la mise à jour 2.15 (10 janvier 2017) aura « StreamingEndpointVersion » : « 1.0 » et les points de terminaison de streaming créés après la mise à jour auront « StreamingEndpointVersion » : « 2.0 ». Les points de terminaison de streaming, qui sont la version 1.0, ne seront pas automatiquement mis à niveau vers la version 2.0, mais peuvent être mis à niveau explicitement vers « StreamingEndpointVersion »:« 2.0 ». Points de terminaison de streaming avec « ScaleUnits »:0 et « StreamingEndpointVersion » : « 1.0 » seront considérés comme des points de terminaison de streaming classiques , qui ne disposent pas des fonctionnalités avancées telles que l’empaquetage dynamique ou le chiffrement dynamique. Les points de terminaison de streaming avec « ScaleUnits » > 0 (si « StreamingEndpointVersion » est défini sur la version « 1.0 » ou la version « 2.0 ») sont des unités Premium . Points de terminaison de streaming standard avec « ScaleUnits »:0 et « StreamingEndpointVersion » : « 2.0 » incluent les mêmes fonctionnalités que les unités Premium (qui incluent l’empaquetage dynamique et le chiffrement dynamique.) Vous pouvez mettre à niveau un point de terminaison de streaming classique vers standard en définissant la version sur « StreamingEndpointVersion » : « 2.0 ». Il s’agit d’une opération unidirectionnelle ; vous ne pouvez pas passer à la version antérieure 2.0 à la version 1.0. Faites attention, car cette opération ne peut pas être restaurée et a un impact sur la tarification. La propagation de cette nouvelle configuration peut prendre jusqu’à 30 minutes. Pendant cette période, le point de terminaison fonctionne en mode détérioré et vous pouvez rencontrer des échecs pour les demandes d’empaquetage dynamique et de chiffrement dynamique. Exemples : « StreamingEndpointVersion »:"2.0 » « StreamingEndpointVersion »:"1.0 » |
CustomHostNamesOptionnel. |
Collection(Edm.String) | Utilisée pour configurer un point de terminaison de streaming de pour qu’il accepte le trafic dirigé vers un nom d’hôte personnalisé. Ceci permet une configuration plus facile de la gestion du trafic via un gestionnaire de trafic global, ainsi que l’utilisation de noms de domaines personnalisés comme nom du point de terminaison de streaming. La propriété du nom de domaine doit être vérifiée par Azure Media Services. Azure Media Services vérifie la propriété du nom de domaine en demandant un enregistrement CName qui contient l’ID de compte Azure Media Services comme composant à ajouter au domaine utilisé. Par exemple, pour que « sports.contoso.com » soit utilisé comme nom d’hôte personnalisé pour le point de terminaison de streaming, un enregistrement pour «< accountId.contoso.com> » doit être configuré pour pointer vers l’un des noms d’hôte de vérification Media Services. Le nom d’hôte de vérification est composé de verifydns.<mediaservices-dns-zone>. Le tableau suivant contient les zones DNS attendues dans l’enregistrement de vérification pour les différentes régions Azure.Amérique du Nord, Europe, Singapour, Hong Kong (R.A.S.), Japon : - mediaservices.windows.net - verifydns.mediaservices.windows.net Chine : - mediaservices.chinacloudapi.cn - verifydns.mediaservices.chinacloudapi.cn Par exemple, un enregistrement CName qui mappe « 945a4c4e-28ea-45cd-8ccb-a519f6b700ad.contoso.com » à « verifydns.mediaservices.windows.net » prouve que l’ID Azure Media Services 945a4c4e-28ea-45cd-8ccb-a519f6b700ad est propriétaire du domaine contoso.com, permettant ainsi l’utilisation de n’importe quel nom sous contoso.com comme nom d’hôte personnalisé pour un point de terminaison de streaming sous ce compte.Pour rechercher la valeur de l’ID du Service multimédia, accédez au portail Azure et sélectionnez votre compte Service multimédia. L’ID DE SERVICE MULTIMÉDIA apparaît à droite de la page TABLEAU DE BORD. Avertissement : Si vous tentez de définir un nom d’hôte personnalisé sans une vérification appropriée de l’enregistrement CName, la réponse DNS échoue, puis elle est mise en cache pendant un certain temps. Une fois qu’un enregistrement approprié est en place, un certain temps peut être nécessaire pour que la réponse mise en cache soit revalidée. Selon le fournisseur DNS pour le domaine personnalisé, quelques minutes à une heure peuvent être nécessaires pour revalider l’enregistrement.En plus du CName qui mappe <accountId>.<parent domain> à verifydns.<mediaservices-dns-zone>, vous devez créer un autre CName qui mappe le nom d’hôte personnalisé (par exemple sports.contoso.com) au nom d’hôte de votre point de terminaison de streaming Media Services (par exemple amstest.streaming.mediaservices.windows.net).Remarque : Des points de terminaison de streaming qui se trouvent dans le même centre de données ne peuvent pas partager le même nom d’hôte personnalisé. Cette propriété est valide pour les points de terminaison de streaming Standard et Premium et peut être définie lorsque « CdnEnabled »:false Notez que, actuellement, AMS ne prend pas en charge SSL avec les domaines personnalisés. |
AccessControl |
Type complexe StreamingEndpointAccessControl | Utilisée pour configurer les paramètres de sécurité suivants pour ce point de terminaison de streaming : les clés d’authentification d’en-tête de signature Akamai et les adresses IP qui sont autorisées à se connecter à ce point de terminaison. Remarque : Cette propriété est valide pour les points de terminaison de streaming Standard et Premium et peut être définie lorsque « CdnEnabled »:false |
CacheControl |
StreamingEndpointCacheControl | Utilisé pour configurer la durée de vie du cache de ressources pour les ressources traitées via ce point de terminaison de diffusion en continu. |
CrossSiteAccessPolicies |
CrossSiteAccessPolicies | Utilisée pour spécifier des stratégies d’accès entre sites pour différents clients. Pour plus d’informations, consultez Cross-domain policy file specification et Rendre un service disponible entre des limites de domaine. |
StreamingEndpointCacheControl
| Nom | Type | Description |
|---|---|---|
MaxAgefacultatif. |
Edm.Int64 | Remplace l’en-tête de contrôle du cache HTTP max-age par défaut défini par le point de terminaison de streaming sur des fragments de médias et des manifestes à la demande. La valeur est définie en secondes. |
Type complexe StreamingEndpointAccessControl
| Nom | Type | Description |
|---|---|---|
Akamai |
AkamaiAccessControl | Contrôle d'accès Akamai. |
IP |
IPAccessControl | Contrôle d'accès IP. |
AkamaiAccessControl
| Nom | Type | Description |
|---|---|---|
| AkamaiSignatureHeaderAuthenticationKeyList | Type complexe AkamaiSignatureHeaderAuthenticationKey | Contient des informations sur les clés d'authentification d'en-tête de signature Akamai. |
IPAccessControl
| Nom | Type | Description |
|---|---|---|
| Autoriser | Type complexe IPRange | Définit les adresses IP qui peuvent se connecter à un point de terminaison de diffusion en continu. Remarque : La définition de cette valeur sur null permet à toutes les adresses sources IP de se connecter. En la définissant sur une chaîne vide (“”), vous interdisez toute connexion. |
Type complexe AkamaiSignatureHeaderAuthenticationKey
Ce type décrit les paramètres d’authentification Akamai G20. L’authentification Akamai est un schéma d’authentification de message de hachage à clé. La clé d’authentification est un secret partagé par akamai CDN et le service de streaming Azure Media Origin. Azure Media Services prend uniquement en charge la version 3, qui utilise HMAC-MD5.
| Nom | Type | Description |
|---|---|---|
Identifier |
Edm.String | Identificateur de la clé d’authentification. Il s’agit du nonce fourni par Akamai. |
Expiration |
Edm.DateTime | Valeur DateTime qui spécifie l’expiration de l’authentification Akamai |
Base64Key |
Edm.String | Clé d'authentification codée en Base64, que le CDN utilise. La clé d’authentification fournie par Akamai est une chaîne encodée ASCII, qui doit être convertie en octets, puis encodée en base64. |
L’exemple C# suivant montre comment convertir la clé d’authentification Akamai en base64 :
string akamaiKey = "01234567890123456789012345678901";
string base64Key = Convert.ToBase64String(System.Text.Encoding.ASCII.GetBytes(akamaiKey);
Type complexe IPRange
| Nom | Type | Description |
|---|---|---|
Name |
Edm.String | Nom convivial pour cette plage d'adresses IP. |
Address |
Edm.String | Adresse IP de base pour la représentation du sous-réseau (par exemple :192.168.0.1). |
SubnetPrefixLength |
Edm.Int32 | Nombre de bits significatifs pour le masque de sous-réseau (par exemple, dans l'adresse IP 192.168.0.1/24, 24 représente le nombre de bits significatifs). |
Create StreamingEndpoint
Créer un service StreamingEndpoint.
Requête
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoint> | HTTP/1.1 |
Exemple de demande
Vous pouvez essayer l’exemple suivant dans l’onglet Compositeur de Fiddler.
Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.
En-têtes de requête :
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>
Corps de la requête :
{
"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>"
}
}
En cas de succès, un code d'état 202 Accepté est renvoyé avec une représentation de l'entité créée dans le corps de la réponse.
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>"
}
}
Le code d'état 202 Accepté indique une opération asynchrone, auquel cas la valeur d'en-tête de l'ID d'opération est également fournie pour être utilisée dans l'interrogation et le suivi de l'état des opérations de longue durée, comme le démarrage ou l'arrêt d'un point de terminaison de diffusion en continu. Transmettez la valeur de l'en-tête d'ID d'opération dans l'entité Operation pour récupérer l'état. Pour plus d’informations, consultez Interrogation manuelle des opérations Long-Running.
Start StreamingEndpoint
Démarrez un point de terminaison de diffusion en continu spécifié. Un point de terminaison de diffusion en continu peut être démarré seulement quand il est dans l'état Arrêté. Quelque temps après le démarrage de StreamingEdpoint, l’état devient Running.
Pour arrêter la diffusion en continu à un moment ultérieur, appelez l’opération Arrêter .
Actions disponibles dans l’état En cours d’exécution .
| État | Unités de diffusion en continu | Description | Actions disponibles |
|---|---|---|---|
| Exécution en cours | 0 | Streaming à partir du point de terminaison de streaming standard. | Stop, Scale |
| Exécution en cours | >0 | Streaming à partir du point de terminaison de streaming Premium. | Stop, Scale |
Requête
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Start | HTTP/1.1 |
Exemple de demande
Vous pouvez essayer l’exemple suivant dans l’onglet Compositeur de Fiddler.
En-têtes de requête :
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>
En cas de succès, un code d'état 202 Accepté est renvoyé. Le code d'état 202 Accepté indique une opération asynchrone, auquel cas la valeur d'en-tête de l'ID d'opération est également fournie pour être utilisée dans l'interrogation et le suivi de l'état des opérations de longue durée, comme le démarrage ou l'arrêt d'un point de terminaison de diffusion en continu. Transmettez la valeur de l'en-tête d'ID d'opération dans l'entité Operation pour récupérer l'état. Pour plus d’informations, consultez Interrogation manuelle des opérations Long-Running.
Arrêter des points de terminaison de diffusion en continu
Arrêter le point de terminaison de diffusion en continu spécifié. Un point de terminaison de diffusion en continu peut être arrêté seulement quand il est dans l'état En cours d'exécution.
Actions disponibles dans l’état Arrêté .
| État | Unités de diffusion en continu | Description | Actions disponibles |
|---|---|---|---|
| Arrêté | 0 | Pas de diffusion en continu. | Start, Scale |
| Arrêté | >0 | Pas de diffusion en continu. | Start, Scale |
Requête
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Stop | HTTP/1.1 |
Exemple de demande
Vous pouvez essayer l’exemple suivant dans l’onglet Compositeur de Fiddler.
Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.
En-têtes de requête :
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>
En cas de succès, un code d'état 202 Accepté est renvoyé. Le code d'état 202 Accepté indique une opération asynchrone, auquel cas la valeur d'en-tête de l'ID d'opération est également fournie pour être utilisée dans l'interrogation et le suivi de l'état des opérations de longue durée, comme le démarrage ou l'arrêt d'un point de terminaison de diffusion en continu. Transmettez la valeur de l'en-tête d'ID d'opération dans l'entité Operation pour récupérer l'état. Pour plus d’informations, consultez Interrogation manuelle des opérations Long-Running.
Mettre à l'échelle des points de terminaison de diffusion en continu
Met à jour dynamiquement la capacité de l’unité de streaming en cours d’exécution et change le type de point de terminaison de streaming standard en point de terminaison de streaming Premium s’il est mis à jour à partir de « ScaleUnits »:0.
Requête
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Scale | HTTP/1.1 |
Exemple de demande
Vous pouvez essayer l’exemple suivant dans l’onglet Compositeur de Fiddler.
Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.
En-têtes de requête :
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>
Corps de la requête :
{"scaleUnits" : 2}
En cas de succès, un code d'état 202 Accepté est renvoyé. Le code d'état 202 Accepté indique une opération asynchrone, auquel cas la valeur d'en-tête de l'ID d'opération est également fournie pour être utilisée dans l'interrogation et le suivi de l'état des opérations de longue durée, comme le démarrage ou l'arrêt d'un point de terminaison de diffusion en continu. Transmettez la valeur de l'en-tête d'ID d'opération dans l'entité Operation pour récupérer l'état. Pour plus d’informations, consultez Interrogation manuelle des opérations Long-Running.
Répertorier les points de terminaison de diffusion en continu
Les points de terminaison de diffusion en continu sont récupérés à l'aide d'une requête HTTP GET.
Requête
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| GET | Obtenir tous les points de terminaison de diffusion en continu : <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints> Obtenir le point de terminaison de diffusion en continu spécifié. <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') |
HTTP/1.1 |
Exemple de demande
Vous pouvez essayer l’exemple suivant dans l’onglet Compositeur de Fiddler.
Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.
En-têtes de requête :
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>
Si elle réussit, cette opération retourne un code 200 OK status et une liste de tous les points streamingEndpoints créés dans votre compte Media Services.
Mettre à jour des points de terminaison de diffusion en continu
Mettre à jour un point de terminaison de diffusion en continu avec de nouvelles valeurs de propriété. Il s'agit d'une opération asynchrone si le point de terminaison de diffusion en continu est en cours d'exécution et si les paramètres sont modifiés.
Requête
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| PATCH/PUT/MERGE Pour plus d’informations sur ces opérations, consultez PATCH/PUT/MERGE. |
<https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') | HTTP/1.1 |
Exemple de demande
Vous pouvez essayer l’exemple suivant dans l’onglet Compositeur de Fiddler. L’exemple met à jour la valeur MaxAge .
Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.
En-têtes de requête :
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>
Corps de la requête :
{"CacheControl":{"MaxAge":"2000"}}
Si la mise à jour s'effectue de manière synchrone, elle renvoie le code d'état 204 Pas de contenu. Autrement, elle renvoie le code d'état 202 Accepté. Le code d'état 202 Accepté indique une opération asynchrone, auquel cas la valeur d'en-tête de l'ID d'opération est également fournie pour être utilisée dans l'interrogation et le suivi de l'état des opérations de longue durée, comme le démarrage ou l'arrêt d'un point de terminaison de diffusion en continu. Transmettez la valeur de l'en-tête d'ID d'opération dans l'entité Operation pour récupérer l'état. Pour plus d’informations, consultez Interrogation manuelle des opérations Long-Running.
Supprimer des points de terminaison de diffusion en continu
Supprimer un point de terminaison de diffusion en continu. Un point de terminaison de diffusion en continu peut être supprimé seulement quand il est dans l'état Arrêté.
Requête
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| Suppression | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') | HTTP/1.1 |
Exemple de demande
Vous pouvez essayer l’exemple suivant dans l’onglet Compositeur de Fiddler.
Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.
En-têtes de requête :
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>
En cas de succès, un code d'état 202 Accepté est renvoyé. Le code d'état 202 Accepté indique une opération asynchrone, auquel cas la valeur d'en-tête de l'ID d'opération est également fournie pour être utilisée dans l'interrogation et le suivi de l'état des opérations de longue durée, comme le démarrage ou l'arrêt d'un point de terminaison de diffusion en continu. Transmettez la valeur de l'en-tête d'ID d'opération dans l'entité Operation pour récupérer l'état. Pour plus d’informations, consultez Interrogation manuelle des opérations Long-Running.