你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

AccessPolicy

  • 项目

AccessPolicy 定义资产的访问权限和持续时间。

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

重要

访问媒体服务中的实体时，必须在 HTTP 请求中设置特定标头字段和值。
有关详细信息，请参阅设置媒体服务 REST API 开发和使用媒体服务 REST API 连接到媒体服务。

AccessPolicy 实体属性

属性 类型 说明
Id

只读。 由媒体服务在创建时设置。		 Edm.String 唯一标识符。
Created

只读。 由媒体服务在创建时设置。		 Edm.DateTime 表示自 1970 年 1 月 1 日午夜以来的毫秒数。
LastModified

只读。 由 Media Services 设置。		 Edm.DateTime 进行任何属性更改后，媒体服务会更新此值。 它表示自 1970 年 1 月 1 日午夜以来的毫秒数。
Name

必需。		 Edm.String AccessPolicy 的友好名称。
DurationInMinutes

必需。		 Edm.Double AccessPolicy 处于有效状态的持续时间。
Permissions

可选。		 Edm.Int32 此值指定客户端与资产交互时具有的访问权限。 有效值为：

- None = 0
- 读取 = 1
- 写入 = 2
- Delete = 4
- List = 8

默认值为 0。

请注意，创建 OnDemandOrigin 定位符时不应使用列表权限。

创建 AccessPolicy

可以使用 POST HTTP 请求创建 AccessPolicy。

方法 请求 URI HTTP 版本
POST <https:// accountname.restv2>。<location.media.azure.net/api/AccessPolicies> HTTP/1.1

示例请求

若要获取最新的 x-ms-version:，请参阅 媒体服务 REST。

POST https://<accountname>.restv2.<location>.media.azure.net/api/AccessPolicies 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: 67  
Expect: 100-continue  
  
{"Name": "NewUploadPolicy", "DurationInMinutes" : "100", "Permissions" : 2 }

列出 AccessPolicy

可以使用 GET HTTP 请求检索 AccessPolicy。

方法 请求 URI HTTP 版本
GET <https:// accountname.restv2>。<location.media.azure.net/api/AccessPolicies> HTTP/1.1
方法 请求 URI HTTP 版本
GET <https:// accountname.restv2>。<location.media.azure.net/api/AccessPolicies ('accesspolicyid>') HTTP/1.1
方法 请求 URI HTTP 版本
GET <https:// accountname.restv2>。<location.media.azure.net/api/Assets ('assetid>') /AccessPolicies HTTP/1.1

示例请求

若要获取最新的 x-ms-version:，请参阅 媒体服务 REST。

GET https://<accountname>.restv2.<location>.media.azure.net/api/AccessPolicies('nb:pid:UUID:ad05d8fa-06a2-4e2f-8fb4-fac57875135a') 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>

删除 AccessPolicy

可以使用 DELETE HTTP 请求删除 AccessPolicy。

方法 请求 URI HTTP 版本
DELETE <https:// accountname.restv2>。<location.media.azure.net/api/AccessPolicies ('accesspolicyid>') HTTP/1.1

示例请求

若要获取最新的 x-ms-version:，请参阅 媒体服务 REST。

DELETE https://<accountname>.restv2.<location>.media.azure.net/api/AccessPolicies('nb:pid:UUID:ad05d8fa-06a2-4e2f-8fb4-fac57875135a') 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

另请参阅

ContentKey
资产
AssetFile
作业
作业模板
定位
MediaProcessor
任务
任务模板
配额和限制