IngestManifestFile
IngestManifestFile 代表要在大量擷取中上傳的實際視訊或音訊 Blob 物件。 如需大量擷取的詳細資訊，請參閱 使用 REST API 大量擷取資產。 IngestManifestFile 永遠和 IngestManifest 與 IngestManifestAsset 相關聯。
本主題概述 IngestManifestFile 實體，也會示範如何使用 Media Services REST API 執行各種作業。
重要
在媒體服務中存取實體時，您必須在 HTTP 要求中設定特定的標頭欄位和值。
如需詳細資訊，請參閱媒體服務 REST API 開發和使用媒體服務 REST API 連線到媒體服務。
IngestManifestFile 實體屬性
| 屬性 | 類型 | 說明 |
|---|---|---|
Id唯讀。 建立時由媒體服務設定。 |
Edm.String | 唯一識別碼。 |
Created唯讀。 建立時由媒體服務設定。 |
Edm.DateTime | 代表自 1970 年 1 月 1 日午夜起的毫秒數。 |
LastModified唯讀。 由 Media Services 設定。 |
Edm.DateTime | 進行任何屬性變更之後，媒體服務就會更新此值。 它代表自 1970 年 1 月 1 日午夜起的毫秒數。 |
Name必要。 |
Edm.String | 實際檔案名，將會上傳至 IngestManifest 的 BlobStorageUriForUpload 屬性所參考的 Blob 容器。 媒體服務會依名稱監看該容器中的檔案上傳。 檔案名稱不能為空白或空白空間。 在 IngestManifest 中為唯一。 最大長度為 4000。 |
State唯讀。 由 Media Services 設定。 |
Edm.Int32 | IngestManifestFile 的目前狀態。 這個值可以是下列其中一個值： - 擱置 = 0：檔案尚未上傳，才能完成資產建立。 媒體服務正在等候檔案上傳。 - 完成 = 1：偵測到檔案上傳，且相關聯的資產已更新。 - 錯誤 = 2：處理此檔案時發生錯誤。 請參閱 ErrorDetails 屬性以取得錯誤資訊。 |
ParentIngestManifestId必要。 |
Edm.String | 包含此檔案之資訊清單的 IngestManifest 識別碼。 |
ParentIngestManifestAssetId必要。 |
Edm.String | 與此檔案相關聯之 IngestManifestAsset 的 IngestManifestAsset 識別碼。 |
ErrorDetail唯讀。 由 Media Services 設定。 |
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
IngestManifestFile 可以使用 HTTP POST 要求來建立。 您必須傳遞包含新 IngestManifestFile 之 Name 的名稱及 ParentIngestManifestId 與 ParentIngestManifestAssetId 的要求本文。
| 方法 | 要求 URI | HTTP 版本 |
|---|---|---|
| POST | HTTPs:// < accountname.restv2 > 。 <location.media.azure.net/api/IngestManifestFiles > | HTTP/1.1 |
範例要求
若要取得最新的 x-ms-version: ，請參閱 媒體服務 REST。
POST https://<accountname>.restv2.<location>.media.azure.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.19
Authorization: Bearer <token value>
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
IngestManifestFile 可以使用 HTTP GET 要求來擷取。 您可以依識別碼要求 IngestManifestFile，或者省略識別碼以要求全部的 IngestManifestFile。
| 方法 | 要求 URI | HTTP 版本 |
|---|---|---|
| GET | HTTPs:// < accountname.restv2 > 。 <location.media.azure.net/api/IngestManifestFiles > | HTTP/1.1 |
| GET | HTTPs:// < accountname.restv2 > 。 <location.media.azure.net/api/IngestManifestFiles ('IngestManifestFile > Id') | HTTP/1.1 |
範例要求
若要取得最新的 x-ms-version: ，請參閱 媒體服務 REST。
GET https://<accountname>.restv2.<location>.media.azure.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.19
Authorization: Bearer <token value>
Host: media.windows.net
刪除 IngestManifestFile
可以使用 HTTP DELETE 要求參考 IngestManifestFile 識別碼值來刪除 IngestManifestFile。
| 方法 | 要求 URI | HTTP 版本 |
|---|---|---|
| 刪除 | HTTPs:// < accountname.restv2 > 。 <location.media.azure.net/api/IngestManifestFiles ('IngestManifestFile > Id') | HTTP/1.1 |
範例要求
若要取得最新的 x-ms-version: ，請參閱 媒體服務 REST。
DELETE https://<accountname>.restv2.<location>.media.azure.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.19
Authorization: Bearer <token value>
Host: media.windows.net
Content-Length: 0
另請參閱
AssetFile
IngestManifest
IngestManifestAsset
IngestManifestStatistics
配額和限制