共用方式為

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 此值指定用戶端與資產互動時擁有的存取權限。 有效值為：

- 無 = 0
- 讀取 = 1
- 寫入 = 2
- 刪除 = 4
- 清單 = 8

預設值為 0。

請注意清單權限在建立 OnDemandOrigin 定位器時不應該使用。

建立 AccessPolicy

AccessPolicy 可以使用 POST HTTP 要求來建立。

方法 要求 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

AccessPolicy 可以使用 GET HTTP 要求來擷取。

方法 要求 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

AccessPolicy 可以使用 DELETE HTTP 要求來刪除。

方法 要求 URI HTTP 版本
刪除 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
工作 (Job)
JobTemplate
定位
MediaProcessor
Task
TaskTemplate
配額和限制