Share via

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

IngestManifestFile

  • 项目

IngestManifestFile 代表将作为批量引入的一部分上载的具体视频或音频 BLOB 对象。 有关批量引入的详细信息，请参阅 使用 REST API 批量引入资产。 IngestManifestFile 总是与 IngestManifest 和 IngestManifestAsset 关联。

本主题提供 IngestManifestFile 实体的概述，并且还演示如何使用 Media Services REST API 执行各种操作。

重要

访问媒体服务中的实体时，必须在 HTTP 请求中设置特定标头字段和值。
有关详细信息，请参阅 设置媒体服务 REST API 开发 和使用 媒体服务 REST API 连接到媒体服务。

IngestManifestFile 实体属性

属性 类型 说明
Id

只读。 由媒体服务在创建时设置。		 Edm.String 唯一标识符。
Created

只读。 由媒体服务在创建时设置。		 Edm.DateTime 表示自 1970 年 1 月 1 日午夜以来的毫秒数。
LastModified

只读。 由 Media Services 设置。		 Edm.DateTime 进行任何属性更改后，媒体服务会更新此值。 它表示自 1970 年 1 月 1 日午夜以来的毫秒数。
Name

必需。		 Edm.String 将上传到由 IngestManifest 的 BlobStorageUriForUpload 属性引用的 Blob 容器的实际文件名。 媒体服务按名称监视该容器中的文件上传。

文件名不得为空或空白。 在 IngestManifest 中唯一。 最大长度为 4000。
State

只读。 由 Media Services 设置。		 Edm.Int32 IngestManifestFile 的当前状态。 此值可以为下列值之一：

- 挂起 = 0：尚未上传文件以完成资产创建。 媒体服务正在等待文件上传。
- 已完成 = 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 是否为多文件资产中的主文件。
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

可以使用 HTTP POST 请求创建 IngestManifestFile。 必须传递一个请求正文，其中包含新 IngestManifestFile 的 Name 的名称以及 ParentIngestManifestId 和 ParentIngestManifestAssetId。

方法 请求 URI HTTP 版本
POST https://< accountname.restv2>。<location.media.azure.net/api/IngestManifestFiles> HTTP/1.1

示例请求

若要获取最新的 x-ms-version:，请参阅 媒体服务 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

可以使用 HTTP GET 请求检索 IngestManifestFile。 可以按 ID 请求 IngestManifestFile，或通过省略 ID 来请求所有 IngestManifestFile。

方法 请求 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:，请参阅 媒体服务 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

可以通过使用 HTTP DELETE 请求引用 IngestManifestFile ID 值来删除 IngestManifestFile。

方法 请求 URI HTTP 版本
DELETE https://< accountname.restv2>。<location.media.azure.net/api/IngestManifestFiles ('IngestManifestFile> Id') HTTP/1.1

示例请求

若要获取最新的 x-ms-version:，请参阅 媒体服务 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
配额和限制