Varlık
Varlık Asset dijital dosyaları (video, ses, resimler, küçük resim koleksiyonları, metin parçaları ve kapalı başlık dosyaları dahil) ve bu dosyalar hakkındaki meta verileri içerir. Dijital dosyalar bir varlığa yüklendikten sonra Media Services kodlama ve akış iş akışlarında kullanılabilir.
Bir varlığı kodladığınızda, kodlama işi tamamlandıktan sonra bir çıkış varlığı oluşturulur. Yukarıda bahsedilen dosyalar arasında çıkış varlığı, giriş varlığını ve çıkış varlığını açıklayan XML meta veri dosyalarını içerir. Daha fazla bilgi için Giriş Meta Verileri ve Çıktı Meta Verileri makalelerine bakın.
Media Services'daki bir Varlık için aşağıdaki özellikler geçerlidir:
Varlık, tek bir görsel-işitsel sunuyu temsil eden mantıksal bir birimdir.
Varlık, bire çok medya dosyasından oluşan bir koleksiyon içerir.
Bir varlığın dosyaları tek bir blob depolama kapsayıcısında bulunur.
Varlık örnekleri şunlardır: tam film, TV programı, belirli bir düzenleme; film, TV programı, animasyon, kamera ISO dosyası veya etkinlikten bir klip; bir film fragmanı veya tanıtım videosu; bir reklam; bir ses dosyası, radyo programı, pod yayını veya ses dosyası.
Media Services'daki bir Varlık için aşağıdaki özellikler UYGULANMAZ:
Yalnızca bir depolama kapsayıcısı
Aynı sununun birden çok sürümünü düzenlemek ve depolamak için bir klasör
Azure Media Encoder'a birden çok görsel-işitsel sununun toplu işlemesini göndermek için bir klasör
Örneğin, bir filmi, fragmanını, reklamını ve aynı filmin uluslararası düzenleme sürümünü tek bir Varlıkta depolamamalısınız.
Bu konu, varlığa genel bir bakış Asset sağlar ve ayrıca Media Services REST API'siyle çeşitli işlemlerin nasıl yürütüleceklerini gösterir.
Ö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.
Varlık Varlığı Özellikleri
| Özellik | Tür | Description |
|---|---|---|
IdSalt okunur. Media Services tarafından oluşturma zamanında ayarlanır. |
Dize | Benzersiz tanımlayıcı. |
StateSalt okunur. Media Services tarafından ayarlanır. |
Edm.Int32 | Varlığın durumunu açıklayan bir numaralandırma değeri. Değer değerleri şunlardır: - Başlatıldı = 0 - Yayımlandı = 1 Uyarı: Eylem Publish kullanım dışı bırakıldı. Varlığın Published durumunda olup olmadığını denetleen kodu kaldırın.- Silinmiş = 2 Varlık silinene kadar her zaman Başlatıldı durumundadır. |
CreatedSalt okunur. Media Services tarafından oluşturma zamanında ayarlanır. |
Edm.DateTime | Bu değer Media Services tarafından oluşturma zamanında ayarlanır. |
LastModifiedSalt okunur. Media Services tarafından ayarlanır. |
Edm.DateTime | Özellik değişiklikleri yapıldıktan sonra bu değer Media Services tarafından güncelleştirilir. |
AlternateIdİsteğe bağlı. |
Edm.String | Başka bir içerik yönetim sistemindeki bir Kimlik'e karşılık gelen alternatif kimlik değeri. Maksimum uzunluk 4000'dir. |
Nameİsteğe bağlı. |
Edm.String | Varlığınızın kolay adı. Maksimum uzunluk 512'dir. |
OptionsGereklidir. Varlık oluşturulduktan sonra güncelleştirilemez. |
Edm.Int32 | Bir Varlığın oluşturulabileceği şifreleme seçeneklerini açıklayan bir numaralandırma değeri. Geçerli bir değer, aşağıdaki listeden bir değerdir, bu listedeki değerlerin birleşimi değildir: - Hiçbiri = 0: Varlık oluşturma seçeneği belirtmez. - StorageEncrypted = 1: Varlık oluşturulurken karşıya yükleme ve depolama için bir varlığın dosyalarının şifrelenmesi gerektiğini belirtir. - CommonEncryptionProtected = 2: Bir varlığın dosyalarının ortak bir şifreleme yöntemi (PlayReady gibi) kullanılarak korunduğunu belirtir. - EnvelopeEncryptionProtected = 4 |
UriSalt okunur. Media Services tarafından ayarlanır. |
Edm.String | Belirtilen Varlığın blob depolama kapsayıcısının URI'sini. |
LocatorsSalt okunur. Media Services tarafından ayarlanır. |
Bulucu varlık kümesi | Döndürülen varlık kümesi, belirtilen Varlığa bağlı olan tüm Bulucu varlıklarını içerir. |
ContentKeysİsteğe bağlı. |
ContentKey varlık kümesi | Döndürülen varlık kümesi, belirtilen Varlığa bağlı tüm ContentKey varlıklarını içerir. |
FilesSalt okunur. Media Services tarafından ayarlanır. |
Dosya varlık kümesi | Döndürülen varlık kümesi, belirtilen Varlığa bağlı tüm Dosya varlıklarını içerir. |
ParentAssetsİsteğe bağlı. |
Üst Varlıklar varlık kümesi | Döndürülen varlık kümesi, belirtilen Varlığa bağlı tüm üst Varlık varlıklarını içerir. |
StorageAccountNameİsteğe bağlı. Varlık oluşturulduktan sonra güncelleştirilemez. |
Edm.String | Varlığın blob kapsayıcısını içeren depolama hesabının adı. Oluşturma zamanında belirtilmezse, Media Services varsayılan depolama hesabı adını ayarlar. |
StorageAccountSalt okunur. Media Services tarafından ayarlanır. |
StorageAccount varlık kümesi | Döndürülen varlık kümesi, belirtilen Varlığa bağlı tüm StorageAccount varlıklarını içerir. |
DeliveryPolicies |
AssetDeliveryPolicy varlık kümesi | Döndürülen varlık kümesi, varlıkla ilişkili teslim ilkelerini içerir. |
FormatOption |
Edm.Int32 | Bir varlığın oluşturulabileceği farklı biçim seçeneklerini belirtir. İzin verilen değerler şunlardır: 0 (varsayılan) - varlık biçimi seçeneği belirtmez; 1 - Varlığın biçiminin AdaptiveStreaming olacağını belirtir. |
Asset oluşturma
Varlıklar POST HTTP isteği kullanılarak ve özellik değerleri belirtilerek oluşturulabilir.
| Yöntem | İstek URI'si | HTTP Sürümü |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/Assets> | HTTP/1.1 |
Örnek İstek
En son x-ms-version:sürümü edinmek için bkz. Media Services REST.
POST https://<accountname>.restv2.<location>.media.azure.net/api/Assets HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.19
Authorization: Bearer <token value>
Host: media.windows.net
Content-Length: 27
Expect: 100-continue
{ "Name" : "NewJSONAsset" }
Varlık Listeleme
Varlıklar GET HTTP isteği kullanılarak alınabilir.
| Yöntem | İstek URI'si | HTTP Sürümü |
|---|---|---|
| GET | <https:// accountname.restv2>.<location.media.azure.net/api/Assets> | HTTP/1.1 |
| Yöntem | İstek URI'si | HTTP Sürümü |
|---|---|---|
| GET | <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid') | HTTP/1.1 |
Örnek İstek
En son x-ms-version:sürümü edinmek için bkz. Media Services REST.
GET https://<accountname>.restv2.<location>.media.azure.net/api/Assets('nb:cid:UUID:fccb8cd9-7afa-4365-a36e-d5d68409bb64') HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.19
Authorization: Bearer <token value>
Host: media.windows.net
Content-Length: 0
Varlığı Güncelleştirme
Varlıklar BIR MERGE HTTP isteği ve değiştirmek istediğiniz belirli özellikler kullanılarak güncelleştirilebilir.
| Yöntem | İstek URI'si | HTTP Sürümü |
|---|---|---|
| BİRLEŞTİRME | <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid') | HTTP/1.1 |
Örnek İstek
En son x-ms-version:sürümü edinmek için bkz. Media Services REST.
MERGE https://<accountname>.restv2.<location>.media.azure.net/api/Assets('nb:cid:UUID:80782407-3f87-4e60-a43e-5e4454232f60') HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.19
Authorization: Bearer <token value>
Host: media.windows.net
Content-Length: 21
Expect: 100-continue
{"Name" : "NewName" }
Varlığı silme
Varlıklar, Varlık Kimliği değerine başvurarak silinebilir. Bir varlık silindiğinde, tüm bulucuları Microsoft Azure Media Services tarafından silinir. Varlığın kaynak bulucuları varsa, bu bulucular da iptal edilir ve silinir. ContentKeys'e yönelik tüm bağlantılar silinir ve diğer varlıklara bağlı olmayan tüm ContentKey'ler silinir.
| Yöntem | İstek URI'si | HTTP Sürümü |
|---|---|---|
| DELETE | <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid') | HTTP/1.1 |
Örnek İstek
En son x-ms-version:sürümü edinmek için bkz. Media Services REST.
DELETE https://<accountname>.restv2.<location>.media.azure.net/api/Assets('nb:cid:UUID:fccb8cd9-7afa-4365-a36e-d5d68409bb64') HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.19
Authorization: Bearer <token value>
Host: media.windows.net
Content-Length: 0
Varlık Yayımlama
Not
Eylem Publish kullanım dışı bırakıldı. En son Media Services sürümünden Publish itibaren kullanılmamalıdır.
Kodunuz kullanıyorsa Publish, aşağıdaki önemli noktalara dikkat edin:
- Eylem,
Publishvarlıkla ilişkili bulucuları silmez. çağrısıPublishyaptıktan sonra koddaki bulucuları açıkça silmeniz gerekir. - Eylem varlık
Publishdurumunu olarakPublishedayarlamaz. Bir varlığınPublisheddurumunda olup olmadığını denetleen kodu kaldırın. Şu anda bir varlık yalnızca veyaDeleteddurumuna sahipInitializedolabilir.
İçerik Anahtarlarını Varlıklara Bağlama
Http POST isteğiyle varlık kimliğine başvurarak bir ContentKey'i bir varlığa bağlayabilirsiniz. ContentKey'in Uri'sinin isteğin gövdesine eklenmesi gerekir. Yalnızca varlığın CreationOptions içinde belirtilen türle eşleşen bir ContentKey türünü bağlayabilirsiniz. Örneğin, Varlığın StorageEncrypted(1) olarak ayarlanmış seçenekleri varsa ContentKey, StorageEncryption(1) türünde olmalıdır.
| Yöntem | İstek URI'si | HTTP Sürümü |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('Asset Id')/$links/ContentKeys | HTTP/1.1 |
Örnek İstek
En son x-ms-version:sürümü edinmek için bkz. Media Services REST.
POST https://<accountname>.restv2.<location>.media.azure.net/api/Assets('nb:cid:UUID:3ac4c50a-09c1-4ea3-b39c-c336d97f5a13')/$links/ContentKeys HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.19
Authorization: Bearer <token value>
Host: media.windows.net
Content-Length: 121
Expect: 100-continue
{ "uri": "https://<accountname>.restv2.<location>.media.azure.net/api/ContentKeys('nb%3Akid%3AUUID%3A5db89211-c9d9-404b-a6bc-3e6b91c7a214')"}
ContentKey Bağlantılarını Kaldırma
Bir HTTP DELETE isteğinde varlık kimliğine ve ContentKey Kimliğine başvurarak bir varlıktan ContentKey bağlantılarını kaldırabilirsiniz. ContentKey diğer varlıklara bağlı değilse silinir.
| Yöntem | İstek URI'si | HTTP Sürümü |
|---|---|---|
| DELETE | <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('Asset Id')/$links/ContentKeys('ContentKey Id') | HTTP/1.1 |
Örnek İstek
En son x-ms-version:sürümü edinmek için bkz. Media Services REST.
DELETE https://<accountname>.restv2.<location>.media.azure.net/api/Assets('nb:cid:UUID:3ac4c50a-09c1-4ea3-b39c-c336d97f5a13')/$links/ContentKeys('nb:kid:UUID:5db89211-c9d9-404b-a6bc-3e6b91c7a214') HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.19
Authorization: Bearer <token value>
Host: media.windows.net
Content-Length: 0
Ayrıca Bkz.
AccessPolicy
ContentKey
AssetFile
İş
JobTemplate
Konumlandırıcı
MediaProcessor
Görev
Görev Şablonu
Media Services REST API ile Varlıkları Alma
Kotalar ve Sınırlamalar