AssetFile
AssetFile エンティティは、BLOB コンテナーに格納される実際のビデオ ファイルまたはオーディオ ファイルを表します。 資産ファイルは常に資産に関連付けられ、資産には 1 つまたは複数のファイルが含まれます。 資産ファイル オブジェクトが blob コンテナー内のデジタル ファイルに関連付けられていないと、Media Services のエンコーダー タスクは失敗します。
このトピックは、AssetFile エンティティを概説し、また Media Services REST API でさまざまな操作を実行する方法を示します。
重要
Media Services でエンティティにアクセスするときは、HTTP 要求で特定のヘッダー フィールドと値を設定する必要があります。
詳細については、「 Media Services REST API 開発のセットアップ」および「Media Services REST APIを使用した Media Services への接続」を参照してください。
AssetFile エンティティのプロパティ
| プロパティ | Type | 説明 |
|---|---|---|
Id読み取り専用です。 作成時に Media Services によって設定されます。 |
Edm.String | 一意識別子。 |
Name必須。 |
Edm.String | AssetFile のフレンドリ名。 既定値は、ファイルのアップロード中に使用したファイル名です。 最大長は 260 です。
メモ： Media Services は、ストリーミング コンテンツの URL を構築するときに プロパティの Name 値を使用します (たとえば、http://{AMSAccount}.origin.mediaservices.windows.net/{GUID}/{IAssetFile.Name}/streamingParameters)。このため、パーセントエンコードは許可されません。 Name プロパティの値には、パーセント エンコーディング予約文字 (!*'();:@&=+$,/?%#[]") は使用できません。 "." は 1 つのみです。 また、ファイル名拡張子で使用できる |
ContentFileSize省略可能。 |
Edm.Int64 | コンテンツの AssetFile サイズ (バイト単位)。 |
ParentAssetId必須。 エンティティが作成された後に更新することはできません。 |
Edm.String | このファイルが関連付けられている Asset の Asset ID。 |
EncryptionVersion省略可能。 |
Edm.String | StorageEncryption および CommonEncryption で現在サポートされているバージョンは "1.0" です。 |
EncryptionScheme省略可能。 |
Edm.String | このファイルに使用する暗号化スキーム。 有効な値は、"StorageEncryption" または "CommonEncryption" です。 |
IsEncrypted省略可能。 |
Edm.Boolean | ファイルを暗号化して格納する場合は、この値を true に設定する必要があります。 |
EncryptionKeyId省略可能。 |
Edm.String | 暗号化された ContentKey ID。 |
InitializationVector省略可能。 |
Edm.String | ストレージの暗号化に使用する初期化ベクトル。 |
IsPrimary省略可能。 |
Edm.Boolean | このファイルが、複数ファイルから成る Asset のプライマリ ファイルかどうかを判断します。 |
LastModified読み取り専用です。 作成時に Media Services によって設定されます。 |
Edm.DateTime | この値は、プロパティの変更が行われた後に Media Services によって更新されます。 1970 年 1 月 1 日の午前 0 時からのミリ秒数を表します。 |
Created読み取り専用です。 作成時に Media Services によって設定されます。 |
Edm.DateTime | 1970 年 1 月 1 日の午前 0 時からのミリ秒数を表します。 |
MimeType省略可能。 |
Edm.String | Media Services ではユーザーがアップロードした BLOB の検証が行われないため、MIME タイプは手動で設定する必要があります。 たとえば、「text/plain」や「video/x-ms-wmv」を有効な値として使用できます。 最大長は 4000 です。 |
ContentChecksum省略可能。 |
Edm.String | MD5 (RFC 1321) メッセージのダイジェスト値を表す 16 進数の値。 この値は、クライアントまたはクライアント ライブラリによって設定され、コンテンツの正常なアップロードの確認としての役割を果たします。 最大長は 4000 です。 |
AssetFile を作成する
新しい AssetFile エンティティを作成するために CreateFileInfos 関数が使用されます。 詳細については、「 REST API Functions」を参照してください。
AssetFile の一覧表示
AssetFile は、GET HTTP 要求を使用して取得します。
| Method | 要求 URI | HTTP バージョン |
|---|---|---|
| GET | <https:// accountname.restv2>。<location.media.azure.net/api/Files> | HTTP/1.1 |
| Method | 要求 URI | HTTP バージョン |
|---|---|---|
| GET | <https:// accountname.restv2>。<location.media.azure.net/api/Files>('fileid') | HTTP/1.1 |
| Method | 要求 URI | HTTP バージョン |
|---|---|---|
| GET | <https:// accountname.restv2>。<location.media.azure.net/api/Assets>('assetid')/Files | HTTP/1.1 |
要求のサンプル
最新 x-ms-version:の を取得するには、「 Media Services REST」を参照してください。
GET https://<accountname>.restv2.<location>.media.azure.net/api/Files('nb:cid:UUID:d0214595-fff0-164e-9c67-d576eba09605') 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
AssetFile の更新
AssetFile は MERGE HTTP 要求を使用して更新されます。
| Method | 要求 URI | HTTP バージョン |
|---|---|---|
| MERGE | <https:// accountname.restv2>。<location.media.azure.net/api/Files>('fileid') | HTTP/1.1 |
要求のサンプル
最新 x-ms-version:の を取得するには、「 Media Services REST」を参照してください。
MERGE https://<accountname>.restv2.<location>.media.azure.net/api/Files('nb:cid:UUID:2710e174-3165-a34c-96ad-618714b0d504') 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>
Content-Length: 27
Expect: 100-continue
{"MimeType" : "video/mp4" }
AssetFile の削除
AssetFile は、関連する Asset が削除されたときに削除されます。 例については、「アセットの削除」を参照してください。
参照
ContentKey
Asset
AccessPolicy
ジョブ
JobTemplate
ロケーター
MediaProcessor
タスク
TaskTemplate
クォータと制限