匯出 (0) 列印
全部展開

IngestManifest

更新日期: 2014年8月

IngestManifest 代表要透過大量擷取建立的一組資產,以及其相關聯的資產檔案。大量擷取可以讓您將檔案上傳程序與資產建立分離,以便在建立資產的過程中針對每個大型檔案集使用高效能檔案上傳方法。要建立的每資產,都會以資訊清單包含之 IngestManifestAssets 集合中的 IngestManifestAsset 表示。建立 IngestManifestAssets 及其相關聯的 IngestManifestFile 之後,Microsoft Azure Media Services 會透過 BlobStorageUriForUpload 屬性監看與 IngestManifest 相關的 Blob 儲存容器。每檔案上傳到 Blob 儲存容器完成之後,Microsoft Azure Media Services 會完成包含該檔案之個別 IngestManifestAsset 的新資產。

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

Important重要事項
使用 Media Services REST API 時,適用下列考量:

note附註
與 IngestManifest 相關的每 IngestManifestAssetFile 必須在資訊清單中有唯一的檔案名稱。

 

屬性 類型 說明

Id

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

Edm.String

唯一識別碼。

Created

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

Edm.DateTime

代表自 1970 年 1 月 1 日午夜起的毫秒數。

LastModified

唯讀。由 媒體服務 設定。

Edm.DateTime

媒體服務 會在進行任何屬性變更之後更新此值。它代表自 1970 年 1 月 1 日午夜起的毫秒數。

Name

選擇性。

Edm.String

IngestManifest 的好記名稱。

State

唯讀。由 媒體服務 設定。

Edm.Int32

資訊清單的目前狀態。此值可以是下列值之一:

  • 非使用中 = 0:沒有擱置資產建立持續存在。全部都已完成或發生錯誤。

  • 啟用中 = 1:資訊清單尚未準備好接收上傳到 Blob 容器的檔案。

  • 使用中 = 2:還有 IngestManifestAssets 正等待建立,而且正在監看 Blob 容器。

BlobStorageUriForUpload

唯讀。由 媒體服務 設定。

Edm.String

此值是由 媒體服務 設定。此值指定接收完成 IngestManifestAssets 所需之檔案上傳的 Blob 儲存容器的 URI。

Statistics

唯讀。由 媒體服務 設定。

IngestManifestStatistics

此複雜類型包含一些統計資訊,可根據與資訊清單相關之所有資產檔案,協助判斷建立 IngestManifestAssets 的目前進度。

IngestManifestAssets

唯讀。由 媒體服務 設定。

IngestManifestAsset 實體集

導覽屬性,可以依識別碼值參考特定的 IngestManifestAsset 來存取。傳回的實體集包含 IngestManifest 中包含的所有 IngestManifestAsset。

PendingIngestManifestAssets

唯讀。由 媒體服務 設定。

IngestManifestAsset 實體集

導覽屬性,可以依識別碼值參考特定的 IngestManifestAsset 來存取。傳回的實體集包含所有 IngestManifestAsset 待處理檔案上傳或資產建立。

StorageAccountName

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

Edm.String

儲存體帳戶名稱包含已上傳檔案的 Blob 容器。

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

IngestManifestAsset.Asset 必須使用與 IngestManifest 中指定的相同儲存體帳戶。

StorageAccount

唯讀。由 媒體服務 設定。

StorageAccount 實體集。

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

IngestManifests 可以使用 HTTP POST 要求及傳遞包含新 IngestManifest 之名稱的要求本文來建立。

 

方法 要求 URI HTTP 版本

POST

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

HTTP/1.1

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

POST https:// media.windows.net/API/IngestManifests HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.6
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: 36
Expect: 100-continue

{ "Name" : "ExampleManifestREST" }

IngestManifest 可以使用 HTTP GET 要求擷取。您可以依識別碼來要求擷取資訊清單,或要求所有的資訊清單。

 

方法 要求 URI HTTP 版本

GET

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

HTTP/1.1

GET

https://media.windows.net/API/IngestManifests(‘IngestManifest Id’)

HTTP/1.1

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

GET https://media.windows.net/API/IngestManifests('nb:mid:UUID:a2f9a230-831e-5e40-bafa-fbf8decbee26') HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.6
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

使用 HTTP MERGE 要求參考 IngestManifest 識別碼可以更新 IngestManifest。要求本文包含要更新的屬性。

 

方法 要求 URI HTTP 版本

MERGE

https://media.windows.net/API/IngestManifests(‘IngestManifest Id’)

HTTP/1.1

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

MERGE https:// media.windows.net /API/IngestManifests('nb:mid:UUID:076faa09-8f5d-ce41-9de3-32ba66190271') HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.6
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: 43
Expect: 100-continue

{ "Name" : "ExampleManifestUpdated" }

可藉由使用 HTTP DELETE 要求來參考 IngestManifest 識別碼值,進而刪除 IngestManifest。

 

方法 要求 URI HTTP 版本

DELETE

https://media.windows.net/API/IngestManifests(‘IngestManifest Id’)

HTTP/1.1

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

DELETE https://media.windows.net/API/IngestManifests('nb:mid:UUID:45ea3cd0-b3cf-994b-8e4d-03c9620c22da') HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.6
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

另請參閱

顯示:
© 2014 Microsoft