此主题尚未评级 - 评价此主题

Asset

资产是存放有关媒体的元数据的虚拟实体。资产可以包含一个或多个文件，包括视频、音频、图像、缩略图集合、文本轨道、隐藏的解释性字幕文件和富媒体播放器。资产实体定义了 Windows Azure Media Services系统中资产的抽象概念。

Media Services中的资产具有以下特征：

资产是一个表示单一视听呈现的逻辑单元

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

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

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

Media Services中的资产不具有以下特征：

只是一个存储容器

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

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

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

重要提示
访问 Media Services中的实体时，必须在 HTTP 请求中设置特定标头字段和值。有关详细信息，请参阅Setup for Media Services REST API Development。

资产实体属性
创建资产
列出资产
更新资产
删除资产
发布资产
将内容密钥链接到资产
删除 ContentKey 链接

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

资产实体属性

属性

类型

描述

字符串

Media Services设置的唯一标识符。

State

Edm.Int32

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

Initialized = 0
Published = 1

警告
Publish 操作已弃用。从最新Media Services版本开始，你应删除检查资产是否处于 Published 状态的代码。
Deleted = 2

Created

Edm.DateTime

此值由Media Services在创建时设置。

LastModified

Edm.DateTime

此值由Media Services在做出任何属性更改后更新。

AlternateId

Edm.String

可选。备用 ID 值，与其他内容管理系统中的 ID 对应。

Name

Edm.String

可选。资产的友好名称。

Options

Edm.Int32

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

None = 0：不指定任何资产创建选项。
StorageEncrypted = 1：指定应加密某资产的文件，以便在创建该资产时进行上载和存储。
CommonEncryptionProtected = 2：指定使用常用加密方法（如 PlayReady）保护资产的文件。

定位符

定位符实体集

导航属性，可通过按 ID 值引用特定资产进行访问。返回的实体集包含已链接到指定资产的所有定位符实体。

ContentKeys

ContentKey 实体集

导航属性，可通过按 ID 值引用特定资产进行访问。返回的实体集包含已链接到指定资产的所有 ContentKey 实体。

Files

文件实体集

导航属性，可通过按 ID 值引用特定资产进行访问。返回的实体集包含已链接到指定资产的所有文件实体。

ParentAssets

ParentAsset 实体集

导航属性，可通过按 ID 值引用特定资产进行访问。返回的实体集包含已链接到指定资产的所有 ParentAsset 实体。

创建资产

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

方法	请求 URI	HTTP 版本
POST	https://media.windows.net/API/Assets	HTTP/1.1

示例请求

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.0
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

示例请求

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.0
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

示例请求

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.0
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 值来删除资产。删除资产时，Windows Azure Media Services还会删除其所有定位符。如果资产具有源定位符，则还会撤销和删除这些定位符。将删除 ContentKey 的所有链接，并且会删除未链接到其他资产的任何 ContentKey。

方法	请求 URI	HTTP 版本
DELETE	https://media.windows.net/API/Assets('assetid')	HTTP/1.1

示例请求

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.0
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

发布资产

注意
Publish 操作已弃用。从最新Media Services版本开始，不得使用 Publish。如果你的代码使用了 Publish，请注意以下事项： Publish 操作不会删除与资产关联的定位符。必须在调用 Publish 后显式删除代码中的定位符。 Publish 操作不会将资产状态设置为 Published。请删除检查资产是否处于 Published 状态的代码。当前，资产只能具有 Initialized 或 Deleted 状态。

注意

Publish 操作已弃用。从最新Media Services版本开始，不得使用 Publish。

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

Publish 操作不会删除与资产关联的定位符。必须在调用 Publish 后显式删除代码中的定位符。
Publish 操作不会将资产状态设置为 Published。请删除检查资产是否处于 Published 状态的代码。当前，资产只能具有 Initialized 或 Deleted 状态。

将内容密钥链接到资产

可以通过使用 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

示例请求

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.0
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

示例请求

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.0
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

另请参见

概念

AccessPolicy
ContentKey
AssetFile
作业
作业模板
Locator
MediaProcessor
任务
TaskTemplates

其他资源

Ingest Assets with the Media Services REST API
Media Services Considerations

生成日期：

2013-06-12

本文是否对您有所帮助？是否

不准确

深度不够

需要更多代码示例

翻译需要改进

(1500 个剩余字符)

社区附加资源

添加