匯出 (0) 列印
全部展開

資產

更新日期: 2015年2月

Asset 實體包含數位檔案 (包括視訊、音訊、影像、縮圖集合、文字播放軌、隱藏式輔助字幕檔案) 以及這些檔案的相關中繼資料。將數位檔案上傳到資產之後,可以用於媒體服務編碼和串流工作流程。

當您編碼資產時,會在編碼工作完成時產生輸出資產。在上述檔案中,輸出資產包含可描述輸入資產和輸出資產的 XML 中繼資料檔案。如需詳細資訊,請參閱輸入中繼資料輸出中繼資料主題。

媒體服務 中的資產具有下列特性:
資產是邏輯單位,代表單一的視聽展示檔。

資產包含一或多個媒體檔案的集合。

資產的檔案位於單一的 Blob 儲存容器中。

以下是資產的一些範例:完整的影片、電視節目、特定的剪輯;電影、電視節目、動畫、攝影機 ISO 檔案、事件等的片段;預告影片或促銷視訊;廣告;音訊檔案、收音機節目、播客、音效檔案等。

媒體服務 中的資產沒有下列特性:
只是儲存容器

組織及儲存同一份展示檔之多個版本的資料夾

將多個視聽展示檔的批次處理送出到 Azure Media Encoder 的資料夾

例如,不應該將電影、其預告片、廣告及同一部電影的國際剪輯版儲存在資產中。

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

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

 

屬性 類型 描述

Id

唯讀。在建立時間由 媒體服務 設定。

字串

唯一識別碼。

State

唯讀。由 媒體服務 設定。

Edm.Int32

描述資產之狀態的列舉值。有效值是:

  • 已初始化 = 0

  • 已發行 = 1

    Warning警告
    Publish 動作已被取代。移除檢查資產是否為 Published 狀態的程式碼。

  • 已刪除 = 2

在刪除之前,資產均為已初始狀態。

Created

唯讀。在建立時間由 媒體服務 設定。

Edm.DateTime

此值是由 媒體服務 在建立時設定。

LastModified

唯讀。由 媒體服務 設定。

Edm.DateTime

媒體服務 會在進行任何屬性變更之後更新此值。

AlternateId

選擇性。

Edm.String

對應到另內容管理系統中之識別碼的替代識別碼值。最大長度為 4000。

Name

選擇性。

Edm.String

資產的好記名稱。最大長度為 4000。

Options

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

Edm.Int32

描述可用來建立資產之加密選項的列舉值。有效值是以下清單中的值,而非清單中許多個值的組合:

  • = 0不指定資產建立選項。

  • StorageEncrypted = 1:指定建立資產時應該將資產的檔案加密以便上傳和儲存。

  • CommonEncryptionProtected = 2:指定使用一般加密方法 (例如 PlayReady) 保護資產的檔案。

  • EnvelopeEncryptionProtected = 4

Uri

唯讀。由 媒體服務 設定。

Edm.String

指定 Asset 的 Blob 儲存體容器 URI。

Locators

唯讀。由 媒體服務 設定。

Locator 實體集

傳回的實體集包含連結到指定之 Asset 的所有 Locator 實體。

ContentKeys

選擇性。

ContentKey 實體集

傳回的實體集包含連結到指定之 Asset 的所有 ContentKey 實體。

Files

唯讀。由 媒體服務 設定。

File 實體集

傳回的實體集包含連結到指定之 Asset 的所有 File 實體。

ParentAssets

選擇性。

上層 Assets 實體集

傳回的實體集包含連結到指定之 Asset 的所有上層 Asset 實體。

StorageAccountName

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

Edm.String

包含資產 Blob 容器的儲存體帳戶名稱。

若並未在建立時間指定,媒體服務 會設定預設儲存體帳戶名稱。

StorageAccount

唯讀。由 媒體服務 設定。

StorageAccount 實體集

傳回的實體集包含連結到指定之 Asset 的所有 StorageAccount 實體。

DeliveryPolicies

AssetDeliveryPolicy 實體集

傳回的實體集會包含與資產相關聯的傳遞原則。

資產可以使用 POST HTTP 要求及指定屬性值來建立。

 

方法 要求 URI HTTP 版本

POST

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

HTTP/1.1

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

POST https://media.windows.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.7
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=070500D0-F35C-4A5A-9249-485BBF4EC70B&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1334275521&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=GxdBb%2fmEyN7iHdNxbawawHRftLhPFFqxX1JZckuv3hY%3d
Host: media.windows.net
Content-Length: 27
Expect: 100-continue

{ "Name" : "NewJSONAsset" }

資產可以使用 GET HTTP 要求擷取。

 

方法 要求 URI HTTP 版本

GET

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

HTTP/1.1

 

方法 要求 URI HTTP 版本

GET

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

HTTP/1.1

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

GET https://media.windows.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.7
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=070500D0-F35C-4A5A-9249-485BBF4EC70B&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1334275521&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=GxdBb%2fmEyN7iHdNxbawawHRftLhPFFqxX1JZckuv3hY%3d
Host: media.windows.net
Content-Length: 0


資產可以使用 MERGE HTTP 要求和您要變更的特定屬性來更新。

 

方法 要求 URI HTTP 版本

MERGE

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

HTTP/1.1

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

MERGE https://media.windows.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.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=1337083279&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=DMLQXWah4jO0icpfwyws5k%2b1aCDfz9KDGIGao20xk6g%3d
Host: media.windows.net
Content-Length: 21
Expect: 100-continue

{"Name" : "NewName" }

可以參考資產識別值來刪除資產。刪除資產後,Microsoft Azure Media Services 會刪除其所有的定位器。如果資產有原始定位器,也會撤銷及刪除這些定位器。會刪除 ContentKey 的所有連結,以及未連結到其他資產的任何 ContentKey。

 

方法 要求 URI HTTP 版本

刪除

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

HTTP/1.1

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

DELETE https://media.windows.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.7
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=070500D0-F35C-4A5A-9249-485BBF4EC70B&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1334275521&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=GxdBb%2fmEyN7iHdNxbawawHRftLhPFFqxX1JZckuv3hY%3d
Host: media.windows.net
Content-Length: 0


note附註
Publish 動作已被取代。從最新的 媒體服務 版本開始,不應該再使用 Publish

如果您的程式碼使用 Publish,請注意下列考量:

  1. Publish 動作不會刪除與資產相關聯的定位器。您必須在呼叫 Publish 後明確刪除程式碼中的定位器。

  2. Publish 動作不會將資產狀態設定為 Published。移除檢查資產是否為 Published 狀態的程式碼。目前資產只能有 InitializedDeleted 狀態。

您可以使用 HTTP POST 要求參考資產識別碼,將 ContentKey 連結到資產。要求的本文中必須包含 ContentKey 的 URI。只能連結與資產之 CreationOptions 中指定之類型一樣的 ContentKey 類型。例如,Asset 的選項若設定為 StorageEncrypted(1),ContentKey 的類型必須是 StorageEncryption(1)。

 

方法 要求 URI HTTP 版本

POST

https://media.windows.net/API/Assets(‘Asset Id')/$links/ContentKeys

HTTP/1.1

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

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

{ "uri": "https://media.windows.net/api/ContentKeys('nb%3Akid%3AUUID%3A5db89211-c9d9-404b-a6bc-3e6b91c7a214')"}

您可以在 HTTP DELETE 要求中參考資產識別碼與 ContentKey 識別碼,從資產移除 ContentKey 連結。如果 ContentKey 並未連結到其他任何資產,則會遭到刪除。

 

方法 要求 URI HTTP 版本

刪除

https://media.windows.net/API/Assets(‘Asset Id')/$links/ContentKeys('ContentKey Id')

HTTP/1.1

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

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

另請參閱

顯示:
© 2015 Microsoft