导出 (0) 打印
全部展开

IngestManifest

更新时间: 2014年8月

IngestManifest 表示一组要通过批量引入创建的资产及其关联的资产文件。通过批量引入,你可以将文件上载过程与资产创建分离,以便在创建资产的过程中将高性能文件上载方法用于非常大的文件集。要创建的每个资产由清单中包含的 IngestManifestAsset 集合中的 IngestManifestAsset 表示。创建 IngestManifestAsset 及其关联的 IngestManifestFile 后,Microsoft Azure Media Services将通过 BlobStorageUriForUpload 属性监视与 IngestManifest 关联的 BLOB 存储容器。每个文件都上载到 BLOB 存储容器后,Microsoft Azure Media Services将为包含该文件的各个 IngestManifestAsset 完成一个新资产。

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

Important重要提示
使用 Media Services REST API 时,需注意以下事项:

note备注
每个与 IngestManifest 关联的 IngestManifestAssetFile 在清单中都必须具有唯一的文件名。

 

属性 类型 描述

Id

只读。由 媒体服务 在创建时设置。

Edm.String

唯一标识符。

Created

只读。由 媒体服务 在创建时设置。

Edm.DateTime

表示自 1970 年 1 月 1 日午夜以来的毫秒数。

LastModified

只读。由 媒体服务 设置。

Edm.DateTime

此值由媒体服务在做出任何属性更改后更新。它表示自 1970 年 1 月 1 日午夜以来的毫秒数。

Name

可选。

Edm.String

IngestManifest 的友好名称。

State

只读。由 媒体服务 设置。

Edm.Int32

清单的当前状态。此值可以为以下值之一:

  • Inactive = 0:没有挂起的资产创建。所有资产创建或者已完成,或者遇到错误。

  • Activating = 1:清单尚未准备好接收已上载到 BLOB 容器的文件。

  • Active = 2:有挂起的 IngestManifestAsset 创建,并且 BLOB 容器正受到监视。

BlobStorageUriForUpload

只读。由 媒体服务 设置。

Edm.String

此值由媒体服务设置。此值指定 BLOB 存储容器的 URI,该容器接收完成 IngestManifestAsset 所需的文件上载。

Statistics

只读。由 媒体服务 设置。

IngestManifestStatistics

此复杂类型包含统计信息,该信息有助于确定基于所有清单相关资产文件的 IngestManifestAsset 的当前创建进度。

IngestManifestAssets

只读。由 媒体服务 设置。

IngestManifestAsset 实体集

导航属性,可通过按 ID 值引用特定 IngestManifestAsset 进行访问。返回的实体集包含 IngestManifest 中包含的所有 IngestManifestAsset。

PendingIngestManifestAssets

只读。由 媒体服务 设置。

IngestManifestAsset 实体集

导航属性,可通过按 ID 值引用特定 IngestManifestAsset 进行访问。返回的实体集包含所有 IngestManifestAsset 挂起的文件上载或资产创建。

StorageAccountName

可选。在创建实体后无法进行更新。

Edm.String

存储帐户的名称,该帐户包含的 BLOB 容器可供文件上载。

如果未在创建时指定,媒体服务 将设置默认存储帐户名。

IngestManifestAsset.Asset 必须使用在 IngestManifest 中指定的同一存储帐户。

StorageAccount

只读。由 媒体服务 设置。

StorageAccount 实体集。

返回的实体集包含已链接到指定资产的所有 StorageAccount 实体。

可以通过使用 HTTP POST 请求并传递包含新 IngestManifest 的名称的请求正文来创建 IngestManifest。

 

方法 请求 URI HTTP 版本

POST

https://media.windows.net/API/IngestManifests

HTTP/1.1

Important重要提示
成功连接到 https://media.windows.net 后,将收到一个 301 重定向,指定另一个媒体服务 URI。你必须对这个新 URI 进行后续调用。

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.6
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=070500D0-F35C-4A5A-9249-485BBF4EC70B&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1334275521&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=GxdBb%2fmEyN7iHdNxbawawHRftLhPFFqxX1JZckuv3hY%3d
Host: media.windows.net
Content-Length: 36
Expect: 100-continue

{ "Name" : "ExampleManifestREST" }

可以使用 HTTP GET 请求检索 IngestManifest。可以按 ID 请求某引入清单,或请求所有清单。

 

方法 请求 URI HTTP 版本

GET

https://media.windows.net/API/IngestManifests

HTTP/1.1

GET

https://media.windows.net/API/IngestManifests(‘IngestManifest Id’)

HTTP/1.1

Important重要提示
成功连接到 https://media.windows.net 后,将收到一个 301 重定向,指定另一个媒体服务 URI。你必须对这个新 URI 进行后续调用。

GET https://media.windows.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.6
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=070500D0-F35C-4A5A-9249-485BBF4EC70B&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1334275521&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=GxdBb%2fmEyN7iHdNxbawawHRftLhPFFqxX1JZckuv3hY%3d
Host: media.windows.net
Content-Length: 0

可以通过使用 HTTP MERGE 请求引用 IngestManifest ID 来更新 IngestManifest。请求正文包含要更新的属性。

 

方法 请求 URI HTTP 版本

MERGE

https://media.windows.net/API/IngestManifests(‘IngestManifest Id’)

HTTP/1.1

Important重要提示
成功连接到 https://media.windows.net 后,将收到一个 301 重定向,指定另一个媒体服务 URI。你必须对这个新 URI 进行后续调用。

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.6
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=070500D0-F35C-4A5A-9249-485BBF4EC70B&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1334275521&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=GxdBb%2fmEyN7iHdNxbawawHRftLhPFFqxX1JZckuv3hY%3d
Host: media.windows.net
Content-Length: 43
Expect: 100-continue

{ "Name" : "ExampleManifestUpdated" }

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

 

方法 请求 URI HTTP 版本

DELETE

https://media.windows.net/API/IngestManifests(‘IngestManifest Id’)

HTTP/1.1

Important重要提示
成功连接到 https://media.windows.net 后,将收到一个 301 重定向,指定另一个媒体服务 URI。你必须对这个新 URI 进行后续调用。

DELETE https://media.windows.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.6
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=070500D0-F35C-4A5A-9249-485BBF4EC70B&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1334275521&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=GxdBb%2fmEyN7iHdNxbawawHRftLhPFFqxX1JZckuv3hY%3d
Host: media.windows.net
Content-Length: 0

另请参阅

Microsoft 正在进行一项网上调查,以了解您对 MSDN 网站的意见。 如果您选择参加,我们将会在您离开 MSDN 网站时向您显示该网上调查。

是否要参加?
显示:
© 2014 Microsoft