IngestManifestFile
IngestManifestFile は、一括取り込みの一環としてアップロードされる実際のビデオまたはオーディオ BLOB オブジェクトを表します。 一括取り込みの詳細については、「 REST API を使用した一括での資産の取り込み」を参照してください。 IngestManifestFile は、IngestManifest および IngestManifestAsset と常に関連付けられます。
このトピックは、IngestManifestFile エンティティを概説し、また Media Services REST API でさまざまな操作を実行する方法を示します。
重要
Media Services でエンティティにアクセスするときは、HTTP 要求で特定のヘッダー フィールドと値を設定する必要があります。
詳細については、「 Media Services REST API 開発のセットアップ」および「Media Services REST APIを使用した Media Services への接続」を参照してください。
IngestManifestFile エンティティ プロパティ
| プロパティ | Type | 説明 |
|---|---|---|
Id読み取り専用です。 作成時に Media Services によって設定されます。 |
Edm.String | 一意識別子。 |
Created読み取り専用です。 作成時に Media Services によって設定されます。 |
Edm.DateTime | 1970 年 1 月 1 日の午前 0 時からのミリ秒数を表します。 |
LastModified読み取り専用です。 Media Services で設定します。 |
Edm.DateTime | この値は、プロパティの変更が行われた後に Media Services によって更新されます。 1970 年 1 月 1 日の午前 0 時からのミリ秒数を表します。 |
Name必須。 |
Edm.String | IngestManifest の BlobStorageUriForUpload プロパティによって参照される BLOB コンテナーにアップロードされる実際のファイル名。 Media Services は、そのコンテナー内のファイルのアップロードを名前で監視します。 ファイル名は空または空白文字であってはなりません。 IngestManifest 内で一意です。 最大長は 4000 です。 |
State読み取り専用です。 Media Services で設定します。 |
Edm.Int32 | IngestManifestFile の現在の状態。 この値は、次のいずれかです。 - Pending = 0: アセットの作成を完了するためにファイルがまだアップロードされていません。 Media Services はファイルのアップロードを待機しています。 - 完了 = 1: ファイルのアップロードが検出され、関連付けられている資産が更新されました。 - エラー = 2: このファイルの処理中にエラーが発生しました。 エラーの情報については、ErrorDetails プロパティを参照してください。 |
ParentIngestManifestId必須。 |
Edm.String | このファイルを含むマニフェストの IngestManifest ID。 |
ParentIngestManifestAssetId必須。 |
Edm.String | このファイルが関連付けられている IngestManifestAsset の IngestManifestAsset ID。 |
ErrorDetail読み取り専用です。 Media Services で設定します。 |
Edm.String | このファイルの処理中に発生したエラーの詳細。 |
MimeType省略可能。 |
Edm.String | Media Services ではユーザーがアップロードした BLOB の検証が行われないため、MIME タイプは手動で設定する必要があります。 たとえば、「text/plain」や「video/x-ms-wmv」を有効な値として使用できます。 |
IsPrimary省略可能。 |
Edm.Boolean | この IngestManifestFile ファイルが、複数ファイルからなる Asset のプライマリ ファイルかどうかを判断します。 |
EncryptionVersion省略可能。 |
Edm.String | 現在サポートされている StorageEncryption、CommonEncryption、および EnvelopeEncryption のバージョンは「1.0」です。 |
EncryptionScheme省略可能。 |
Edm.String | このファイルに使用する暗号化スキーム。 有効な値は、"StorageEncryption"、"CommonEncryption"、または "EnvelopeEncryption" です。 |
IsEncrypted省略可能。 |
Edm.Boolean | ファイルを暗号化して格納する場合は、この値を true に設定する必要があります。 |
EncryptionKeyId省略可能。 |
Edm.String | 暗号化された ContentKey ID。 |
InitializationVector省略可能。 |
Edm.String | ストレージの暗号化に使用する初期化ベクトル。 |
IngestManifestFile の作成
IngestManifestFile は、HTTP POST 要求を使用して作成できます。 新しい IngestManifestFile の Name と共に ParentIngestManifestId と ParentIngestManifestAssetId が含まれる要求本文を渡す必要があります。
| Method | 要求 URI | HTTP バージョン |
|---|---|---|
| POST | <https:// accountname.restv2>。<location.media.azure.net/api/IngestManifestFiles> | HTTP/1.1 |
要求のサンプル
最新 x-ms-version:の を取得するには、「 Media Services 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 要求を使用して取得できます。 ID を指定して IngestManifestFile を要求するか、ID を省略することですべての IngestManifestFile を要求できます。
| Method | 要求 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:の を取得するには、「 Media Services 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 の削除
IngestManifestFile は、HTTP DELETE 要求で IngestManifestFile ID 値を参照することで削除できます。
| Method | 要求 URI | HTTP バージョン |
|---|---|---|
| DELETE | <https:// accountname.restv2>。<location.media.azure.net/api/IngestManifestFiles>('IngestManifestFile Id') | HTTP/1.1 |
要求のサンプル
最新 x-ms-version:の を取得するには、「 Media Services 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
クォータと制限