导出 (0) 打印
全部展开

IngestManifestFile

更新时间: 2014年8月

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

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

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

 

属性 类型 描述

Id

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

Edm.String

唯一标识符。

Created

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

Edm.DateTime

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

LastModified

只读。由 媒体服务 设置。

Edm.DateTime

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

Name

必需。

Edm.String

具体文件名,该文件名将上载到由 IngestManifest 的 BlobStorageUriForUpload 属性引用的 BLOB 容器。媒体服务将按名称监视该容器中的文件上载。

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

State

只读。由 媒体服务 设置。

Edm.Int32

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

  • Pending = 0:尚未上载文件以完成资产创建。媒体服务正等待文件上载。

  • Finished = 1:已检测到文件上载并且已更新关联资产。

  • Error = 2:处理此文件时出错。有关错误信息,请参阅 ErrorDetails 属性。

ParentIngestManifestId

必需。

Edm.String

包含此文件的清单的 IngestManifest ID。

ParentIngestManifestAssetId

必需。

Edm.String

此文件关联的 IngestManifestAsset 的 IngestManifestAsset ID。

ErrorDetail

只读。由 媒体服务 设置。

Edm.String

处理此文件时出现的错误的详细信息。

MimeType

可选。

Edm.String

媒体服务不检查你上载的任何 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

用于存储加密的初始化向量。

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

 

方法 请求 URI HTTP 版本

POST

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

HTTP/1.1

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

POST https://media.windows.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.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: 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" }

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

 

方法 请求 URI HTTP 版本

GET

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

HTTP/1.1

GET

https://media.windows.net/API/IngestManifestFiles(‘IngestManifestFile Id’)

HTTP/1.1

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

GET https://media.windows.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.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

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

 

方法 请求 URI HTTP 版本

DELETE

https://media.windows.net/API/IngestManifestFiles(‘IngestManifestFile Id’)

HTTP/1.1

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

DELETE https://media.windows.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.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

另请参阅

显示:
© 2014 Microsoft