StreamingEndpoint
Önemli
Media Services 2.7'den başlayarak varlık Origin
olarak yeniden adlandırıldı StreamingEndpoint
.
Varlık, StreamingEndpoint
içeriği doğrudan bir istemci oynatıcı uygulamasına veya daha fazla dağıtım için Content Delivery Network'e (CDN) teslim eden bir akış hizmetini temsil eder. Sürüm 2.9'dan başlayarak Microsoft Azure Media Services Azure CDN tümleştirmesini sağlar (daha fazla bilgi için aşağıda belgelenen özelliğe bakınCdnEnabled
). StreamingEndpoint hizmetinden giden akış canlı akış veya Media Services hesabınızdaki isteğe bağlı video varlığı olabilir.
Her Azure Media Services (AMS) hesabı varsayılan bir StreamingEndpoint içerir; hesabı altında ek StreamingEndpoint'ler oluşturulabilir. Media Services 2.15'den (10 Ocak 2017'de yayımlandı) başlayarak iki StreamingEndpoint sürümü vardır: 1.0 ve 2.0. Ayrıca üç tür StreamingEndpoint vardır: Klasik, **Standart veya Premium.
AMS REST 2.15 güncelleştirmeden önce oluşturulan Media Services hesapları varsayılan olarak Klasik akış uç noktaları, sürüm 1.0'ı içerir. Sürüm 2.0'a yükseltebilir, 1.0 sürümüne düşüremezsiniz. 2.15 güncelleştirmesinin ardından oluşturulan AMS hesapları varsayılan olarak Standart akış uç noktaları, sürüm 2.0'ı içerir. Sürüm 2.0 akış uç noktalarının faturalama ve özellik değişiklikleri vardır. Daha ayrıntılı bilgi için aşağıda belgelenen özelliğe bakın StreamingEndpointVersion
.
Otomatik olarak sağlanan StreamingEndpoint "Varsayılan" adına sahiptir ve silinemez. StreamingEndpoint'in durumu Durduruldu şeklindedir. Akışı başlatmak için akış uç noktasını başlatmanız gerekir.
Hesabı klasik Azure portalı aracılığıyla oluşturduysanız ve Azure CDN bölgede kullanılabiliyorsa, hesap varsayılan olarak CDN tümleştirmesine sahip olur ("CdnEnabled":true, "CdnProvider":StandardVerizon ve "CdnProfile":AzureMediaStreamingPlatformCdnProfile).
Çoğu durumda CDN'yi etkin tutmanız gerekir. Ancak eşzamanlı görüntüleyici sayısının 500'ün altında olmasını bekliyorsanız CDN en iyi ölçeklendirme performansını eşzamanlılık ile birlikte sunduğundan CDN'yi devre dışı bırakmanız önerilir.
Klasik, Standart, Premium akış uç noktalarına genel bakış
Bu bölümde açıklanan gelişmiş özelliklerdinamik paketleme ve dinamik şifreleme içerir.
Tabloda davranış özetlemektedir:
Tür | Sürüm | ScaleUnits | Gelişmiş özellikler | CDN | Faturalama |
---|---|---|---|---|---|
Klasik | 1.0 | 0 | NA | NA | Ücretsiz |
Standart Akış Uç Noktası (önerilen) | 2.0 | 0 | Yes | Yes | Ücretli |
Premium Akış Uç Noktası | 1.0 | >0 | Yes | Yes | Ücretli |
Premium Akış Uç Noktası | 2.0 | >0 | Yes | Yes | Ücretli |
Daha iyi bir deneyim ve gelişmiş özellikler elde etmek için Klasik akış uç noktalarınızı Standart akış uç noktalarına yükseltmeniz önerilir. Standart akış ayrıca giden bant genişliğini otomatik olarak ölçeklendirir.
Standart tür, neredeyse tüm akış senaryoları ve hedef kitleler için önerilen seçenektir. Son derece zorlu gereksinimleri olan müşteriler için AMS, en büyük internet kitleleri için kapasitenin ölçeğini genişletmek için kullanılabilecek Premium akış uç noktaları da sunar. Büyük izleyiciler ve eşzamanlı izleyiciler bekliyorsanız, Premium türüne geçmeniz gerekip gerekmediği konusunda rehberlik için lütfen bizimle iletişime geçin. 50.000 izleyiciden daha büyük bir eş zamanlı hedef kitle boyutu bekliyorsanız bizimle iletişime geçmek (microsoft.com'de akış) iyi bir kılavuz gönderisidir.
Ölçek birimlerini ayarlayarak Premium türe geçersiniz. Ölçek birimleri, 200 Mb/sn'lik artışlarla satın alınabilecek ayrılmış çıkış kapasitesi sağlar. Premium türü kullandığınızda etkinleştirilen her birim, uygulamaya ek bant genişliği kapasitesi sağlar. Daha fazla bilgi için bkz . StreamingEndpoint'i Ölçeklendirme.
Daha fazla bilgi için bkz. Akış uç noktalarına genel bakış.
StreamingEndpoint özellikleri ve işlemleri
Önemli
Media Services'teki varlıklara erişirken, HTTP isteklerinizde belirli üst bilgi alanlarını ve değerlerini ayarlamanız gerekir.
Daha fazla bilgi için bkz. Media Services REST API Geliştirme kurulumu ve Media Services REST API ile Media Services'a Bağlanma.
Bu bölümde varlığa genel bir bakış StreamingEndpoint
ve Media Services REST API ile çeşitli işlemlerin nasıl yürütülecekleri gösterilmektedir.
StreamingEndpoint Varlığı
Varlık StreamingEndpoint
aşağıdaki özellikleri içerir:
Özellik | Tür | Description |
---|---|---|
Id Salt okunur. Media Services tarafından ayarlanır. |
Edm.String | Oluşturma sırasında atanan StreamingEndpoint Kimliği. Biçim: nb:oid:UUID:<GUID>. |
Name |
Edm.String | StreamingEndpoint hizmetinin kolay adı. - Media Services hesabınızda benzersiz olmalıdır. - Maksimum uzunluk = 32 karakter. - Boşluk içeremez. - Yalnızca kısa çizgiler ve alfasayısal karakterler. - Kısa çizgiyle başlayamaz veya bitemez. |
Description |
Edm.String | StreamingEndpoint'in açıklaması. Uzunluk üst sınırı 256 karakterdir. |
Created Salt okunur. Media Services tarafından ayarlanır. |
Edm.DateTime | Microsoft Azure Media Services Canlı Akış Önizleme hizmeti tarafından oluşturulur. |
State Salt okunur. Media Services tarafından ayarlanır. |
Edm.Int32 | özelliğinin değerleri şunlardır: -Durdu. StreamingEndpoint'in oluşturulduktan sonraki ilk durumu. -Başlangıç. StreamingEndpoint çalışır duruma geçiliyor. -Çalışan. StreamingEndpoint istemcilere içerik akışı yapabilir. -Ölçekleme. Akış birimleri (ScaleUnits) artırılıyor veya azaltılıyor. -Durdurma. StreamingEndpoint durdurulmuş duruma geçiliyor. |
HostName Salt okunur. Media Services tarafından ayarlanır. |
Edm.String | Varsayılan akış uç noktası ana bilgisayar adı. |
LastModified Salt okunur. Media Services tarafından ayarlanır. |
Edm.DateTime | Bu varlık için son güncelleştirme zamanı. |
ScaleUnits Salt okunur. |
Edm.Int32 | StreamingEndpoint dağıtımı için ayrılan premium akış uç noktalarının sayısı. StreamingEndpoint durumundayken Running StreamingEndpoint üzerindeki akış birimlerinin ölçeği, işlemi çağrılarak Scale artırılabilir.Bu özellik, akış uç noktası türünü akış uç noktası sürümünün birleşimiyle de denetler. Akış uç noktası sürümünüz 1.0 ve ScaleUnits=0 ise akış uç noktası klasik türdedir. Aşağıdaki StreamingEndpoint özellikleri yalnızca akış uç noktanız standart veya premium olduğunda yapılandırılabilir: AccessControl , CustomHostNames , CacheControl , CrossSiteAccessPolicies . |
CdnEnabled Bu özellik Media Services 2.9'a eklendi. |
Edm.Boolean |
Bu StreamingEndpoint için Azure CDN tümleştirmesinin etkinleştirilip etkinleştirilmediğini gösterir (varsayılan olarak devre dışıdır.) değerini true olarak ayarlamak CdnEnabled için StreamingEndpoint'in sürüm 1.0 StreamingEndpoints için en az bir premium akış uç noktası (ScaleUnits ) olması ve durdurulmuş durumda olması gerekir. StreamingEndpoint sürümü ScaleUnits değerinden bağımsız olarak 2.0 ise bu özelliği ayarlayabilirsiniz (lütfen Standart akış uç noktasına bakın) Durumu denetlemek için İşlem REST API'sini kullanın. Etkinleştirildikten sonra aşağıdaki yapılandırmalar devre dışı bırakılır: CustomHostNames ve AccessControl .Not: Tüm veri merkezleri Azure CDN tümleştirmesini desteklemez. Veri merkezinizde Azure CDN tümleştirmesinin kullanılabilir olup olmadığını denetlemek için aşağıdakileri yapın: - değerini true olarak ayarlamayı CdnEnabled deneyin.- "CdnEnabled akış uç noktası cdnenabled özelliği geçerli bölgede cdn özelliği kullanılamadığından true olarak ayarlanamaz" iletisini içeren bir (PreconditionFailed) için HTTP Error Code 412 döndürülen sonucu denetleyin.Bu hatayı alırsanız veri merkezi bunu desteklemez. Başka bir veri merkezi denemeniz gerekir. |
CdnProvider Bu özellik Media Services 2.15'e eklendi. |
Edm.String | CDN etkinleştirildiğinde ("CdnEnabled":true) CdnProvider değerlerini de geçirebilirsiniz. CdnProvider hangi sağlayıcının kullanılacağını denetler. Şu anda üç değer desteklenmektedir: "StandardVerizon", "PremiumVerizon" ve "StandardAkamai". Hiçbir değer sağlanmazsa ve "CdnEnabled":true, "StandardVerizon" kullanılır (bu varsayılan değerdir).) Örnek: "CdnProvider":"StandardAkamai". Not: Eski AMS sürümleriyle (<2.15) "CDNEnabled":true olan StreamingEndpoint'ler eski bir CDN tümleştirmesine sahiptir ve "StandardVerizon" CDN sağlayıcısını kullanır. Daha iyi bir deneyim ve tam özellik elde etmek için StreamingEndpoints'inizi daha yeni CDN tümleştirmesine geçirmeniz önerilir. |
CdnProfile Bu özellik Media Services 2.15'e eklendi. |
Edm.String | CDN etkinleştirildiğinde ("CdnEnabled":true) CdnProfile değerlerini de geçirebilirsiniz. "CdnProfile", CDN uç noktası oluşturulacak CDN profilinin adıdır. Mevcut bir CdnProfile sağlayabilir veya yenisini kullanabilirsiniz. Değer NULL ve "CdnEnabled":true ise, "AzureMediaStreamingPlatformCdnProfile" varsayılan değeri kullanılır. Sağlanan CdnProfile zaten varsa, altında bir uç nokta oluşturulur. Profil yoksa, otomatik olarak yeni bir profil oluşturulur. Örnek: "CdnProfile":"AzureMediaStreamingPlatformCdnProfile". |
FreeTrialEndTime Salt okunur. Bu özellik Media Services 2.15'e eklendi. |
Edm.DateTime | Yeni bir medya hizmetleri hesabı oluşturulduğunda, varsayılan standart akış uç noktası da hesabın altında otomatik olarak durdurulmuş durumda sağlanır. Bu uç nokta 15 günlük ücretsiz deneme süresini içerir ve uç nokta ilk kez başlatıldığında deneme süresi başlar. Ücretsiz deneme mevcut hesaplar için geçerli değildir ve bitiş tarihi durdurma/başlatma gibi durum geçişleriyle değişmez. Ücretsiz deneme, akış uç noktasını ilk kez başlattığınızda başlar ve 15 takvim günü sonra biter. Ücretsiz deneme yalnızca varsayılan akış uç noktası için geçerlidir ve ek akış uç noktaları için geçerli değildir. Uç nokta yeni oluşturulduğunda ve durdurulmuş durumda olduğunda, "FreeTrialEndTime" değeri "0001-01-01T00:00:00Z" olarak ayarlanır. Başlatıldığında, başlangıç tarihine 15 gün eklenir ve değer ücretsiz deneme bitiş tarihini temsil ederek başlar "FreeTrialEndTime":"2016-12-16T18:01:47.8524725Z". Ücretsiz deneme için uygun olmayan akış uç noktalarının değerleri, duruma bakılmaksızın her zaman "FreeTrialEndTime":"0001-01-01T00:00:00Z" olacaktır. Örnekler: "FreeTrialEndTime":"2016-12-16T18:01:47.8524725Z" "FreeTrialEndTime":"0001-01-01T00:00:00Z" |
StreamingEndpointVersion Bu özellik Media Services 2.15'e eklendi. |
Edm.String | StreamingEndpointVersion ve ScaleUnits birleşimi, akış uç noktası türünü denetler. 2.15 (10 Ocak 2017) güncelleştirmeden önce oluşturulan herhangi bir akış uç noktasında "StreamingEndpointVersion":"1.0" ve güncelleştirmeden sonra oluşturulan akış uç noktaları "StreamingEndpointVersion":"2.0" olacaktır. Sürüm 1.0 olan Akış Uç Noktaları otomatik olarak sürüm 2.0'a yükseltilmeyecek, ancak açıkça "StreamingEndpointVersion":"2.0" sürümüne yükseltilebilir. "ScaleUnits" ile akış uç noktaları:0 ve "StreamingEndpointVersion":"1.0", dinamik paketleme veya dinamik şifreleme gibi gelişmiş özelliklere sahip olmayan klasik akış uç noktaları olarak kabul edilir. "ScaleUnits" 0 ("StreamingEndpointVersion" > sürümü "1.0" veya "2.0" sürümüne ayarlanmış olsun) içeren akış uç noktaları premium birimlerdir. "ScaleUnits" ile standart akış uç noktaları:0 ve "StreamingEndpointVersion":"2.0", premium birimlerle (dinamik paketleme ve dinamik şifreleme içeren) aynı özellikleri içerir. Sürümü "StreamingEndpointVersion":"2.0" olarak ayarlayarak klasik akış uç noktasını standarda yükseltebilirsiniz. Bu tek yönlü bir işlemdir; sürüm 2.0'ı 1.0'a düşüremezsiniz. Bu işlemin geri alınamayacağına ve fiyatlandırmayı etkilediğinden emin olun. Bu yeni yapılandırmanın yayılması 30 dakika kadar sürebilir. Bu zaman çerçevesi boyunca uç nokta düşürülmüş modda çalışır ve dinamik paketleme ve dinamik şifreleme isteklerinde hatalarla karşılaşabilirsiniz. Örnekler: "StreamingEndpointVersion":"2.0" "StreamingEndpointVersion":"1.0" |
CustomHostNames İsteğe bağlı. |
Collection(Edm.String) | Akış uç noktasını özel bir ana bilgisayar adına yönlendirilen trafiği kabul edecek şekilde yapılandırmak için kullanılır. Bu, Global Traffic Manager (GTM) aracılığıyla daha kolay trafik yönetimi yapılandırmasına ve ayrıca akış uç noktası adı olarak markalı etki alanı adlarının kullanılmasına olanak tanır. Etki alanı adının sahipliği Azure Media Services tarafından onaylanmalıdır. Azure Media Services, kullanımdaki etki alanına bileşen olarak Azure Media Services hesap kimliğini içeren bir CName kaydın eklenmesini gerektirerek etki alanı adı sahipliğini doğrular. Örneğin, Akış Uç Noktası için özel bir ana bilgisayar adı olarak kullanılacak "sports.contoso.com" için, "<accountId.contoso.com>" kaydının Media Services doğrulama ana bilgisayar adlarından birine işaret edecek şekilde yapılandırılması gerekir. Doğrulama ana bilgisayar adı doğrulananlardan oluşur.<mediaservices-dns-zone>. Aşağıdaki tablo, farklı Azure bölgeleri için doğrulama kaydında kullanılacak beklenen DNS bölgelerini içerir.Kuzey Amerika, Avrupa, Singapur, Hong Kong, Japonya: - mediaservices.windows.net - verifydns.mediaservices.windows.net Çin: - mediaservices.chinacloudapi.cn - verifydns.mediaservices.chinacloudapi.cn Örneğin, "945a4c4e-28ea-45cd-8ccb-a519f6b700ad.contoso.com" öğesini "verifydns.mediaservices.windows.net" ile eşleyen bir CName kayıt, Azure Media Services Id 945a4c4e-28ea-45cd-8ccb-a519f6b700ad'nin contoso.com etki alanının sahibi olduğunu ve bu nedenle contoso.com altındaki herhangi bir adın bu hesap altındaki bir akış uç noktası için özel ana bilgisayar adı olarak kullanılmasını sağlar.Media Service Kimliği değerini bulmak için Azure portal gidin ve Media Service hesabınızı seçin. MEDIA SERVICE Kimliği PANO sayfasının sağ tarafında görünür. Uyarı: Kaydın düzgün bir şekilde doğrulanmadan CName özel bir ana bilgisayar adı ayarlama girişimi varsa, DNS yanıtı başarısız olur ve bir süre önbelleğe alınır. Uygun bir kayıt gerçekleştikten sonra, önbelleğe alınan yanıtın yeniden doğrulanması biraz zaman alabilir. Özel etki alanının DNS sağlayıcısına bağlı olarak kaydın yeniden doğrulanması birkaç dakika ile bir saat arasında sürebilir.ile eşlenmesine CName verifydns.<mediaservices-dns-zone> <accountId>.<parent domain> ek olarak, özel ana bilgisayar adını (örneğin, sports.contoso.com ) Media Services StreamingEndpont ana bilgisayar adınızla (örneğin, amstest.streaming.mediaservices.windows.net ) eşleyen başka bir CName ana bilgisayar oluşturmanız gerekir.Not: Aynı veri merkezinde bulunan akış uç noktaları aynı özel ana bilgisayar adını paylaşamaz. Bu özellik Standart ve premium akış uç noktaları için geçerlidir ve "CdnEnabled":false olduğunda ayarlanabilir AMS'nin şu anda özel etki alanlarıyla SSL'yi desteklemediğini unutmayın. |
AccessControl |
StreamingEndpointAccessControl ComplexType | Bu akış uç noktası için aşağıdaki güvenlik ayarlarını yapılandırmak için kullanılır: Akamai imza üst bilgisi kimlik doğrulama anahtarları ve bu uç noktaya bağlanmasına izin verilen IP adresleri. Not: Bu özellik Standart ve premium akış uç noktaları için geçerlidir ve "CdnEnabled":false olduğunda ayarlanabilir |
CacheControl |
StreamingEndpointCacheControl | Bu akış uç noktası aracılığıyla sunulan varlıklar için varlık önbelleği ömrünü yapılandırmak için kullanılır. |
CrossSiteAccessPolicies |
CrossSiteAccessPolicies | Çeşitli istemciler için siteler arası erişim ilkelerini belirtmek için kullanılır. Daha fazla bilgi için bkz . Etki alanları arası ilke dosyası belirtimi ve Bir Hizmeti Etki Alanı Sınırları Arasında Kullanılabilir Hale Getirme. |
StreamingEndpointCacheControl
Ad | Tür | Description |
---|---|---|
MaxAge İsteğe bağlı. |
Edm.Int64 | Medya parçalarında ve isteğe bağlı bildirimlerde akış uç noktası tarafından ayarlanan varsayılan maksimum yaş HTTP önbellek denetimi üst bilgisini geçersiz kılar. Değer saniye olarak ayarlanır. |
StreamingEndpointAccessControl ComplexType
Ad | Tür | Description |
---|---|---|
Akamai |
AkamaiAccessControl | Akamai erişim denetimi. |
IP |
IPAccessControl | IP erişim denetimi. |
AkamaiAccessControl
Ad | Tür | Description |
---|---|---|
AkamaiSignatureHeaderAuthenticationKeyList | AkamaiSignatureHeaderAuthenticationKey ComplexType | Akamai İmza Üst Bilgisi Kimlik Doğrulama anahtarları hakkında bilgi içerir. |
IPAccessControl
Ad | Tür | Description |
---|---|---|
İzin Ver | IPRange ComplexType | Akış uç noktasına bağlanabilen IP adreslerini tanımlar. Not: Bu değeri null olarak ayarlamak, tüm IP kaynak adreslerinin bağlanmasına izin verir. Bunu boş bir dizeye ("") ayarlamak, kimsenin bağlanmasına izin vermemektedir. |
AkamaiSignatureHeaderAuthenticationKey ComplexType
Bu tür, Akamai G20 kimlik doğrulama ayarlarını açıklar. Akamai Kimlik Doğrulaması anahtarlı karma ileti kimlik doğrulama şemasıdır. Kimlik doğrulama anahtarı, Akamai CDN ve Azure Media Origin Akış Hizmeti tarafından paylaşılan bir gizli dizidir. Azure Media Services yalnızca HMAC-MD5 kullanan 3. sürümü destekler.
Ad | Tür | Description |
---|---|---|
Identifier |
Edm.String | Kimlik doğrulama anahtarının tanımlayıcısı. Bu, Akamai tarafından sağlanan nonce' dir. |
Expiration |
Edm.DateTime | Akamai kimlik doğrulamasının süresinin ne zaman dolduğunu belirten DateTime değeri |
Base64Key |
Edm.String | CDN tarafından kullanılacak Base64 ile kodlanmış kimlik doğrulama anahtarı. Akamai tarafından sağlanan kimlik doğrulama anahtarı ASCII ile kodlanmış bir dizedir ve baytlara dönüştürülmesi ve ardından base64 kodlanmış olması gerekir. |
Aşağıdaki C# örneği, Akamai kimlik doğrulama anahtarının base64'e nasıl dönüştürüldüğünü gösterir:
string akamaiKey = "01234567890123456789012345678901";
string base64Key = Convert.ToBase64String(System.Text.Encoding.ASCII.GetBytes(akamaiKey);
IPRange ComplexType
Ad | Tür | Description |
---|---|---|
Name |
Edm.String | Bu IP Aralığı için kolay bir ad. |
Address |
Edm.String | Alt ağ gösteriminin temel IP adresi (örneğin: 192.168.0.1). |
SubnetPrefixLength |
Edm.Int32 | Alt ağ maskesi için önemli bit sayısı (örneğin, aşağıdaki IP adresinde 192.168.0.1/24), 24 önemli bit sayısını temsil eder. |
StreamingEndpoint Oluşturma
Yeni bir StreamingEndpoint hizmeti oluşturun.
İstek
Yöntem | İstek URI'si | HTTP Sürümü |
---|---|---|
POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoint> | HTTP/1.1 |
Örnek İstek
Fiddler'ın Oluşturucu sekmesinde aşağıdaki örneği deneyebilirsiniz.
En son x-ms-version:
sürümü edinmek için bkz. Media Services REST.
İstek üst bilgileri:
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>
İstek gövdesi:
{
"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>"
}
}
Başarılı olursa, yanıt gövdesinde oluşturulan varlığın gösterimiyle birlikte 202 Kabul Edildi durum kodu döndürülür.
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>"
}
}
202 Kabul Edildi durum kodu zaman uyumsuz bir işlemi gösterir. Bu durumda operation-id üst bilgi değeri, StreamingEndpoint başlatma veya durdurma gibi uzun süre çalışan işlemlerin durumunu yoklama ve izleme amacıyla da kullanılır. Durumu almak için operation-id üst bilgi değerini İşlem Varlığı'na geçirin. Daha fazla bilgi için bkz. el ile yoklama Long-Running İşlemler.
StreamingEndpoint'i başlatma
Belirtilen StreamingEndpoint'i başlatın. StreamingEndpoint yalnızca Durduruldu durumundayken başlatılabilir. StreamingEdpoint'i başlattıktan bir süre sonra durum olarak Running
değişir.
Akışı zaman içinde daha sonraki bir noktada durdurmak için Durdur işlemini çağırın.
Çalışıyor durumundayken kullanılabilir eylemler.
Durum | Akış Birimleri | Description | Kullanılabilir Eylemler |
---|---|---|---|
Çalışma | 0 | Standart Akış Uç Noktasından Akış. | Durdur, Ölçeklendir |
Çalışma | >0 | Premium Akış Uç Noktasından akış. | Durdur, Ölçeklendir |
İstek
Yöntem | İstek URI'si | HTTP Sürümü |
---|---|---|
POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Start | HTTP/1.1 |
Örnek İstek
Fiddler'ın Oluşturucu sekmesinde aşağıdaki örneği deneyebilirsiniz.
İstek üst bilgileri:
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>
Başarılı olursa , 202 Kabul edildi durum kodu döndürülür. 202 Kabul Edildi durum kodu zaman uyumsuz bir işlemi gösterir. Bu durumda operation-id üst bilgi değeri, StreamingEndpoint başlatma veya durdurma gibi uzun süre çalışan işlemlerin durumunu yoklama ve izleme amacıyla da kullanılır. Durumu almak için operation-id üst bilgi değerini İşlem Varlığı'na geçirin. Daha fazla bilgi için bkz. el ile yoklama Long-Running İşlemler.
StreamingEndpoints'i durdurma
Belirtilen StreamingEndpoint'i durdurun. StreamingEndpoint yalnızca Çalışıyor durumunda olduğunda durdurulabilir.
Durduruldu durumundayken kullanılabilir eylemler.
Durum | Akış Birimleri | Description | Kullanılabilir Eylemler |
---|---|---|---|
Durduruldu | 0 | Akış değil. | Başlat, Ölçeklendir |
Durduruldu | >0 | Akış değil. | Başlat, Ölçeklendir |
İstek
Yöntem | İstek URI'si | HTTP Sürümü |
---|---|---|
POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Stop | HTTP/1.1 |
Örnek İstek
Fiddler'ın Oluşturucu sekmesinde aşağıdaki örneği deneyebilirsiniz.
En son x-ms-version:
sürümü edinmek için bkz. Media Services REST.
İstek üst bilgileri:
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>
Başarılı olursa , 202 Kabul edildi durum kodu döndürülür. 202 Kabul Edildi durum kodu zaman uyumsuz bir işlemi gösterir. Bu durumda operation-id üst bilgi değeri, StreamingEndpoint başlatma veya durdurma gibi uzun süre çalışan işlemlerin durumunu yoklama ve izleme amacıyla da kullanılır. Durumu almak için operation-id üst bilgi değerini İşlem Varlığı'na geçirin. Daha fazla bilgi için bkz. el ile yoklama Long-Running İşlemler.
StreamingEndpoints'i ölçeklendirme
Çalışma durumundayken akış birimi kapasitesini dinamik olarak güncelleştirir ve "ScaleUnits" :0 konumundan güncelleştirilirse türü Standart Akış Uç Noktası'ndan Premium Akış Uç Noktası'na değiştirir.
İstek
Yöntem | İstek URI'si | HTTP Sürümü |
---|---|---|
POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Scale | HTTP/1.1 |
Örnek İstek
Fiddler'ın Oluşturucu sekmesinde aşağıdaki örneği deneyebilirsiniz.
En son x-ms-version:
sürümü edinmek için bkz. Media Services REST.
İstek üst bilgileri:
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>
İstek gövdesi:
{"scaleUnits" : 2}
Başarılı olursa , 202 Kabul edildi durum kodu döndürülür. 202 Kabul Edildi durum kodu zaman uyumsuz bir işlemi gösterir. Bu durumda operation-id üst bilgi değeri, StreamingEndpoint başlatma veya durdurma gibi uzun süre çalışan işlemlerin durumunu yoklama ve izleme amacıyla da kullanılır. Durumu almak için operation-id üst bilgi değerini İşlem Varlığı'na geçirin. Daha fazla bilgi için bkz. el ile yoklama Long-Running İşlemler.
StreamingEndpoints Listesini Oluşturma
StreamingEndpoints, GET HTTP isteği kullanılarak alınır.
İstek
Yöntem | İstek URI'si | HTTP Sürümü |
---|---|---|
GET | Tüm StreamingEndpoint'leri alın: <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints> Belirtilen StreamingEndpoint'i alın. <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') |
HTTP/1.1 |
Örnek İstek
Fiddler'ın Oluşturucu sekmesinde aşağıdaki örneği deneyebilirsiniz.
En son x-ms-version:
sürümü edinmek için bkz. Media Services REST.
İstek üst bilgileri:
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>
Başarılı olursa, bu işlem 200 Tamam durum kodunu ve Media Services hesabınızda oluşturulan tüm StreamingEndpoint'lerin listesini döndürür.
StreamingEndpoints'i güncelleştirme
StreamingEndpoint'i yeni özellik değerleriyle güncelleştirin. StreamingEndpoint çalışıyorsa ve ayarlar değiştirilirse bu zaman uyumsuz bir işlemdir.
İstek
Yöntem | İstek URI'si | HTTP Sürümü |
---|---|---|
PATCH/PUT/MERGE Bu işlemler hakkında daha fazla bilgi için bkz. PATCH/PUT/MERGE. |
<https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') | HTTP/1.1 |
Örnek İstek
Fiddler'ın Oluşturucu sekmesinde aşağıdaki örneği deneyebilirsiniz. Örnek, MaxAge değerini güncelleştirir.
En son x-ms-version:
sürümü edinmek için bkz. Media Services REST.
İstek üst bilgileri:
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>
İstek gövdesi:
{"CacheControl":{"MaxAge":"2000"}}
Güncelleştirme zaman uyumlu olarak tamamlanırsa , 204 İçerik Yok durum kodunu döndürür; aksi takdirde 202 Kabul Edildi durum kodunu döndürür. 202 Kabul Edildi durum kodu zaman uyumsuz bir işlemi gösterir. Bu durumda operation-id üst bilgi değeri, StreamingEndpoint başlatma veya durdurma gibi uzun süre çalışan işlemlerin durumunu yoklama ve izleme amacıyla da kullanılır. Durumu almak için operation-id üst bilgi değerini İşlem Varlığı'na geçirin. Daha fazla bilgi için bkz. el ile yoklama Long-Running İşlemler.
StreamingEndpoints'i silme
StreamingEndpoint'i silin. StreamingEndpoint yalnızca Durduruldu durumunda olduğunda silinebilir.
İstek
Yöntem | İstek URI'si | HTTP Sürümü |
---|---|---|
DELETE | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') | HTTP/1.1 |
Örnek İstek
Fiddler'ın Oluşturucu sekmesinde aşağıdaki örneği deneyebilirsiniz.
En son x-ms-version:
sürümü edinmek için bkz. Media Services REST.
İstek üst bilgileri:
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>
Başarılı olursa , 202 Kabul edildi durum kodu döndürülür. 202 Kabul Edildi durum kodu zaman uyumsuz bir işlemi gösterir. Bu durumda operation-id üst bilgi değeri, StreamingEndpoint başlatma veya durdurma gibi uzun süre çalışan işlemlerin durumunu yoklama ve izleme amacıyla da kullanılır. Durumu almak için operation-id üst bilgi değerini İşlem Varlığı'na geçirin. Daha fazla bilgi için bkz. el ile yoklama Long-Running İşlemler.