Program

Program, canlı akıştaki segmentlerin yayımlanması ve depolanmasını denetlemenizi sağlar. Programlar eşzamanlı olarak çalıştırılabilir. Bu, olayın farklı bölümlerini gerektiği gibi yayımlamanıza ve arşivlenize olanak tanır.

Özelliğini ayarlayarak ArchiveWindowLength (25 saate kadar) program için kaydedilen içeriği tutmak istediğiniz saat sayısını belirtebilirsiniz. İstemciler, belirtilen saat sayısı için arşivlenmiş içerikte arama yapabilir. Program belirtilen ArchiveWindowLength değerinden daha uzun çalışırsa, eski içerik kaldırılır. Daha fazla bilgi için aşağıdaki belgelere ArchiveWindowLength bakın.

Bu konu, varlığa genel bir bakış Program sağlar ve ayrıca Media Services REST API'siyle çeşitli işlemlerin nasıl yürütüleceklerini gösterir.

• Program Oluştur

• Programları Başlat

• Programları Durdur

• Programları Listele

• Programları Güncelleştir

• Programları Sil

Ö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'e Bağlanma.

Program Varlığı Özellikleri

Program varlığı 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 Program Kimliği. Biçim: nb:pgid:UUID:<GUID>.
Name	Edm.String	Programın adı. Maksimum uzunluk 256 karakterdir ve alfasayısal karakterlerle başlayıp sona erdiği sürece '-' ve ' dahil olmak üzere tüm İngilizce karakter ve sayılardan oluşabilir.
AssetId	Edm.String	Program işleme için kullanılacak Varlık Kimliği. Özellik yalnızca Program Durduruldu durumunda olduğunda güncelleştirilebilir. Bir program tarafından kullanılıyorsa varlık silinemez. Bir varlığı kullanan programı sildikten sonra silebilirsiniz.
Created Salt okunur. Media Services tarafından ayarlanır.	Edm.DateTime	Oluşturma saatini gösteren utc tarih/saat değeri.
Description	Edm.String	Kullanıcı tarafından sağlanan açıklama. Uzunluk üst sınırı 256 karakterdir.
ArchiveWindowLength Gereklidir.	Edm.Time	Program için kaydedilen içeriği korumak istediğiniz saat sayısı. Bu değer en az 5 dakika, en çok 25 saat olarak ayarlanabilir. Bu aynı zamanda istemcilerin geçerli canlı konumdan zamanda arayabileceği maksimum süreyi de belirler. Olaylar belirtilen süre miktarından uzun sürebilir, ancak pencere uzunluğunun gerisine düşen içerik sürekli olarak atılır. Bu özelliğin bu değeri, istemci bildiriminin ne kadar uzayabileceğini de belirler. Arşivlenmiş içeriği silmek için programı durdurun ve silin ve ardından programla ilişkili varlığı silin.
LastModified Salt okunur. Media Services tarafından ayarlanır.	Edm.DateTime	Son değişikliğin tarihi ve saati.
ManifestName	Edm.String	Uzantı olmadan bildirim dosyası adı. Bu özellik yalnızca Program Durduruldu durumunda olduğunda güncelleştirilebilir.
State Salt okunur. Media Services tarafından ayarlanır.	Edm.String	Geçerli durumu alır. Olası değerler şunlardır: -Durdu. Program oluşturulduktan sonra Durduruldu durumundadır. Bu durumda Program özellikleri güncelleştirilebilir, ancak akışa izin verilmez. Program başlatılabilir, güncelleştirilebilir veya bu durumdan silinebilir. -Başlangıç. Program başlatılıyor. Bu durum sırasında hiçbir güncelleştirmeye veya akışa izin verilmez. -Çalışan. Program, canlı akışları işleyip arşivleme yeteneğine sahiptir. -Durdurma. Program durduruluyor. Bu durum sırasında hiçbir güncelleştirmeye veya akışa izin verilmez.
ChannelId Salt okunur. Media Services tarafından ayarlanır.	Edm.String	Programın üst Kanalının kimliği.
Channel	Kanal	Programın ChannelId tarafından belirtilen üst kanalı.

Program Oluştur

Yeni bir Program oluşturun.

Yöntem	İstek URI'si	HTTP Sürümü
POST	<https:// accountname.restv2>.<location.media.azure.net/api/Programs>	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/Programs HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>  
  

İstek gövdesi:

{"Id":null,"Name":"testprogram001","Description":"","Created":"0001-01-01T00:00:00","LastModified":"0001-01-01T00:00:00","ChannelId":"nb:chid:UUID:83bb19de-7abf-4907-9578-abe90adfbabe","AssetId":"nb:cid:UUID:bc495364-5357-42a1-9a9d-be54689cfae2","ArchiveWindowLength":"PT1H","State":null,"ManifestName":null}  

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.

{"odata.metadata":"https://testrest.cloudapp.net/api/$metadata#Programs/@Element","Id":"nb:pgid:UUID:b870dd57-4b04-41b6-849d-b2470e50e7e6","Name":"testprogram001","Description":"","Created":"2014-08-11T18:12:27.8381256Z","LastModified":"2014-08-11T18:12:27.8381256Z","ChannelId":"nb:chid:UUID:83bb19de-7abf-4907-9578-abe90adfbabe","AssetId":"nb:cid:UUID:bc495364-5357-42a1-9a9d-be54689cfae2","ArchiveWindowLength":"PT1H","State":"Stopped","ManifestName":"f91329ec-26f5-4026-87f5-f5437d4da9e6"}  
  

Not

Bu işlem zaman uyumlu olarak tamamlanır, bu nedenle izlenecek bir işlem kimliği yoktur.

Programları Başlat

Bir Program başlatın. Program yalnızca Durduruldu durumundayken ve kanal Çalışıyor durumunda olduğunda başlatılabilir.

Yöntem	İstek URI'si	HTTP Sürümü
Başlangıç	<https:// accountname.restv2>.<location.media.azure.net/api/Programs>('ProgramId')/Start	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/Programs('nb:pgid:UUID:0f9ceb51-50fe-4769-aaed-f8c19d76b9bc')/Start HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
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, bir Programı başlatma veya durdurma gibi uzun süre çalışan işlemlerin durumunu yoklama ve izleme amacıyla da sağlanı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.

Programları Durdur

Programı durdurun. Bir Program yalnızca Çalışıyor durumunda olduğunda durdurulabilir. Bu zaman uyumsuz bir işlemdir.

Yöntem	İstek URI'si	HTTP Sürümü
Durdur	<https:// accountname.restv2>.<location.media.azure.net/api/Programs>('ProgramId')/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/Programs('nb:pgid:UUID:0f9ceb51-50fe-4769-aaed-f8c19d76b9bc')/Stop HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
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, bir Programı başlatma veya durdurma gibi uzun süre çalışan işlemlerin durumunu yoklama ve izleme amacıyla da sağlanı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.

Programları Listele

Programlar GET HTTP isteği kullanılarak alınır.

Yöntem	İstek URI'si	HTTP Sürümü
GET	Media Services hesabındaki tüm Programları alın: <https:// accountname.restv2>.<location.media.azure.net/api/Programs> Media Services hesabında belirtilen bir Programı alın: <https:// accountname.restv2>.<location.media.azure.net/api/Programs>('ProgramId') Belirtilen Kanalla ilişkilendirilmiş tüm Programları alın: <https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')/Programlar	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/Programs HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
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 Programların listesini döndürür.

Programları Güncelleştir

Programı güncelleştirme. Program Durduruldu durumunda olmalıdır.

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/Programs>('ProgramId')	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:

PATCH https://testrest.cloudapp.net/api/Programs('nb:pgid:UUID:0f9ceb51-50fe-4769-aaed-f8c19d76b9bc') HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>  
  

İstek gövdesi:

{"ArchiveWindowLength":"PT3H"}  

Güncelleştirme zaman uyumlu olarak tamamlanırsa , 204 İçerik Yok durum kodu döndürür; aksi takdirde bir 202 Kabul edildi durum kodu döndürür. 202 Kabul edildi durum kodu zaman uyumsuz bir işlemi gösterir. Bu durumda operation-id üst bilgi değeri, bir Programı başlatma veya durdurma gibi uzun süre çalışan işlemlerin durumunu yoklama ve izleme amacıyla da sağlanı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.

Programları Sil

Program silme. Program yalnızca Durduruldu durumunda olduğunda silinebilir.

Yöntem	İstek URI'si	HTTP Sürümü
DELETE	<https:// accountname.restv2>.<location.media.azure.net/api/Programs>('ProgramId')	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/Programs('nb:pgid:UUID:0f9ceb51-50fe-4769-aaed-f8c19d76b9bc') HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>  
  

Başarılı olursa , 204 İçerik Yok durum kodu döndürülür.

Not

Bu işlem zaman uyumlu olarak tamamlanır, bu nedenle izlenecek bir işlem kimliği yoktur.

Ayrıca Bkz.

Kanal