IngestManifest
IngestManifest 代表要透過大量擷取建立的一組資產，以及其相關聯的資產檔案。 大量擷取可讓您將檔案上傳程式與資產建立分離。 因此，高效能檔案上傳方法可用於資產建立期間的大型檔案集。 建立 IngestManifestAssets 以及其相關聯的 IngestManifestFiles 之後，Microsoft Azure 媒體服務透過BlobStorageUriForUpload屬性監看與 IngestManifest 相關聯的 Blob 儲存體容器。 隨著每個檔案上傳至 Blob 儲存體容器完成，Microsoft Azure 媒體服務針對包含該檔案的個別 IngestManifestAsset 完成新的資產。
本文提供實體的概 IngestManifest 觀，並示範如何使用媒體服務 REST API 執行各種作業。
重要
在媒體服務中存取實體時，您必須在 HTTP 要求中設定特定的標頭欄位和值。
如需詳細資訊，請參閱媒體服務 REST API 開發和使用媒體服務 REST API 連線到媒體服務。
注意
與 IngestManifest 相關聯的每個 IngestManifestAssetFile 都必須在資訊清單中具有唯一的檔案名。
IngestManifest 實體屬性
| 屬性 | 類型 | 說明 |
|---|---|---|
Id唯讀。 在建立時由媒體服務設定。 |
Edm.String | 唯一識別碼。 |
Created唯讀。 在建立時由媒體服務設定。 |
Edm.DateTime | 代表自 1970 年 1 月 1 日午夜起的毫秒數。 |
LastModified唯讀。 由 Media Services 設定。 |
Edm.DateTime | 在進行任何屬性變更之後，媒體服務會更新此值。 它代表自 1970 年 1 月 1 日午夜起的毫秒數。 |
Name選擇性。 |
Edm.String | IngestManifest 的好記名稱。 |
State唯讀。 由 Media Services 設定。 |
Edm.Int32 | 資訊清單的目前狀態。 這個值可以是下列其中一個值： - 非使用中 = 0：不會保留擱置的資產建立。 全部都已完成或發生錯誤。 - 啟動 = 1：資訊清單尚未準備好接收上傳至 Blob 容器的檔案。 - 作用 中 = 2：有 IngestManifestAssets 擱置的建立，且正在監視 Blob 容器。 |
BlobStorageUriForUpload唯讀。 由 Media Services 設定。 |
Edm.String | 此值是由媒體服務所設定。 這個值會指定 Blob 儲存體容器的 URI，此容器會接收完成 IngestManifestAssets 所需的檔案上傳。 |
Statistics唯讀。 由 Media Services 設定。 |
IngestManifestStatistics | 此複雜類型包含一些統計資訊，可根據與資訊清單相關之所有資產檔案，協助判斷建立 IngestManifestAssets 的目前進度。 |
IngestManifestAssets唯讀。 由 Media Services 設定。 |
IngestManifestAsset 實體集 | 導覽屬性，可以依識別碼值參考特定的 IngestManifestAsset 來存取。 傳回的實體集包含 IngestManifest 中包含的所有 IngestManifestAsset。 |
PendingIngestManifestAssets唯讀。 由 Media Services 設定。 |
IngestManifestAsset 實體集 | 導覽屬性，可以依識別碼值參考特定的 IngestManifestAsset 來存取。 傳回的實體集包含所有 IngestManifestAsset 待處理檔案上傳或資產建立。 |
StorageAccountName選擇性。 無法在建立實體之後更新。 |
Edm.String | 儲存體帳戶名稱包含已上傳檔案的 Blob 容器。 如果未在建立時指定，媒體服務會設定預設的儲存體帳戶名稱。 IngestManifestAsset.Asset 必須使用與 IngestManifest 中指定的相同儲存體帳戶。 |
StorageAccount唯讀。 由 Media Services 設定。 |
StorageAccount 實體集。 | 傳回的實體集包含連結到指定之 Asset 的所有 StorageAccount 實體。 |
建立 IngestManifest
IngestManifests 可以使用 HTTP POST 要求及傳遞包含新 IngestManifest 之名稱的要求本文來建立。
| 方法 | 要求 URI | HTTP 版本 |
|---|---|---|
| POST | HTTPs:// < accountname.restv2 > 。 <location.media.azure.net/api/IngestManifests > | HTTP/1.1 |
範例要求
若要取得最新的 x-ms-version: ，請參閱 媒體服務 REST。
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.19
Authorization: Bearer <token value>
Host: media.windows.net
Content-Length: 36
Expect: 100-continue
{ "Name" : "ExampleManifestREST" }
列出 IngestManifest
IngestManifest 可以使用 HTTP GET 要求擷取。 您可以依識別碼來要求擷取資訊清單，或要求所有的資訊清單。
| 方法 | 要求 URI | HTTP 版本 |
|---|---|---|
| GET | HTTPs:// < accountname.restv2 > 。 <location.media.azure.net/api/IngestManifests > | HTTP/1.1 |
| GET | HTTPs:// < accountname.restv2 > 。 <location.media.azure.net/api/IngestManifests ('IngestManifest > Id') | HTTP/1.1 |
範例要求
若要取得最新的 x-ms-version: ，請參閱 媒體服務 REST。
GET https://<accountname>.restv2.<location>.media.azure.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.19
Authorization: Bearer <token value>
Host: media.windows.net
Content-Length: 0
更新 IngestManifest
使用 HTTP MERGE 要求來參考 IngestManifest 識別碼，即可更新 IngestManifests。 要求本文包含要更新的屬性。
| 方法 | 要求 URI | HTTP 版本 |
|---|---|---|
| MERGE | HTTPs:// < accountname.restv2 > 。 <location.media.azure.net/api/IngestManifests ('IngestManifest > Id') | HTTP/1.1 |
範例要求
若要取得最新的 x-ms-version: ，請參閱 媒體服務 REST。
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.19
Authorization: Bearer <token value>
Host: media.windows.net
Content-Length: 43
Expect: 100-continue
{ "Name" : "ExampleManifestUpdated" }
刪除擷取資訊清單
可藉由使用 HTTP DELETE 要求來參考 IngestManifest 識別碼值，進而刪除 IngestManifest。
| 方法 | 要求 URI | HTTP 版本 |
|---|---|---|
| 刪除 | HTTPs:// < accountname.restv2 > 。 <location.media.azure.net/api/IngestManifests ('IngestManifest > Id') | HTTP/1.1 |
範例要求
若要取得最新的 x-ms-version: ，請參閱 媒體服務 REST。
DELETE https://<accountname>.restv2.<location>.media.azure.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.19
Authorization: Bearer <token value>
Host: media.windows.net
Content-Length: 0
另請參閱
AccessPolicy
AssetFile
資產
ContentKey
IngestManifestAsset
IngestManifestFile
IngestManifestStatistics
工作 (Job)
JobTemplate
定位
MediaProcessor
Task
TaskTemplate
配額和限制