你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
IngestManifest
IngestManifest 表示一组要通过批量引入创建的资产及其关联的资产文件。 通过批量引入,可以将文件上传过程与资产创建分离。 因此,在创建资产期间,可以将高性能文件上传方法用于大型文件集。 创建 IngestManifestAssets 及其关联的 IngestManifestFiles 后,Microsoft Azure 媒体服务通过 BlobStorageUriForUpload 属性监视与 IngestManifest 关联的 Blob 存储容器。 随着每个文件上传到 Blob 存储容器完成,Microsoft Azure 媒体服务为包含该文件的相应 IngestManifestAsset 完成一个新资产。
本文概述了实体, IngestManifest
并演示如何使用媒体服务 REST API 执行各种操作。
重要
访问媒体服务中的实体时,必须在 HTTP 请求中设置特定标头字段和值。
有关详细信息,请参阅设置媒体服务 REST API 开发和使用媒体服务 REST API 连接到媒体服务。
注意
与 IngestManifest 关联的每个 IngestManifestAssetFile 在清单中必须具有唯一的文件名。
IngestManifest 实体属性
属性 | 类型 | 说明 |
---|---|---|
Id 只读。 由媒体服务在创建时设置。 |
Edm.String | 唯一标识符。 |
Created 只读。 由媒体服务在创建时设置。 |
Edm.DateTime | 表示自 1970 年 1 月 1 日午夜以来的毫秒数。 |
LastModified 只读。 由 Media Services 设置。 |
Edm.DateTime | 进行任何属性更改后,媒体服务会更新此值。 它表示自 1970 年 1 月 1 日午夜以来的毫秒数。 |
Name 可选。 |
Edm.String | IngestManifest 的友好名称。 |
State 只读。 由 Media Services 设置。 |
Edm.Int32 | 清单的当前状态。 此值可以为下列值之一: - 非活动 = 0:没有挂起的资产创建。 所有资产创建或者已完成,或者遇到错误。 - 激活 = 1:清单尚未准备好接收上传到 Blob 容器的文件。 - Active = 2:有 IngestManifestAssets 正在等待创建,并且正在监视 Blob 容器。 |
BlobStorageUriForUpload 只读。 由 Media Services 设置。 |
Edm.String | 此值由媒体服务设置。 此值指定 Blob 存储容器的 URI,该容器接收完成 IngestManifestAssets 所需的文件上传。 |
Statistics 只读。 由 Media Services 设置。 |
IngestManifestStatistics | 此复杂类型包含统计信息,该信息有助于确定基于所有清单相关资产文件的 IngestManifestAsset 的当前创建进度。 |
IngestManifestAssets 只读。 由 Media Services 设置。 |
IngestManifestAsset 实体集 | 导航属性,可通过按 ID 值引用特定 IngestManifestAsset 进行访问。 返回的实体集包含 IngestManifest 中包含的所有 IngestManifestAsset。 |
PendingIngestManifestAssets 只读。 由 Media Services 设置。 |
IngestManifestAsset 实体集 | 导航属性,可通过按 ID 值引用特定 IngestManifestAsset 进行访问。 返回的实体集包含所有 IngestManifestAsset 挂起的文件上载或资产创建。 |
StorageAccountName 可选。 在创建实体后无法进行更新。 |
Edm.String | 存储帐户的名称,该帐户包含的 BLOB 容器可供文件上载。 如果未在创建时指定,则媒体服务将设置默认存储帐户名称。 IngestManifestAsset.Asset 必须使用在 IngestManifest 中指定的同一存储帐户。 |
StorageAccount 只读。 由 Media Services 设置。 |
StorageAccount 实体集。 | 返回的实体集包含已链接到指定资产的所有 StorageAccount 实体。 |
创建 IngestManifest
可以通过使用 HTTP POST 请求并传递包含新 IngestManifest 的名称的请求正文来创建 IngestManifest。
方法 | 请求 URI | HTTP 版本 |
---|---|---|
POST | <https:// accountname.restv2>。<location.media.azure.net/api/IngestManifests> | HTTP/1.1 |
示例请求
若要获取最新的 x-ms-version:
,请参阅 媒体服务 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
可以使用 HTTP GET 请求检索 IngestManifest。 可以按 ID 请求某引入清单,或请求所有清单。
方法 | 请求 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:
,请参阅 媒体服务 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
可以通过使用 HTTP MERGE 请求引用 IngestManifest ID 来更新 IngestManifest。 请求正文包含要更新的属性。
方法 | 请求 URI | HTTP 版本 |
---|---|---|
MERGE | https://< accountname.restv2>。<location.media.azure.net/api/IngestManifests ('IngestManifest> Id') | HTTP/1.1 |
示例请求
若要获取最新的 x-ms-version:
,请参阅 媒体服务 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" }
删除引入清单
可以通过使用 HTTP DELETE 请求引用 IngestManifest ID 值来删除 IngestManifest。
方法 | 请求 URI | HTTP 版本 |
---|---|---|
DELETE | https://< accountname.restv2>。<location.media.azure.net/api/IngestManifests ('IngestManifest> Id') | HTTP/1.1 |
示例请求
若要获取最新的 x-ms-version:
,请参阅 媒体服务 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
资产
ContentKey
IngestManifestAsset
IngestManifestFile
IngestManifestStatistics
作业
作业模板
定位
MediaProcessor
任务
任务模板
配额和限制