匯出 (0) 列印
全部展開

IngestManifestFile

更新日期: 2015年2月

IngestManifestFile 代表要在大量擷取中上傳的實際視訊或音訊 Blob 物件。如需大量擷取的詳細資訊,請參閱使用 REST API 大量擷取資產。IngestManifestFile 永遠和 IngestManifest 與 IngestManifestAsset 相關聯。

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

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

 

屬性 類型 描述

Id

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

Edm.String

唯一識別碼。

Created

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

Edm.DateTime

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

LastModified

唯讀。由 媒體服務 設定。

Edm.DateTime

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

Name

必要項。

Edm.String

將會上傳到 IngestManifest 之 BlobStorageUriForUpload 屬性所參考的 Blob 容器的實際檔案名稱。媒體服務 會依名稱監看該容器內的檔案上傳。

檔案名稱不能為空白或空白空間。在 IngestManifest 中為唯一。最大長度為 4000。

State

唯讀。由 媒體服務 設定。

Edm.Int32

IngestManifestFile 的目前狀態。此值可以是下列值之一:

  • 擱置 = 0:檔案尚未上傳以完成資產建立。媒體服務 正在等候檔案上傳。

  • 已完成 = 1:已偵測到檔案上傳,並已更新相關的資產。

  • 錯誤 = 2:處理此檔案時發生錯誤。請參閱 ErrorDetails 屬性以取得錯誤資訊。

ParentIngestManifestId

必要項。

Edm.String

包含此檔案之資訊清單的 IngestManifest 識別碼。

ParentIngestManifestAssetId

必要項。

Edm.String

與此檔案相關聯之 IngestManifestAsset 的 IngestManifestAsset 識別碼。

ErrorDetail

唯讀。由 媒體服務 設定。

Edm.String

處理此檔案時發生之錯誤的詳細資料。

MimeType

選擇性。

Edm.String

媒體服務不會檢查您上傳的任何 Blob,因此您必須手動設定 MIME 類型。例如,「text/plain」或「video/x-ms-wmv」是可用的有效值。

IsPrimary

選擇性。

Edm.Boolean

判斷此 IngestManifestFile 是否為多檔案資產中的主要檔案。

EncryptionVersion

選擇性。

Edm.String

StorageEncryption、CommonEncryption 與 EnvelopeEncryption 目前支援的版本為「1.0」。

EncryptionScheme

選擇性。

Edm.String

此檔案使用的加密配置。有效值是:「StorageEncryption」、「CommonEncryption」或「EnvelopeEncryption」。

IsEncrypted

選擇性。

Edm.Boolean

如果此檔案是以加密方式儲存,此值應設為 true

EncryptionKeyId

選擇性。

Edm.String

加密 ContentKey 識別嗎。

InitializationVector

選擇性。

Edm.String

用於儲存體加密的初始化向量。

IngestManifestFile 可以使用 HTTP POST 要求來建立。您必須傳遞包含新 IngestManifestFile 之 Name 的名稱及 ParentIngestManifestIdParentIngestManifestAssetId 的要求本文。

 

方法 要求 URI HTTP 版本

POST

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

HTTP/1.1

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

POST https://media.windows.net/API/IngestManifestFiles 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: 200
Expect: 100-continue

{ "Name" : "REST_Example_File.wmv", "ParentIngestManifestId" : "nb:mid:UUID:bfe2d76c-17bd-884a-b9be-21bdfda65984", "ParentIngestManifestAssetId" : "nb:maid:UUID:9c6e7256-fefd-c541-aa69-fd04cf1cc1a6" }

IngestManifestFile 可以使用 HTTP GET 要求來擷取。您可以依識別碼要求 IngestManifestFile,或者省略識別碼以要求全部的 IngestManifestFile。

 

方法 要求 URI HTTP 版本

GET

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

HTTP/1.1

GET

https://media.windows.net/API/IngestManifestFiles(‘IngestManifestFile Id’)

HTTP/1.1

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

GET https://media.windows.net/API/IngestManifestFiles('nb:mfid:UUID:030ef5ef-c5b3-2c4a-86da-217d4d2170de') 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

可以使用 HTTP DELETE 要求參考 IngestManifestFile 識別碼值來刪除 IngestManifestFile。

 

方法 要求 URI HTTP 版本

刪除

https://media.windows.net/API/IngestManifestFiles(‘IngestManifestFile Id’)

HTTP/1.1

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

DELETE https://media.windows.net/API/IngestManifestFiles('nb:mfid:UUID:030ef5ef-c5b3-2c4a-86da-217d4d2170de') 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

另請參閱

顯示:
© 2015 Microsoft