AssetFile
AssetFile 實體表示已經儲在 Blob 容器中的實際視訊或音訊檔案。 資產檔案一律會與資產相關聯，一個資產可包含一或多個檔案。 如果資產檔案物件並未與 blob 容器中的數位檔案相關聯，媒體服務編碼器工作將會失敗。
本主題概述 AssetFile 實體，也會示範如何使用 Media Services REST API 執行各種作業。
重要
在媒體服務中存取實體時，您必須在 HTTP 要求中設定特定的標頭欄位和值。
如需詳細資訊，請參閱媒體服務 REST API 開發和使用媒體服務 REST API 連線到媒體服務。
AssetFile 實體屬性
| 屬性 | 類型 | 說明 |
|---|---|---|
Id唯讀。 建立時由媒體服務設定。 |
Edm.String | 唯一識別碼。 |
Name必要。 |
Edm.String | AssetFile 的好記名稱。 預設值是您在上傳檔案時使用的檔案名稱。 最大長度為 260。
注意： 媒體服務會在為串流內容建置 URL 時使用 Name 屬性值 (，例如，http://{AMSAccount}.origin.mediaservices.windows.net/{GUID}/{IAssetFile.Name}/streamingParameters.) 基於這個理由，不允許百分比編碼。 Name 屬性的值不能有下列任何 百分比編碼保留字元：！*' () ;：@&=+$，/？%#[]“。 此外，只能有一個 ‘.’ 在檔案名稱的副檔名。 |
ContentFileSize選擇性。 |
Edm.Int64 | 內容的 AssetFile 大小 (以位元組為單位)。 |
ParentAssetId必要。 無法在建立實體之後更新。 |
Edm.String | 與此檔案相關聯之資產的資產識別碼。 |
EncryptionVersion選擇性。 |
Edm.String | StorageEncryption 與 CommonEncryption 目前支援的版本是「1.0」 |
EncryptionScheme選擇性。 |
Edm.String | 此檔案使用的加密配置。 有效值為：“StorageEncryption” 或 “CommonEncryption”。 |
IsEncrypted選擇性。 |
Edm.Boolean | 如果此檔案是以加密方式儲存，此值應設為 true。 |
EncryptionKeyId選擇性。 |
Edm.String | 加密 ContentKey 識別嗎。 |
InitializationVector選擇性。 |
Edm.String | 用於儲存體加密的初始化向量。 |
IsPrimary選擇性。 |
Edm.Boolean | 決定此檔案是否為多檔案資產的主要檔案。 |
LastModified唯讀。 建立時由媒體服務設定。 |
Edm.DateTime | 進行任何屬性變更之後，媒體服務就會更新此值。 它代表自 1970 年 1 月 1 日午夜起的毫秒數。 |
Created唯讀。 建立時由媒體服務設定。 |
Edm.DateTime | 代表自 1970 年 1 月 1 日午夜起的毫秒數。 |
MimeType選擇性。 |
Edm.String | 媒體服務不會檢查您上傳的任何 Blob，因此您必須手動設定 MIME 類型。 例如，「text/plain」或「video/x-ms-wmv」是可用的有效值。 最大長度為 4000。 |
ContentChecksum選擇性。 |
Edm.String | 代表 MD5 (RFC 1321) 訊息摘要值的十六進位數。 此值由用戶端或用戶端程式庫設定，做為成功上傳內容的驗證。 最大長度為 4000。 |
建立 AssetFile
CreateFileInfos 函數的作用是建立新的 AssetFile 實體。 如需詳細資訊，請參閱 REST API 函式。
列出 AssetFile
AssetFile 使用 GET HTTP 要求來擷取。
| 方法 | 要求 URI | HTTP 版本 |
|---|---|---|
| GET | https://< accountname.restv2>。<location.media.azure.net/api/Files> | HTTP/1.1 |
| 方法 | 要求 URI | HTTP 版本 |
|---|---|---|
| GET | https://< accountname.restv2>。<location.media.azure.net/api/Files ('fileid>') | HTTP/1.1 |
| 方法 | 要求 URI | HTTP 版本 |
|---|---|---|
| GET | https://< accountname.restv2>。<location.media.azure.net/api/Assets ('assetid>') /Files | HTTP/1.1 |
範例要求
若要取得最新的 x-ms-version:，請參閱 媒體服務 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 要求更新。
| 方法 | 要求 URI | HTTP 版本 |
|---|---|---|
| MERGE | https://< accountname.restv2>。<location.media.azure.net/api/Files ('fileid>') | HTTP/1.1 |
範例要求
若要取得最新的 x-ms-version:，請參閱 媒體服務 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 的相關聯資產後，會刪除 AssetFile。 如需範例，請參閱刪除資產。
另請參閱
ContentKey
資產
AccessPolicy
工作 (Job)
JobTemplate
定位
MediaProcessor
工作
TaskTemplate
配額和限制