导出 (0) 打印
全部展开

Asset

更新时间: 2014年2月

注:本页面内容可能不完全适用中国大陆地区运营的 Windows Azure服务。如要了解不同地区 Windows Azure 服务的差异, 请参考本网站.

Asset 实体包含数字文件(包括视频、音频、图像、缩略图集合、文本轨道和隐藏的解释性字幕文件)以及这些文件的相关元数据。数字文件在上载到资产中后,即可用于 Media Services 编码和流式处理工作流。

媒体服务中的资产具有以下特征:
资产是一个表示单一视听呈现的逻辑单元

资产包含由一到多个媒体文件组成的集合

资产包含的文件位于单一 BLOB 存储容器中

资产的一些示例包括:完整的电影、电视节目、特定剪辑;电影、电视节目、动画、相机 ISO 文件或事件的剪辑;电影预告片或宣传视频;广告;音频文件、广播节目、播客或声音文件。

媒体服务中的资产不具有以下特征:
只是一个存储容器

在其中组织和存储同一表示形式的多个版本的文件夹

用于向 Azure Media Encoder 提交多个视听呈现的批处理的文件夹

例如,不得将电影、电影预告片、广告以及同一电影的国际编辑版本存储在一个资产中。

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

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

资产实体属性

 

属性 类型 描述

Id

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

字符串

唯一标识符。

State

只读。由 媒体服务 设置。

Edm.Int32

描述资产状态的枚举值。有效值包括:

  • Initialized = 0

  • Published = 1

    Warning警告
    Publish 操作已弃用。请删除检查资产是否处于 Published 状态的代码。

  • Deleted = 2

在删除之前,资产始终处于初始化状态。

Crated

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

Edm.DateTime

此值由媒体服务在创建时设置。

LastModified

只读。由 媒体服务 设置。

Edm.DateTime

此值由媒体服务在做出任何属性更改后更新。

AlternateId

可选。

Edm.String

备用 ID 值,与其他内容管理系统中的 ID 对应。最大长度为 4000。

Name

可选。

Edm.String

资产的友好名称。最大长度为 4000。

Options

必需。在创建实体后无法进行更新。

Edm.Int32

一个枚举值,描述可用于创建资产的加密选项。有效值为下面的列表中的某个值,而不是此列表中值的组合:

  • None = 0:不指定任何资产创建选项。

  • StorageEncrypted = 1:指定应加密某资产的文件,以便在创建该资产时进行上载和存储。

  • CommonEncryptionProtected = 2:指定使用常用加密方法(如 PlayReady)保护资产的文件。

  • EnvelopeEncryptionProtected = 4

Uri

只读。由 媒体服务 设置。

Edm.String

指定资产的 BLOB 存储容器的 Uri。

Locators

只读。由 媒体服务 设置。

定位符实体集

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

ContentKeys

可选。

ContentKey 实体集

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

Files

只读。由 媒体服务 设置。

文件实体集

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

ParentAssets

可选。

父资产实体集

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

StorageAccountName

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

Edm.String

存储帐户的名称,该帐户包含资产的 BLOB 容器。

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

StorageAccount

只读。由 媒体服务 设置。

StorageAccount 实体集

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

创建资产

可以通过使用 POST HTTP 请求并指定属性值来创建资产。

 

方法 请求 URI HTTP 版本

POST

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

HTTP/1.1

示例请求

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

POST https://media.windows.net/API/Assets 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: 27
Expect: 100-continue

{ "Name" : "NewJSONAsset" }

列出资产

可以使用 GET HTTP 请求检索资产。

 

方法 请求 URI HTTP 版本

GET

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

HTTP/1.1

 

方法 请求 URI HTTP 版本

GET

https://media.windows.net/API/Assets('assetid')

HTTP/1.1

示例请求

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

GET https://media.windows.net/API/Assets('nb:cid:UUID:fccb8cd9-7afa-4365-a36e-d5d68409bb64') 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


更新资产

可以使用 MERGE HTTP 请求以及要更改的特定属性来更新资产。

 

方法 请求 URI HTTP 版本

MERGE

https://media.windows.net/API/Assets('assetid')

HTTP/1.1

示例请求

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

MERGE https://media.windows.net/API/Assets('nb:cid:UUID:80782407-3f87-4e60-a43e-5e4454232f60') 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=youraccountname&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1337083279&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=DMLQXWah4jO0icpfwyws5k%2b1aCDfz9KDGIGao20xk6g%3d
Host: media.windows.net
Content-Length: 21
Expect: 100-continue

{"Name" : "NewName" }

删除资产

可以通过引用资产 ID 值来删除资产。删除资产时,Microsoft Azure Media Services还会删除其所有定位符。如果资产具有源定位符,则还会撤销和删除这些定位符。将删除 ContentKey 的所有链接,并且会删除未链接到其他资产的任何 ContentKey。

 

方法 请求 URI HTTP 版本

DELETE

https://media.windows.net/API/Assets('assetid')

HTTP/1.1

示例请求

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

DELETE https://media.windows.net/API/Assets('nb:cid:UUID:fccb8cd9-7afa-4365-a36e-d5d68409bb64') 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


发布资产

note注意
Publish 操作已弃用。从最新媒体服务版本开始,不得使用 Publish

如果你的代码使用了 Publish,请注意以下事项:

  1. Publish 操作不会删除与资产关联的定位符。必须在调用 Publish 后显式删除代码中的定位符。

  2. Publish 操作不会将资产状态设置为 Published。请删除检查资产是否处于 Published 状态的代码。当前,资产只能具有 InitializedDeleted 状态。

将内容密钥链接到资产

可以通过使用 HTTP POST 请求引用资产 ID 来将 ContentKey 链接到资产。必须将 ContentKey 的 URI 包含在请求正文中。只能链接与资产的 CreationOptions 中指定的类型匹配的 ContentKey 类型。例如,如果资产具有设置为 StorageEncrypted(1) 的选项,则 ContentKey 必须为 StorageEncryption(1) 类型。

 

方法 请求 URI HTTP 版本

POST

https://media.windows.net/API/Assets(‘Asset Id')/$links/ContentKeys

HTTP/1.1

示例请求

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

POST https://media.windows.net/API/Assets('nb:cid:UUID:3ac4c50a-09c1-4ea3-b39c-c336d97f5a13')/$links/ContentKeys 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=vodbvttest01&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fnimbustestaccounts.accesscontrol.windows.net%2f&Audience=urn%3aNimbus&ExpiresOn=1352143039&Issuer=https%3a%2f%2fnimbustestaccounts.accesscontrol.windows.net%2f&HMACSHA256=sx%2bpdQNrEi8FoEVnwnIK1sXe3GWxXELEFbwKNMQ7BNM%3d
Host: media.windows.net
Content-Length: 121
Expect: 100-continue

{ "uri": "https://media.windows.net/api/ContentKeys('nb%3Akid%3AUUID%3A5db89211-c9d9-404b-a6bc-3e6b91c7a214')"}

删除 ContentKey 链接

可以通过在 HTTP DELETE 请求中引用资产 ID 和 ContentKey ID 从资产中删除 ContentKey 链接。如果 ContentKey 未链接到任何其他资产,则会将其删除。

 

方法 请求 URI HTTP 版本

DELETE

https://media.windows.net/API/Assets(‘Asset Id')/$links/ContentKeys('ContentKey Id')

HTTP/1.1

示例请求

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

DELETE https://media.windows.net/API/Assets('nb:cid:UUID:3ac4c50a-09c1-4ea3-b39c-c336d97f5a13')/$links/ContentKeys('nb:kid:UUID:5db89211-c9d9-404b-a6bc-3e6b91c7a214') 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=vodbvttest01&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fnimbustestaccounts.accesscontrol.windows.net%2f&Audience=urn%3aNimbus&ExpiresOn=1352143039&Issuer=https%3a%2f%2fnimbustestaccounts.accesscontrol.windows.net%2f&HMACSHA256=sx%2bpdQNrEi8FoEVnwnIK1sXe3GWxXELEFbwKNMQ7BNM%3d
Host: media.windows.net
Content-Length: 0

另请参见


构建日期:

2014-06-20

社区附加资源

显示:
© 2014 Microsoft