匯出 (0) 列印
全部展開

Locator

更新日期: 2015年2月

Locator 提供存取資產中包含之檔案的進入點。使用 AccessPolicy 來定義用戶端可存取指定之資產的權限與持續時間。Locator 和 AccessPolicy 可以有多對一關係,讓不同定位器能夠為不同的用戶端提供不同的開始時間與連線類型,而同時全部使用相同的權限與持續時間設定;但是,由於 Azure 儲存服務設定的共用存取原則限制,指定的資產一次不能有超過五個相關的唯一定位器。如需詳細資訊,請參閱使用共用存取簽章 (REST API)

您常需要轉換 Locator URI,以便存取各種的檔案格式。例如,SAS 定位器的 Path 屬性提供容器的存取權。若要存取檔案,必須在主機與 SAS 簽章之間內嵌檔案名稱。使用 OnDemandOrigin 定位器時,必須先將通訊協定特定部分加入 Path 屬性,此內容才有作用。

下列規則控制何時可以建立及更新定位器:

  1. 要等到檔案上至資產之後,才能夠建立用於定義讀取權限之 AccessPolicies 的存取簽章 (SAS) URL 定位器和原始定位器。用來下載或上傳檔案的 SAS URL 定位器,唯有在指定寫入權限的 AccessPolicies 時,才能在上傳檔案之前建立。

  2. SAS URL 定位器建立之後就不能更新;不過其他定位器類型 (例如原始定位器) 可以使用新的 StartTime 值更新。

  3. 從建立定位器到可以使用定位器,這中間可能會有 30 到 40 秒的延遲。SAS URL 與 OnDemandOrigin 定位器都會發生這樣的延遲問題。

note附註
定位器並非針對管理使用者存取控制所設計。若要針對個別使用者給予不同的存取權限,使用 Digital Rights Management (DRM) 方案。

本主題概述 Locator 實體,也會示範如何使用 Media Services REST API 執行各種作業。

Important重要事項
使用媒體服務 REST API 時,適用下列考量:

 

屬性 型別 描述

Id

選擇性。無法在建立實體之後更新。

Edm.String

媒體服務 所設定的唯一識別碼。

Name

選擇性。

Edm.String

定位器名稱。最大長度為 4000。

ExpirationDateTime

唯寫。使用 MERGE HTTP 要求,以更新 ExpirationDateTime 值。

Edm.DateTime

不能再使用定位器來存取指定之資產的時間值 (從 1970 年 1 月 1 日午夜起的毫秒數)。

ExpirationDateTime 必須是以下 DateTime 格式:YYYY-MM-DDTHH:mm:ssZ (例如 "2014-05-23T17:53:50Z")。

Type

必要項。無法在建立實體之後更新。

Edm.Int32

描述定位器類型的列舉值。有效的值為:

  • = 0這是預設的列舉值。有效的定位器不會有此類型

  • SAS = 1:指定共用存取簽章 (Sas) 定位器類型

  • OnDemandOrigin = 2:指定參考 Azure Media Service 依需求原始資料流端點的定位器類型

Path

唯讀。由 媒體服務 設定。

Edm.String

用於存取資產檔案的 URL。

BaseUri

唯讀。由 媒體服務 設定。

Edm.String

定位器的一部分,可提供與資產相關的儲存/服務/容器資訊。(例如,DNS 主機名稱 http://someservice.cloudapp.net)

ContentAccessComponent

唯讀。由 媒體服務 設定。

Edm.String

URI 中存取內容所需的部分。此權杖在最終媒體 URL 中的位置依定位器類型、媒體類型和串流服務而定。

AccessPolicyId

唯讀。由 媒體服務 設定。

Edm.String

定義定位器 URL 之權限與持續時間之 AccessPolicy 的識別碼。

請注意清單權限在建立 OnDemandOrigin 定位器時不應該使用。

AssetId

唯讀。由 媒體服務 設定。

Edm.String

包含您要提供存取權之內容的資產的識別碼。

StartTime

選擇性。

Edm.DateTime

定位器可供用戶端使用的日期與時間。

Tip提示
如果需要立即上傳您的檔案,應該將 StartTime 值設定為目前時間的五分鐘前。這是因為您的用戶端電腦與 媒體服務 之間可能有時間差。此外,您的 StartTime 值必須為以下 DateTime 格式:YYYY-MM-DDTHH:mm:ssZ (例如 "2014-05-23T17:53:50Z")。

AssetPolicy

唯讀。由 媒體服務 設定。

AssetPolicy 實體集

AccessPolicy 執行個體的瀏覽內容。

Asset

唯讀。由 媒體服務 設定。

Asset 實體集

Asset 執行個體的瀏覽內容。

定位器可以使用 POST HTTP 要求來建立。

 

方法 要求 URI HTTP 版本

POST

https://media.windows.net/API/Locators

HTTP/1.1

Important重要事項
順利連接到 https://media.windows.net 後,您將會收到指定另一個媒體服務 URI 的 301 重新導向。您必須針對新的 URI 進行後續呼叫。

POST https://media.windows.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.7
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=youraccountname&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1337212980&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=kK7PbPM3lTAEJYIx5OTWeaSY7zvia358UjPiuvSFHz0%3d
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}

如需詳細資訊,請參閱使用媒體服務 REST API 傳遞資產

定位器可以使用 GET HTTP 要求來擷取。

 

方法 要求 URI HTTP 版本

GET

GET https://media.windows.net/API/Locators

HTTP/1.1

 

方法 要求 URI HTTP 版本

GET

https://media.windows.net/API/Locators('locatorid')

HTTP/1.1

 

方法 要求 URI HTTP 版本

GET

https://media.windows.net/API/Assets('assetid')/Locators

HTTP/1.1

Important重要事項
順利連接到 https://media.windows.net 後,您將會收到指定另一個媒體服務 URI 的 301 重新導向。您必須針對新的 URI 進行後續呼叫。

GET https://media.windows.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.7
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=youraccountname&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1337219077&Issuer=https%3a%2f%2fnimbustestaccounts.accesscontrol.windows.net%2f&HMACSHA256=JSeCQMLMDLIm%2fFD%2b8qJL52dShVNGdwg1aqB%2b3GLlq5I%3d
Host: media.windows.net

原始定位器可以使用 MERGE HTTP 要求來更新。

 

方法 要求 URI HTTP 版本

MERGE

https://media.windows.net/API/Locators('locatorid')

HTTP/1.1

Important重要事項
順利連接到 https://media.windows.net 後,您將會收到指定另一個媒體服務 URI 的 301 重新導向。您必須針對新的 URI 進行後續呼叫。

MERGE https://media.windows.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.7
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=youraccountname&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1337219313&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=iULfw27Jo4TIBljQr8MDMDh2TX6YZBShgvY9yblaqKU%3d
Host: media.windows.net
Content-Length: 38
Expect: 100-continue

{"StartTime" : "2014-05-17T16:45:53"}

定位器可以使用 DELETE HTTP 要求來刪除。

 

方法 要求 URI HTTP 版本

刪除

https://media.windows.net/API/Locators('locatorid')

HTTP/1.1

Important重要事項
順利連接到 https://media.windows.net 後,您將會收到指定另一個媒體服務 URI 的 301 重新導向。您必須針對新的 URI 進行後續呼叫。

DELETE https://media.windows.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.7
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=youraccountname&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1337219313&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=iULfw27Jo4TIBljQr8MDMDh2TX6YZBShgvY9yblaqKU%3d
Host: media.windows.net
Content-Length: 0
Connection: Keep-Alive

另請參閱

顯示:
© 2015 Microsoft