IngestManifest
IngestManifest は、関連するアセット ファイルと共に一括取り込みを通じて作成されるアセットのセットを表します。 一括取り込みを使用すると、ファイルのアップロード プロセスを資産の作成から切り離すことができます。 その結果、資産の作成時に大きなファイル セットに対して高パフォーマンスのファイル アップロード方法を使用できます。 IngestManifestAssets が作成されると、関連付けられた IngestManifestFiles と共に、BlobStorageUriForUpload プロパティを介して IngestManifest に関連付けられている BLOB ストレージ コンテナーを監視Microsoft Azure Media Services。 Blob Storage コンテナーへの各ファイルのアップロードが完了すると、Microsoft Azure Media Servicesは、そのファイルを含むそれぞれの IngestManifestAsset の新しい資産を完了します。
この記事では、エンティティの IngestManifest 概要と、Media Services REST API を使用してさまざまな操作を実行する方法についても説明します。
重要
Media Services でエンティティにアクセスするときは、HTTP 要求で特定のヘッダー フィールドと値を設定する必要があります。
詳細については、「 Media Services REST API 開発のセットアップ」および「Media Services REST APIを使用した Media Services への接続」を参照してください。
注意
IngestManifest に関連付けられている各 IngestManifestAssetFile には、マニフェストに一意のファイル名が必要です。
IngestManifest エンティティのプロパティ
| プロパティ | 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 のフレンドリ名。 |
State読み取り専用です。 Media Services で設定します。 |
Edm.Int32 | マニフェストの現在の状態。 この値は、次のいずれかです。 - 非アクティブ = 0: 保留中の資産の作成は残されません。 すべては完了済みか、エラーが発生しました。 - アクティブ化 = 1: マニフェストはまだ BLOB コンテナーにアップロードされたファイルを受信する準備ができていません。 - アクティブ = 2: IngestManifestAssets 保留中の作成があり、BLOB コンテナーが監視されています。 |
BlobStorageUriForUpload読み取り専用です。 Media Services で設定します。 |
Edm.String | この値は Media Services によって設定されます。 この値は、Blob Storage コンテナーの URI を指定します。このコンテナーは、IngestManifestAssets を完了するために必要なファイルのアップロードを受け取ります。 |
Statistics読み取り専用です。 Media Services で設定します。 |
IngestManifestStatistics | この複雑な型には、マニフェストに関連するすべてのアセット ファイルに基づいて IngestManifestAsset の作成の現在の進行状況を判断するうえで役立つ、静的な情報が含まれています。 |
IngestManifestAssets読み取り専用です。 Media Services で設定します。 |
IngestManifestAsset エンティティ セット | 特定の IngestManifestAsset を ID 値で参照してアクセスできるナビゲーション プロパティ。 返されるエンティティ セットには、IngestManifest に含まれているすべての IngestManifestAsset が含まれます。 |
PendingIngestManifestAssets読み取り専用です。 Media Services で設定します。 |
IngestManifestAsset エンティティ セット | 特定の IngestManifestAsset を ID 値で参照してアクセスできるナビゲーション プロパティ。 返されるエンティティ セットには、ファイルのアップロードまたはアセットの作成が保留中のすべての IngestManifestAsset が含まれます。 |
StorageAccountName省略可能。 エンティティが作成された後に更新することはできません。 |
Edm.String | ファイルがアップロードされる BLOB コンテナーを含むストレージ アカウントの名前。 作成時に指定しない場合、Media Services は既定のストレージ アカウント名を設定します。 IngestManifestAsset.Asset は IngestManifest に指定されているのと同じストレージ アカウントを使用する必要があります。 |
StorageAccount読み取り専用です。 Media Services で設定します。 |
StorageAccount エンティティ セット。 | 返されるエンティティ セットには、指定されたアセットにリンクされたすべての StorageAccount エンティティが含まれます。 |
IngestManifest の作成
IngestManifest は、HTTP POST 要求を使用し、新しい IngestManifest の名前を含む要求の本文を渡すことによって作成できます。
| Method | 要求 URI | HTTP バージョン |
|---|---|---|
| POST | <https:// accountname.restv2>。<location.media.azure.net/api/IngestManifests> | HTTP/1.1 |
要求のサンプル
最新 x-ms-version:の を取得するには、「 Media Services 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 要求を使用して取得できます。 IngestManifest をその ID で要求するか、すべてのマニフェストを要求できます。
| Method | 要求 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:の を取得するには、「 Media Services 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 の更新
IngestManifests は、HTTP MERGE 要求で IngestManifest ID を参照することで更新できます。 要求本文には、更新するプロパティが含まれます。
| Method | 要求 URI | HTTP バージョン |
|---|---|---|
| MERGE | <https:// accountname.restv2>。<location.media.azure.net/api/IngestManifests>('IngestManifest Id') | HTTP/1.1 |
要求のサンプル
最新 x-ms-version:の を取得するには、「 Media Services 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" }
IngestManifest の削除
IngestManifest は、HTTP DELETE 要求で IngestManifestFile ID 値を参照することで削除できます。
| Method | 要求 URI | HTTP バージョン |
|---|---|---|
| DELETE | <https:// accountname.restv2>。<location.media.azure.net/api/IngestManifests>('IngestManifest Id') | HTTP/1.1 |
要求のサンプル
最新 x-ms-version:の を取得するには、「 Media Services 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
Asset
ContentKey
IngestManifestAsset
IngestManifestFile
IngestManifestStatistics
ジョブ
JobTemplate
ロケーター
MediaProcessor
タスク
TaskTemplate
クォータと制限