次の方法で共有

AccessPolicy

  • [アーティクル]

AccessPolicy は、Asset へのアクセスの許可と期間を定義します。

このトピックは、AccessPolicy エンティティを概説し、また Media Services REST API でさまざまな操作を実行する方法を示します。

重要

Media Services でエンティティにアクセスするときは、HTTP 要求で特定のヘッダー フィールドと値を設定する必要があります。
詳細については、「 Media Services REST API 開発のセットアップ」および「Media Services REST APIを使用した Media Services への接続」を参照してください。

AccessPolicy エンティティ プロパティ

プロパティ Type 説明
Id

読み取り専用です。 作成時に Media Services によって設定されます。		 Edm.String 一意識別子。
Created

読み取り専用です。 作成時に Media Services によって設定されます。		 Edm.DateTime 1970 年 1 月 1 日の午前 0 時からのミリ秒数を表します。
LastModified

読み取り専用です。 Media Services で設定します。		 Edm.DateTime この値は、プロパティの変更が行われた後に Media Services によって更新されます。 1970 年 1 月 1 日の午前 0 時からのミリ秒数を表します。
Name

必須。		 Edm.String AccessPolicy の表示名。
DurationInMinutes

必須。		 Edm.Double AccessPolicy の有効期間。
Permissions

省略可能。		 Edm.Int32 この値は、Asset とやり取りする際にクライアントが持つアクセス許可を指定します。 有効な値は次のとおりです。

- なし = 0
- 読み取り = 1
- Write = 2
- Delete = 4
- List = 8

既定値は 0 です。

一覧表示アクセス許可は、OnDemandOrigin ロケーターの作成時に使用しないでください。

AccessPolicy の作成

AccessPolicy は、POST HTTP 要求を使用して作成できます。

Method 要求 URI HTTP バージョン
POST <https:// accountname.restv2>。<location.media.azure.net/api/AccessPolicies> HTTP/1.1

要求のサンプル

最新 x-ms-version:の を取得するには、「 Media Services 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 要求を使用して取得できます。

Method 要求 URI HTTP バージョン
GET <https:// accountname.restv2>。<location.media.azure.net/api/AccessPolicies> HTTP/1.1
Method 要求 URI HTTP バージョン
GET <https:// accountname.restv2>。<location.media.azure.net/api/AccessPolicies>('accesspolicyid') HTTP/1.1
Method 要求 URI HTTP バージョン
GET <https:// accountname.restv2>。<location.media.azure.net/api/Assets>('assetid')/AccessPolicies HTTP/1.1

要求のサンプル

最新 x-ms-version:の を取得するには、「 Media Services 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 要求を使用して削除できます。

Method 要求 URI HTTP バージョン
DELETE <https:// accountname.restv2>。<location.media.azure.net/api/AccessPolicies>('accesspolicyid') HTTP/1.1

要求のサンプル

最新 x-ms-version:の を取得するには、「 Media Services 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
Asset
AssetFile
ジョブ
JobTemplate
ロケーター
MediaProcessor
タスク
TaskTemplate
クォータと制限