StreamingEndpoint
Importante
A partire dalla versione 2.7 di Servizi multimediali, l'entità Origin è stata rinominata in StreamingEndpoint.
L'entità StreamingEndpoint rappresenta un servizio di streaming in grado di fornire direttamente contenuto al lettore client oppure a una rete per la distribuzione di contenuti (CDN) per ulteriore distribuzione. A partire dalla versione 2.9, Servizi multimediali di Microsoft Azure fornisce l'integrazione della rete CDN di Azure (per altre informazioni, vedere la CdnEnabled proprietà documentata di seguito). Il flusso in uscita da un servizio StreamingEndpoint può essere un flusso live o un asset su richiesta nel proprio account di Servizi multimediali.
Ogni account di Servizi multimediali di Azure (AMS) include un flussoEndpoint predefinito; è possibile creare altri streamingEndpoint nell'account. A partire da Servizi multimediali 2.15 (rilasciati il 10 gennaio 2017) sono disponibili due versioni di StreamingEndpoint: 1.0 e 2.0. Esistono anche tre tipi di StreamingEndpoint: classic, **Standard o Premium.
Gli account di Servizi multimediali creati prima dell'aggiornamento DI AMS REST 2.15 includono per impostazione predefinita endpoint di streaming classici, versione 1.0. È possibile eseguire l'aggiornamento alla versione 2.0, non è possibile eseguire il downgrade alla versione 1.0. Gli account AMS creati dopo l'aggiornamento 2.15 includono per impostazione predefinita endpoint di streaming Standard , versione 2.0. Gli endpoint di streaming versione 2.0 hanno modifiche alla fatturazione e alle funzionalità. Per informazioni più dettagliate, vedere la StreamingEndpointVersion proprietà documentata di seguito.
StreamingEndpoint con provisioning automatico ha il nome "Default" e non può essere eliminato. Lo stato di StreamingEndpoint è Arrestato. Per avviare lo streaming, è necessario avviare l'endpoint di streaming.
Se l'account è stato creato tramite il portale di Azure classico e la rete CDN di Azure è disponibile nell'area, l'account avrà l'integrazione della rete CDN per impostazione predefinita ("CdnEnabled":true, "CdnProvider":StandardVerizon e "CdnProfile":AzureMediaStreamingPlatformCdnProfile).
Nella maggior parte dei casi, è consigliabile mantenere abilitata la rete CDN. Se, tuttavia, si prevede che la concorrenza massima sia inferiore a 500 visualizzatori, è consigliabile disabilitare la rete CDN perché la modalità di concorrenza consente un miglior ridimensionamento della rete.
Panoramica degli endpoint di streaming Classico, Standard, Premium
Le funzionalità avanzate descritte in questa sezione includono pacchetti dinamici e crittografia dinamica.
In questa tabella viene fornito un riepilogo dei comportamenti:
| Tipo | Versione | ScaleUnits | Funzionalità avanzate | RETE CDN | Fatturazione |
|---|---|---|---|---|---|
| Classico | 1,0 | 0 | N/D | N/D | Gratuito |
| Endpoint di streaming Standard (scelta consigliata) | 2.0 | 0 | Sì | Sì | Paid |
| Endpoint di streaming Premium | 1,0 | >0 | Sì | Sì | Paid |
| Endpoint di streaming Premium | 2.0 | >0 | Sì | Sì | Paid |
È consigliabile aggiornare gli endpoint di streaming classici agli endpoint di streaming Standard per ottenere un'esperienza migliore e funzionalità avanzate. Lo streaming standard ridimensiona automaticamente la larghezza di banda in uscita.
Il tipo Standard rappresenta la scelta consigliata per tutti gli scenari di streaming e per qualsiasi numero di destinatari. Per i clienti con requisiti estremamente impegnativi AMS offre anche endpoint di streaming Premium , che possono essere usati per aumentare la capacità per i più grandi destinatari Internet. Se si prevedono destinatari di grandi dimensioni e visualizzatori simultanei, contattare microsoft per indicazioni su se è necessario passare al tipo Premium . Un buon post di guida è quello di contattarci (amsstreaming in microsoft.com) se si prevede una dimensione del pubblico simultanea superiore a 50.000 spettatori.
Si passa a un tipo Premium modificando le unità di scala. Le unità di scalabilità offrono una capacità di uscita dedicata che può essere acquistata in incrementi di 200 Mbps. Quando si usa il tipo Premium, ogni unità abilitata fornisce all'applicazione una capacità di larghezza di banda aggiuntiva. Per altre informazioni, vedere Come ridimensionare StreamingEndpoint.
Per altre informazioni, vedere Streaming endpoints overview (Panoramica degli endpoint di streaming).
Proprietà e operazioni di StreamingEndpoint
Importante
Quando si accede alle entità in Servizi multimediali, è necessario impostare valori e campi di intestazione specifici nelle richieste HTTP.
Per altre informazioni, vedere Configurazione per lo sviluppo di API REST di Servizi multimediali e connessione a Servizi multimediali con l'API REST di Servizi multimediali.
Questa sezione offre una panoramica dell'entità e illustra anche come eseguire varie operazioni con l'API StreamingEndpoint REST di Servizi multimediali.
Entità StreamingEndpoint
L'entità StreamingEndpoint contiene le proprietà seguenti:
| Proprietà | Type | Descrizione |
|---|---|---|
IdDi sola lettura. Impostata da Servizi multimediali. |
Edm.String | ID dell'entità StreamingEndpoint, assegnato al momento della creazione. Il formato è: nb:oid:UUID:<GUID>. |
Name |
Edm.String | Nome descrittivo del servizio StreamingEndpoint. - Deve essere univoco all'interno dell'account di Servizi multimediali. - Lunghezza massima = 32 caratteri. - Impossibile contenere spazi. - Trattini e caratteri alfanumerici solo. - Impossibile iniziare o terminare con un trattino. |
Description |
Edm.String | Descrizione dell'entità StreamingEndpoint. La lunghezza massima è 256 caratteri. |
CreatedDi sola lettura. Impostata da Servizi multimediali. |
Edm.DateTime | Creato dal servizio Servizi multimediali di Microsoft Azure Live Streaming Preview. |
StateDi sola lettura. Impostata da Servizi multimediali. |
Edm.Int32 | I valori della proprietà includono: - Arrestato. Stato iniziale di un'entità StreamingEndpoint dopo la creazione. - Avvio in corso. L'entità StreamingEndpoint sta passando allo stato di esecuzione. - In esecuzione. L'entità StreamingEndpoint è in grado di trasmettere contenuti in streaming ai client. - Ridimensionamento. Si stanno aumentando o diminuendo le unità di streaming (ScaleUnits). - Arresto in corso. L'entità StreamingEndpoint sta passando allo stato arrestato. |
HostNameDi sola lettura. Impostata da Servizi multimediali. |
Edm.String | Nome host dell'endpoint di streaming predefinito. |
LastModifiedDi sola lettura. Impostata da Servizi multimediali. |
Edm.DateTime | Ora dell'ultimo aggiornamento per l'entità. |
ScaleUnitsDi sola lettura. |
Edm.Int32 | Numero di endpoint di streaming Premium allocati per la distribuzione streamingEndpoint. Quando l'entità StreamingEndpoint è nello stato Running, le unità di streaming per StreamingEndpoint possono essere aumentate chiamando l'operazione Scale.Questa proprietà controlla anche il tipo di endpoint di streaming con la combinazione della versione dell'endpoint di streaming. Se la versione dell'endpoint di streaming è 1.0 e ScaleUnits=0, l'endpoint di streaming è di un tipo classico . Le proprietà di StreamingEndpoint seguenti possono essere configurate solo se l'endpoint di streaming è standard o Premium: AccessControl, CustomHostNames, CacheControl, CrossSiteAccessPolicies. |
CdnEnabledQuesta proprietà è stata aggiunta nella versione 2.9 di Servizi multimediali. |
Edm.Boolean |
Indica se l'integrazione con la rete CDN di Azure è abilitata o meno per StreamingEndpoint (disabilitata per impostazione predefinita). Per impostare su CdnEnabled true, StreamingEndpoint deve avere almeno un endpoint di streaming Premium (ScaleUnits) per la versione 1.0 StreamingEndpoints e essere nello stato arrestato. È possibile impostare questa proprietà se StreamingEndpoint versione è 2.0 indipendentemente dal valore ScaleUnits (vedere Endpoint di streaming standard ) Usare l'API REST operation per controllare lo stato. Dopo l'abilitazione, le configurazioni seguenti vengono disabilitate: CustomHostNames e AccessControl.Nota: non tutti i data center supportano l'integrazione della rete CDN di Azure. Per verificare se per il data center in questione supporta l'integrazione della rete CDN di Azure, eseguire le operazioni seguenti: - Provare a impostare CdnEnabled su true.- Controllare il risultato restituito per un HTTP Error Code 412 oggetto (PrecondizioneFailed) con il messaggio "La proprietà CdnEnabled dell'endpoint di streaming non può essere impostata su true perché la funzionalità della rete CDN non è disponibile nell'area corrente".Se viene restituito questo errore, il data center non supporta l'integrazione ed è necessario provare con un altro data center. |
CdnProviderQuesta proprietà è stata aggiunta in Servizi multimediali 2.15. |
Edm.String | Quando la rete CDN è abilitata ("CdnEnabled":true), è anche possibile passare i valori CdnProvider. CdnProvider controlla quale provider verrà usato. Sono attualmente supportati tre valori: "StandardVerizon", "PremiumVerizon" e "StandardAkamai". Se non viene specificato alcun valore e viene usato "CdnEnabled":true, viene usato "StandardVerizon" (ovvero il valore predefinito). Esempio: "CdnProvider":"StandardAkamai". Nota: StreamingEndpoints, che sono "CDNEnabled":true con le versioni precedenti di AMS (<2.15) ha un'integrazione della rete CDN legacy e usa il provider di rete CDN "StandardVerizon". È consigliabile eseguire la migrazione di StreamingEndpoints alla nuova integrazione della rete CDN per ottenere un'esperienza migliore e una funzionalità completa. |
CdnProfileQuesta proprietà è stata aggiunta in Servizi multimediali 2.15. |
Edm.String | Quando la rete CDN è abilitata ("CdnEnabled":true), è anche possibile passare i valori CdnProfile. "CdnProfile" è il nome del profilo della rete CDN in cui verrà creato il punto endpoint della rete CDN. È possibile specificare un CdnProfile esistente o usarne uno nuovo. Se value è NULL e "CdnEnabled":true, viene usato il valore predefinito "AzureMediaStreamingPlatformCdnProfile". Se il cdnProfile specificato esiste già, ne viene creato un endpoint. Se il profilo non esiste, ne viene creato automaticamente uno nuovo. Esempio: "CdnProfile":"AzureMediaStreamingPlatformCdnProfile". |
FreeTrialEndTimeDi sola lettura. Questa proprietà è stata aggiunta in Servizi multimediali 2.15. |
Edm.DateTime | Quando viene creato un nuovo account di servizi multimediali, viene eseguito automaticamente il provisioning di un endpoint di streaming standard predefinito nell'account, in stato arrestato. Questo endpoint include un periodo di valutazione gratuito di 15 giorni e il periodo di valutazione inizia quando l'endpoint viene avviato per la prima volta. La versione di valutazione gratuita non si applica agli account esistenti e la data di fine non cambia con transizioni di stato, ad esempio stop/start. La versione di valutazione gratuita inizia la prima volta che si avvia l'endpoint di streaming e termina dopo 15 giorni di calendario. La versione di valutazione gratuita si applica solo all'endpoint di streaming predefinito e non si applica ad endpoint di streaming aggiuntivi. Quando l'endpoint viene appena creato e è in stato arrestato, il valore di "FreeTrialEndTime" è impostato su "0001-01-01T00:00:00Z". All'avvio, alla data di inizio vengono aggiunti 15 giorni e il valore inizia a rappresentare la data di fine della versione di valutazione gratuita "FreeTrialEndTime":"2016-12-16T18:01:47.8524725Z". I valori per gli endpoint di streaming non idonei per la versione di valutazione gratuita saranno sempre "FreeTrialEndTime":"0001-01-01T00:00:00Z" indipendentemente dallo stato. Esempi: "FreeTrialEndTime":"2016-12-16T18:01:47.8524725Z" "FreeTrialEndTime":"0001-01-01T00:00:00Z" |
StreamingEndpointVersionQuesta proprietà è stata aggiunta in Servizi multimediali 2.15. |
Edm.String | La combinazione di StreamingEndpointVersion e ScaleUnits controlla il tipo di endpoint di streaming. Qualsiasi endpoint di streaming creato prima dell'aggiornamento 2.15 (10 gennaio 2017) avrà "StreamingEndpointVersion":"1.0" e gli endpoint di streaming creati dopo l'aggiornamento avranno "StreamingEndpointVersion":"2.0". Gli endpoint di streaming, che sono la versione 1.0, non verranno aggiornati automaticamente alla versione 2.0, ma possono essere aggiornati in modo esplicito a "StreamingEndpointVersion":"2.0". Endpoint di streaming con "ScaleUnits":0 e "StreamingEndpointVersion":"1.0" verranno considerati endpoint di streaming classici , che non dispongono di funzionalità avanzate come la creazione dinamica dei pacchetti o la crittografia dinamica. Gli endpoint di streaming con "ScaleUnits" > 0 (se "StreamingEndpointVersion" è impostato sulla versione "1.0" o versione "2.0") sono unità Premium . Endpoint di streaming standard con "ScaleUnits":0 e "StreamingEndpointVersion":"2.0" includeranno le stesse funzionalità delle unità Premium (che includono la creazione dinamica dei pacchetti e la crittografia dinamica). È possibile aggiornare un endpoint di streaming classico allo standard impostando la versione su "StreamingEndpointVersion":"2.0". Si tratta di un'operazione unidirezionale; non è possibile effettuare il downgrade della versione 2.0 alla 1.0. Tenere presente che questa operazione non può essere sottoposta a rollback e influisce sul prezzo. La propagazione della nuova configurazione può richiedere fino a 30 minuti. Durante questo intervallo di tempo, l'endpoint funzionerà in modalità danneggiata e potrebbero verificarsi errori per la creazione dinamica dei pacchetti e le richieste di crittografia dinamica. Esempi: "StreamingEndpointVersion":"2.0" "StreamingEndpointVersion":"1.0" |
CustomHostNamesFacoltativa. |
Collection(Edm.String) | Viene usata per configurare un endpoint di streaming in modo che accetti il traffico indirizzato a un nome host personalizzato. Semplifica la configurazione della gestione del traffico tramite uno strumento di gestione del traffico globale e l'uso di nomi di dominio personalizzati come nome dell'endpoint di streaming. La proprietà del nome di dominio deve essere confermata da Servizi multimediali di Azure, che la verifica richiedendo un record CName contenente l'ID dell'account di Servizi multimediali come un componente da aggiungere al dominio in uso. Ad esempio, per "sports.contoso.com" da usare come nome host personalizzato per l'endpoint di streaming, è necessario configurare un record per "<accountId.contoso.com>" in modo che punti a uno dei nomi host di verifica di Servizi multimediali. Il nome host di verifica è costituito da verifydns.<mediaservices-dns-zone>. La tabella seguente contiene le zone DNS da usare nel record di verifica per le diverse aree di Azure.America del Nord, Europa, Singapore, Hong Kong, Giappone: - mediaservices.windows.net - verifydns.mediaservices.windows.net Cina: - mediaservices.chinacloudapi.cn - verifydns.mediaservices.chinacloudapi.cn Ad esempio, un record CName che esegue il mapping di "945a4c4e-28ea-45cd-8ccb-a519f6b700ad.contoso.com" a "verifydns.mediaservices.windows.net" dimostra che l'ID di Servizi multimediali 945a4c4e-28ea-45cd-8ccb-a519f6b700ad è proprietario del dominio contoso.com, consentendo di usare qualsiasi nome in contoso.com come nome host personalizzato per un endpoint di streaming di tale account.Per individuare il valore dell'ID di Servizi multimediali, passare al portale di Azure e selezionare l'account di Servizi multimediali. L'ID di Servizi multimediali viene visualizzato a destra della pagina DASHBOARD. Avviso: se si tenta di impostare un nome host personalizzato senza l'adeguata verifica del record CName, la risposta DNS avrà esito negativo e verrà memorizzata nella cache per un certo tempo. Una volta definito il record corretto, potrebbe essere necessario del tempo prima che la risposta memorizzata nella cache venga nuovamente convalidata. A seconda del provider DNS del dominio personalizzato, la nuova convalida potrebbe richiedere da alcuni minuti a un'ora.Oltre al CName che esegue il mapping di <accountId>.<parent domain> a verifydns.<mediaservices-dns-zone>, è necessario creare un altro CName che esegue il mapping del nome host personalizzato (ad esempio sports.contoso.com) al nome host StreamingEndpoint di Servizi multimediali (ad esempio amstest.streaming.mediaservices.windows.net).Nota: gli endpoint di streaming che si trovano nello stesso data center non possono condividere lo stesso nome host personalizzato. Questa proprietà è valida per gli endpoint di streaming Standard e Premium e può essere impostata quando "CdnEnabled":false Si noti che attualmente AMS non supporta SSL con domini personalizzati. |
AccessControl |
StreamingEndpointAccessControl ComplexType | Consente di configurare le impostazioni di sicurezza seguenti per questo endpoint di streaming: chiavi di autenticazione intestazione firma Akamai e indirizzi IP autorizzati a connettersi a questo endpoint. Nota: questa proprietà è valida per gli endpoint di streaming Standard e Premium e può essere impostata quando "CdnEnabled":false |
CacheControl |
StreamingEndpointCacheControl | Usata per configurare la durata cache per gli asset serviti tramite questo endpoint di streaming. |
CrossSiteAccessPolicies |
CrossSiteAccessPolicies | Viene usata per specificare i criteri di accesso intersito per vari client. Per altre informazioni, vedere Cross-domain policy file specification (Specifica dei file di criteri tra domini) e Making a Service Available Across Domain Boundaries(Disponibilità di un servizio tra confini di dominio). |
StreamingEndpointCacheControl
| Nome | Tipo | Descrizione |
|---|---|---|
MaxAgeFacoltativa. |
Edm.Int64 | Esegue l'override della validità massima predefinita dell'intestazione della cache di controllo HTTP impostata dall'endpoint di streaming per i frammenti multimediali e i manifesti su richiesta. Il valore è impostato in secondi. |
StreamingEndpointAccessControl ComplexType
| Nome | Tipo | Descrizione |
|---|---|---|
Akamai |
AkamaiAccessControl | Controllo di accesso Akamai. |
IP |
IPAccessControl | Controllo di accesso IP. |
AkamaiAccessControl
| Nome | Tipo | Descrizione |
|---|---|---|
| AkamaiSignatureHeaderAuthenticationKeyList | AkamaiSignatureHeaderAuthenticationKey ComplexType | Contiene informazioni sulle chiavi di autenticazione dell'intestazione firma Akamai. |
IPAccessControl
| Nome | Tipo | Descrizione |
|---|---|---|
| Allow | IPRange ComplexType | Definisce gli indirizzi IP che possono connettersi a un endpoint di streaming. Nota: l'impostazione di questo valore su Null consente a tutti gli indirizzi di origine IP di connettersi. Impostando questo valore su una stringa vuota (""), non potrà essere connesso alcun indirizzo IP. |
AkamaiSignatureHeaderAuthenticationKey ComplexType
Questo tipo descrive le impostazioni di autenticazione di Akamai G20. L'autenticazione Akamai è uno schema di autenticazione del messaggio hash chiave. La chiave di autenticazione è un segreto condiviso dalla rete CDN Akamai e dal servizio di streaming di Azure Media Origin. Servizi multimediali di Azure supporta solo la versione 3, che usa HMAC-MD5.
| Nome | Tipo | Descrizione |
|---|---|---|
Identifier |
Edm.String | Identificatore della chiave di autenticazione. Questo è il nonce fornito da Akamai. |
Expiration |
Edm.DateTime | Valore DateTime che specifica quando l'autenticazione Akamai scade |
Base64Key |
Edm.String | Chiave di autenticazione con codifica Base 64 che verrà usata dalla rete CDN. La chiave di autenticazione fornita da Akamai è una stringa con codifica ASCII e deve essere convertita in byte e quindi codificata in base64. |
Nell'esempio C# seguente viene illustrato come convertire la chiave di autenticazione Akamai in base64:
string akamaiKey = "01234567890123456789012345678901";
string base64Key = Convert.ToBase64String(System.Text.Encoding.ASCII.GetBytes(akamaiKey);
IPRange ComplexType
| Nome | Tipo | Descrizione |
|---|---|---|
Name |
Edm.String | Nome descrittivo per l'intervallo IP. |
Address |
Edm.String | Indirizzo IP di base per la rappresentazione di subnet, ad esempio 192.168.0.1. |
SubnetPrefixLength |
Edm.Int32 | Numero di bit significativi per la subnet mask. Nell'indirizzo IP 192.168.0.1/24, ad esempio, 24 rappresenta il numero di bit significativi. |
Creare un'entità StreamingEndpoint
Creare un nuovo servizio StreamingEndpoint.
Richiesta
| Metodo | URI richiesta | Versione HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoint> | HTTP/1.1 |
Richiesta di esempio
È possibile provare l'esempio seguente nella scheda Compositore di Fiddler.
Per ottenere l'ultima versione x-ms-version:, vedere REST servizi multimediali.
Intestazioni della richiesta:
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>
Corpo della richiesta:
{
"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>"
}
}
Se l'esito è positivo, nel corpo della risposta viene restituito un codice di stato 202 Accettato insieme a una rappresentazione dell'entità creata.
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>"
}
}
Il codice di stato 202 Accettato indica un'operazione asincrona, nel qual caso viene fornito anche il valore dell'intestazione operation-id che viene usato per il polling e per il rilevamento dello stato delle operazioni di lunga esecuzione, ad esempio l'avvio o l'arresto di un'entità StreamingEndpoint. Passare il valore dell'intestazione operation-id nell'entità Operation per recuperare lo stato. Per altre informazioni, vedere Polling manuale delle operazioni Long-Running.
Avviare un'entità StreamingEndpoint
Avviare l'entità StreamingEndpoint specificata. Un'entità StreamingEndpoint può essere avviata solo quando si trova nello stato Arrestato. Dopo l'avvio di StreamingEdpoint, lo stato viene modificato in Running.
Per arrestare lo streaming in un secondo momento, chiamare l'operazione Arresta .
Azioni disponibili quando si trova nello stato In esecuzione .
| State | Unità di streaming | Descrizione | Azioni disponibili |
|---|---|---|---|
| In esecuzione | 0 | Streaming dall'endpoint di streaming standard. | Arresto, scalabilità |
| In esecuzione | >0 | Streaming dall'endpoint di streaming Premium. | Arresto, scalabilità |
Richiesta
| Metodo | URI richiesta | Versione HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Start | HTTP/1.1 |
Richiesta di esempio
È possibile provare l'esempio seguente nella scheda Compositore di Fiddler.
Intestazioni della richiesta:
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>
Se l'esito è positivo, viene restituito un codice di stato 202 Accettato. Il codice di stato 202 Accettato indica un'operazione asincrona, nel qual caso viene fornito anche il valore dell'intestazione operation-id che viene usato per il polling e per il rilevamento dello stato delle operazioni di lunga esecuzione, ad esempio l'avvio o l'arresto di un'entità StreamingEndpoint. Passare il valore dell'intestazione operation-id nell'entità Operation per recuperare lo stato. Per altre informazioni, vedere Polling manuale delle operazioni Long-Running.
Arrestare le entità StreamingEndpoint
Arrestare l'entità StreamingEndpoint specificata. Un'entità StreamingEndpoint può essere arrestata solo quando si trova nello stato In esecuzione.
Azioni disponibili quando nello stato arrestato .
| State | Unità di streaming | Descrizione | Azioni disponibili |
|---|---|---|---|
| Arrestato | 0 | Nessun flusso. | Avvio, scalabilità |
| Arrestato | >0 | Nessun flusso. | Avvio, scalabilità |
Richiesta
| Metodo | URI richiesta | Versione HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Stop | HTTP/1.1 |
Richiesta di esempio
È possibile provare l'esempio seguente nella scheda Compositore di Fiddler.
Per ottenere l'ultima versione x-ms-version:, vedere REST servizi multimediali.
Intestazioni della richiesta:
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>
Se l'esito è positivo, viene restituito un codice di stato 202 Accettato. Il codice di stato 202 Accettato indica un'operazione asincrona, nel qual caso viene fornito anche il valore dell'intestazione operation-id che viene usato per il polling e per il rilevamento dello stato delle operazioni di lunga esecuzione, ad esempio l'avvio o l'arresto di un'entità StreamingEndpoint. Passare il valore dell'intestazione operation-id nell'entità Operation per recuperare lo stato. Per altre informazioni, vedere Polling manuale delle operazioni Long-Running.
Scalare le entità StreamingEndpoint
Aggiorna dinamicamente la capacità dell'unità di streaming durante lo stato in esecuzione e modifica il tipo da Endpoint di streaming Standard a Endpoint di streaming Premium se aggiornato da "ScaleUnits":0.
Richiesta
| Metodo | URI richiesta | Versione HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Scale | HTTP/1.1 |
Richiesta di esempio
È possibile provare l'esempio seguente nella scheda Compositore di Fiddler.
Per ottenere l'ultima versione x-ms-version:, vedere REST servizi multimediali.
Intestazioni della richiesta:
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>
Corpo della richiesta:
{"scaleUnits" : 2}
Se l'esito è positivo, viene restituito un codice di stato 202 Accettato. Il codice di stato 202 Accettato indica un'operazione asincrona, nel qual caso viene fornito anche il valore dell'intestazione operation-id che viene usato per il polling e per il rilevamento dello stato delle operazioni di lunga esecuzione, ad esempio l'avvio o l'arresto di un'entità StreamingEndpoint. Passare il valore dell'intestazione operation-id nell'entità Operation per recuperare lo stato. Per altre informazioni, vedere Polling manuale delle operazioni Long-Running.
Elencare le entità StreamingEndpoint
Le entità StreamingEndpoint possono essere recuperate tramite una richiesta HTTP GET.
Richiesta
| Metodo | URI richiesta | Versione HTTP |
|---|---|---|
| GET | Ottenere tutte le entità StreamingEndpoint: <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints> Ottenere l'entità StreamingEndpoint specificata. <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') |
HTTP/1.1 |
Richiesta di esempio
È possibile provare l'esempio seguente nella scheda Compositore di Fiddler.
Per ottenere l'ultima versione x-ms-version:, vedere REST servizi multimediali.
Intestazioni della richiesta:
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>
In caso di esito positivo, questa operazione restituisce un codice di stato 200 OK e un elenco di tutti i punti streaming creati nell'account di Servizi multimediali.
Aggiornare le entità StreamingEndpoint
Aggiornare un'entità StreamingEndpoint con i nuovi valori della proprietà. Questa è un'operazione asincrona se l'entità StreamingEndpoint è in esecuzione e le impostazioni vengono modificate.
Richiesta
| Metodo | URI richiesta | Versione HTTP |
|---|---|---|
| PATCH/PUT/MERGE Per altre informazioni su queste operazioni, vedere PATCH/PUT/MERGE. |
<https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') | HTTP/1.1 |
Richiesta di esempio
È possibile provare l'esempio seguente nella scheda Compositore di Fiddler. Nell'esempio viene aggiornato il valore MaxAge .
Per ottenere l'ultima versione x-ms-version:, vedere REST servizi multimediali.
Intestazioni della richiesta:
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>
Corpo della richiesta:
{"CacheControl":{"MaxAge":"2000"}}
Se l'aggiornamento viene completato in modo sincrono, restituisce un codice di stato 204 Nessun contenuto. In caso contrario, restituisce un codice di stato 202 Accettato. Il codice di stato 202 Accettato indica un'operazione asincrona, nel qual caso viene fornito anche il valore dell'intestazione operation-id che viene usato per il polling e per il rilevamento dello stato delle operazioni di lunga esecuzione, ad esempio l'avvio o l'arresto di un'entità StreamingEndpoint. Passare il valore dell'intestazione operation-id nell'entità Operation per recuperare lo stato. Per altre informazioni, vedere Polling manuale delle operazioni Long-Running.
Eliminare le entità StreamingEndpoint
Eliminare un'entità StreamingEndpoint. Un'entità StreamingEndpoint può essere eliminata solo quando si trova nello stato Arrestato.
Richiesta
| Metodo | URI richiesta | Versione HTTP |
|---|---|---|
| DELETE | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') | HTTP/1.1 |
Richiesta di esempio
È possibile provare l'esempio seguente nella scheda Compositore di Fiddler.
Per ottenere l'ultima versione x-ms-version:, vedere REST servizi multimediali.
Intestazioni della richiesta:
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>
Se l'esito è positivo, viene restituito un codice di stato 202 Accettato. Il codice di stato 202 Accettato indica un'operazione asincrona, nel qual caso viene fornito anche il valore dell'intestazione operation-id che viene usato per il polling e per il rilevamento dello stato delle operazioni di lunga esecuzione, ad esempio l'avvio o l'arresto di un'entità StreamingEndpoint. Passare il valore dell'intestazione operation-id nell'entità Operation per recuperare lo stato. Per altre informazioni, vedere Polling manuale delle operazioni Long-Running.