Konumlandırıcı

  • Makale

Locator bir Varlığın içerdiği dosyalara erişmek için bir giriş noktası sağlar. AccessPolicy, bir istemcinin belirli bir Varlığa erişimi olan izinleri ve süreyi tanımlamak için kullanılır. Bulucuların AccessPolicy ile çoka bir ilişkisi olabilir; bu şekilde, farklı Bulucular farklı istemcilere farklı başlangıç zamanları ve bağlantı türleri sağlarken tümü aynı izin ve süre ayarlarını kullanır; Ancak, Azure depolama hizmetleri tarafından ayarlanan bir paylaşılan erişim ilkesi kısıtlaması nedeniyle, belirli bir Varlıkla aynı anda ilişkili beşten fazla benzersiz Bulucunuz olamaz. Daha fazla bilgi için bkz . Paylaşılan Erişim İmzası (REST API) kullanma.

Genellikle, çeşitli dosya biçimlerine erişmek için bir Locator Uri'yi dönüştürmeniz gerekir. Örneğin, SAS bulucunun Path özelliği kapsayıcıya erişim verir. Dosyalara erişmek için dosya adını konak ve SAS imzası arasına eklemeniz gerekir. OnDemandOrigin bulucuları ile çalışırken, protokole Path özgü bölüm eklenene kadar özelliği yararlı olmaz.

Aşağıdaki kurallar, bulucunun oluşturulup güncelleştirilebileceği zamanları yönetir:

  1. Okuma izinlerini ve Kaynak Bulucuları tanımlayan Accesspolicies ile kullanılan Erişim İmzası (SAS) URL Bulucuları, dosyalar bir Varlığa yüklenene kadar oluşturulamaz... Dosyaları indirmek veya karşıya yüklemek için kullanılan SAS URL Bulucuları, dosyalar karşıya yüklenmeden önce yalnızca yazma izinlerini belirten AccessPolicies ile kullanıldığında oluşturulabilir.

  2. Sas URL Bulucu oluşturulduktan sonra güncelleştiremezsiniz; ancak kaynak bulucular gibi diğer Bulucu türleri yeni StartTime değerleriyle güncelleştirilebilir.

  3. SAS bulucularının URL'leri, ilişkili depolama hesabının depolama anahtarları her güncelleştirildiğinde değişir. Daha fazla bilgi için bkz . Nasıl yapılır: Depolama Erişim Anahtarlarını Sıraladıktan Sonra Media Services'ı Güncelleştirme

  4. Bir Bulucu oluşturulduktan sonra kullanılabilir olduğunda 30-40 saniyelik bir gecikme olabilir. Bu sorun hem SAS URL'si hem de OnDemandOrigin bulucuları için geçerlidir.

Not

Bulucular, kullanıcı başına erişim denetimini yönetmek için tasarlanmamıştır. Ayrı kullanıcılara farklı erişim hakları vermek için Digital Rights Management (DRM) çözümlerini kullanın.

Bu makalede varlığa genel bir bakış Locator ve Media Services REST API'siyle çeşitli işlemlerin nasıl yürütülecekleri gösterilmektedir.

Ö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.

Bulucu Varlık Özellikleri

Özellik Tür Description
Id

İsteğe bağlı. Varlık oluşturulduktan sonra güncelleştirilemez.		 Edm.String Media Services tarafından ayarlanan benzersiz tanımlayıcı.
Name

İsteğe bağlı.		 Edm.String Bulucunun adı. Maksimum uzunluk 4000'dir.
ExpirationDateTime

Yalnızca yazma. ExpirationDateTime değerini güncelleştirmek için MERGE HTTP isteği kullanın.		 Edm.DateTime Bulucunun belirtilen varlığa erişmek için artık kullanılamayacağı değer (1 Ocak 1970 gece yarısından itibaren milisaniye cinsinden gösterilir).

ExpirationDateTime şu DateTime biçiminde olmalıdır: YYYY-MM-DDTHH:mm:ssZ (örneğin, "2014-05-23T17:53:50Z").
Type

Gereklidir. Varlık oluşturulduktan sonra güncelleştirilemez.		 Edm.Int32 Bulucu türünü açıklayan numaralandırma değeri. Geçerli değerler:

- Hiçbiri = 0: Bu varsayılan numaralandırma değeridir. Geçerli hiçbir bulucu bu türe sahip olmayacak
- SAS = 1: Paylaşılan Erişim İmzası (Sas) bulucu türünü belirtir
- OnDemandOrigin = 2: Azure Media Service İsteğe Bağlı Kaynak akış uç noktasına başvuran bulucu türünü belirtir
Path

Salt okunur. Media Services tarafından ayarlanır.		 Edm.String Varlık dosyalarına erişmek için kullanılan URL.
BaseUri

Salt okunur. Media Services tarafından ayarlanır.		 Edm.String Varlık hakkındaki depo/hizmet/kapsayıcı bilgilerini sağlayan bulucunun bir bölümü. (örneğin, Dns Ana Bilgisayarı adı http://someservice.cloudapp.net)
ContentAccessComponent

Salt okunur. Media Services tarafından ayarlanır.		 Edm.String İçeriğe erişmek için gereken URI'nin bir bölümü. Bu belirtecin son medya URL'sindeki konumu bulucu türüne, medya türüne ve akış hizmetine bağlıdır.
AccessPolicyId

Salt okunur. Media Services tarafından ayarlanır.		 Edm.String Bulucu URL'si için izinleri ve süreyi tanımlayan AccessPolicy kimliği.

OnDemandOrigin bulucuları oluşturulurken Liste izni kullanılmamalıdır.
AssetId

Salt okunur. Media Services tarafından ayarlanır.		 Edm.String Erişim sağlamak istediğiniz içeriği içeren Varlığın kimliği.
StartTime

İsteğe bağlı.		 Edm.DateTime Bulucunuzun istemcilerin kullanabileceği tarih ve saat. Ipucu: Dosyalarınızı hemen karşıya yüklemeniz gerekiyorsa StartTime değerinizi geçerli saatten beş dakika önceye ayarlamanız gerekir. Bunun nedeni istemci makinenizle Media Services arasında saat dengesizliği olmasıdır. Ayrıca StartTime değeriniz şu DateTime biçiminde olmalıdır: YYYY-MM-DDTHH:mm:ssZ (örneğin, "2014-05-23T17:53:50Z").
AssetPolicy

Salt okunur. Media Services tarafından ayarlanır.		 AssetPolicy varlık kümesi AccessPolicy örneğine gezinti özelliği.
Asset

Salt okunur. Media Services tarafından ayarlanır.		 Asset varlık kümesi Varlık örneğine gezinti özelliği.

Bulucu Oluşturma

Bulucular bir POST HTTP isteğiyle oluşturulabilir.

Yöntem İstek URI'si HTTP Sürümü
POST <https:// accountname.restv2>.<location.media.azure.net/api/Locators> HTTP/1.1

Not

SAS bulucularının URL'leri, ilişkili depolama hesabının depolama anahtarları her güncelleştirildiğinde değişir. Daha fazla bilgi için bkz . Nasıl yapılır: Depolama Erişim Anahtarlarını Sıraladıktan Sonra Media Services'ı Güncelleştirme

Ö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/Locators 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: 182  
Expect: 100-continue  
  
{"AccessPolicyId": "nb:pid:UUID:25544a8f-8ccf-43b1-a188-2a860b35bffa", "AssetId" : "nb:cid:UUID:d062e5ef-e496-4f21-87e7-17d210628b7c", "StartTime" : "2014-05-17T16:45:53", "Type":1}

Daha fazla bilgi için bkz . Media Services REST API ile Varlıkları Teslim Etme.

Liste Bulucuları

Bulucular GET HTTP isteği kullanılarak alınabilir.

Yöntem İstek URI'si HTTP Sürümü
GET GET https://< accountname.restv2>.<location.media.azure.net/api/Locators> HTTP/1.1
Yöntem İstek URI'si HTTP Sürümü
GET <https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid') HTTP/1.1
Yöntem İstek URI'si HTTP Sürümü
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/Bulucular 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/Locators('nb:lid:UUID:627cbafb-3d81-4623-97c2-2194282b6d16') 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

Bulucu güncelleştirme

Kaynak Bulucular BIR MERGE HTTP isteği 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/Locators>('locatorid') 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/Locators('nb:lid:UUID:5bfcb65d-843d-4d5e-bf71-9306ecb08203') 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: 38  
Expect: 100-continue  
  
{"StartTime" : "2014-05-17T16:45:53"}

Bulucu silme

Bulucular DELETE HTTP isteği kullanılarak silinebilir.

Yöntem İstek URI'si HTTP Sürümü
DELETE <https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid') 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/Locators('nb:lid:UUID:9f0e0cee-8ea5-46c4-b985-5a7cd30e7623') 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  
Connection: Keep-Alive

Ayrıca Bkz.

Media Services REST API ile Varlıkları Teslim Etme
ContentKey
Varlık
AccessPolicy
AssetFile
JobTemplate
İş
MediaProcessor
Görev
Görev Şablonu
Kotalar ve Sınırlamalar