Share via

Asset

  • [アーティクル]

Asset エンティティには、デジタル ファイル (ビデオ、オーディオ、画像、サムネイルのコレクション、テキスト トラック、クローズド キャプション ファイルなど) およびそれらのファイルに関するメタデータが含まれます。 デジタル ファイルがアセットにアップロードされた後は、Media Services エンコードおよびストリーミング ワークフローで使用できます。

資産をエンコードすると、エンコード ジョブの完了時に出力資産が生成されます。 上記のファイルの中で、出力資産には、入力資産と出力資産を記述する XML メタデータ ファイルが含まれています。 詳細については、「入力メタデータ」および「出力メタデータ」をご覧ください。

Media Services の資産には、次の特性が適用されます。

  • アセットは、1 つのオーディオビジュアル表現を表す論理単位です。

  • アセットには、1 つまたは複数のメディア ファイルのコレクションが含まれます。

  • アセットのファイルは、1 つの BLOB ストレージ コンテナーにあります。

アセットの例としては、フルムービー、テレビ番組、特定の編集があります。映画、テレビ番組、アニメーション、カメラ ISO ファイル、またはイベントからのクリップ。映画の予告編またはプロモーションビデオ。広告;オーディオ ファイル、ラジオ ショー、ポッドキャスト、またはサウンド ファイル。

次の特性は、Media Services の資産には適用されません。

  • 単純なストレージ コンテナー

  • 同じ表現の複数のバージョンを整理し、保管するフォルダー

  • 複数のオーディオビジュアル表現のバッチ処理を Azure Media エンコーダーに送信するためのフォルダー

たとえば、映画とその予告編、広告、同じ映画の海外版を 1 つのアセットに保管することはできません。

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

重要

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

Asset エンティティのプロパティ

プロパティ Type 説明
Id

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

読み取り専用です。 Media Services で設定します。		 Edm.Int32 アセットの状態を示す列挙値。 値:

- 初期化 = 0
- 発行済み = 1 警告: アクションは Publish 非推奨になりました。 アセットが Published 状態かどうかを確認するコードを削除します。
- 削除済み = 2

アセットは、削除されるまで常に初期化状態になります。
Created

読み取り専用です。 作成時に Media Services によって設定されます。		 Edm.DateTime この値は、作成時に Media Services によって設定されます。
LastModified

読み取り専用です。 Media Services で設定します。		 Edm.DateTime この値は、プロパティの変更が行われた後に Media Services によって更新されます。
AlternateId

省略可能。		 Edm.String 別のコンテンツ管理システムの ID に対応する別の ID 値。 最大長は 4000 です。
Name

省略可能。		 Edm.String アセットのフレンドリ名。 最大長は 512 です。
Options

必須。 エンティティが作成された後に更新することはできません。		 Edm.Int32 アセットを作成できる暗号化オプションを示す列挙値。 有効な値は、この一覧からの値の組み合わせではなく、後の一覧からの 1 つの値です。

- None = 0: アセット作成オプションを指定しません。
- StorageEncrypted = 1: 資産の作成時に、アップロードとストレージのために資産のファイルを暗号化する必要があることを指定します。
- CommonEncryptionProtected = 2: 資産のファイルが共通の暗号化方法 (PlayReady など) を使用して保護されることを指定します。
- EnvelopeEncryptionProtected = 4
Uri

読み取り専用です。 Media Services で設定します。		 Edm.String 指定した Asset の BLOB ストレージ コンテナーの URI。
Locators

読み取り専用です。 Media Services で設定します。		 ロケーター エンティティ セット 返されるエンティティ セットには、指定されたアセットにリンクされたすべてのロケーター エンティティが含まれます。
ContentKeys

省略可能。		 ContentKey エンティティ セット 返されるエンティティ セットには、指定されたアセットにリンクされたすべての ContentKey エンティティが含まれます。
Files

読み取り専用です。 Media Services で設定します。		 File エンティティ セット 返されるエンティティ セットには、指定されたアセットにリンクされたすべての File エンティティが含まれます。
ParentAssets

省略可能。		 親 Asset エンティティ セット 返されるエンティティ セットには、指定されたアセットにリンクされたすべての親 Asset エンティティが含まれます。
StorageAccountName

省略可能。 エンティティが作成された後に更新することはできません。		 Edm.String アセットの BLOB コンテナーを含むストレージ アカウントの名前。

作成時に指定しない場合、Media Services は既定のストレージ アカウント名を設定します。
StorageAccount

読み取り専用です。 Media Services で設定します。		 StorageAccount エンティティ セット 返されるエンティティ セットには、指定されたアセットにリンクされたすべての StorageAccount エンティティが含まれます。
DeliveryPolicies AssetDeliveryPolicy エンティティ セット 返されるエンティティ セットには、資産に関連付けられている配信ポリシーが含まれます。
FormatOption Edm.Int32 アセットを作成できるさまざまな形式オプションを指定します。 使用できる値は 0 (既定値) です。資産形式オプションは指定しません。1 - 資産の形式が AdaptiveStreaming であることを指定します。

アセットを作成する

アセットは、POST HTTP 要求を使用し、プロパティ値を指定して作成できます。

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

要求のサンプル

最新 x-ms-version:の を取得するには、「 Media Services REST」を参照してください。

POST https://<accountname>.restv2.<location>.media.azure.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.19  
Authorization:  Bearer <token value>  
Host: media.windows.net  
Content-Length: 27  
Expect: 100-continue  
  
{ "Name" : "NewJSONAsset" }

アセットの一覧表示

アセットは、GET HTTP 要求を使用して取得できます。

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

要求のサンプル

最新 x-ms-version:の を取得するには、「 Media Services REST」を参照してください。

GET https://<accountname>.restv2.<location>.media.azure.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.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 0

アセットの更新

アセットは、MERGE HTTP 要求、および変更する特定のプロパティを使用して更新できます。

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

要求のサンプル

最新 x-ms-version:の を取得するには、「 Media Services REST」を参照してください。

MERGE https://<accountname>.restv2.<location>.media.azure.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.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 21  
Expect: 100-continue  
  
{"Name" : "NewName" }

アセットを削除する

アセットは Asset ID 値を参照して削除できます。 アセットが削除されると、そのすべてのロケーターがMicrosoft Azure Media Servicesによって削除されます。 アセットに配信元ロケーターがある場合、これらのロケーターも取り消され、削除されます。 ContentKey へのすべてのリンクは削除され、他のアセットにリンクされていない ContentKey は削除されます。

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

要求のサンプル

最新 x-ms-version:の を取得するには、「 Media Services REST」を参照してください。

DELETE https://<accountname>.restv2.<location>.media.azure.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.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 0

アセットのパブリッシュ

注意

Publish アクションは非推奨とされました。 最新の Media Services リリース以降では、 Publish を使用しないでください。

コードで Publish を使用する場合は、次の注意事項に留意してください。

  1. Publish アクションによって、アセットに関連付けられたロケーターは削除されません。 Publish を呼び出した後は、コードで明示的にロケーターを削除する必要があります。
  2. Publish アクションによって、アセットの状態は Published に設定されません。 アセットが Published 状態かどうかを確認するコードを削除します。 現在、アセットの可能な状態は Initialized または Deleted のみです。

コンテンツ キーのアセットへのリンク

ContentKey を資産にリンクするには、HTTP POST 要求を使用して資産 ID を参照します。 ContentKey の URI は要求の本文に含める必要があります。 アセットの CreationOptions に指定された型に一致する ContentKey 型のみをリンクできます。 たとえば、アセットのオプションが StorageEncrypted(1) に設定されている場合、ContentKey は StorageEncryption(1) 型である必要があります。

Method 要求 URI HTTP バージョン
POST <https:// accountname.restv2>。<location.media.azure.net/api/Assets>('Asset Id')/$links/ContentKeys HTTP/1.1

要求のサンプル

最新 x-ms-version:の を取得するには、「 Media Services REST」を参照してください。

POST https://<accountname>.restv2.<location>.media.azure.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.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 121  
Expect: 100-continue  
  
{ "uri": "https://&lt;accountname&gt;.restv2.&lt;location&gt;.media.azure.net/api/ContentKeys('nb%3Akid%3AUUID%3A5db89211-c9d9-404b-a6bc-3e6b91c7a214')"}

アセットから ContentKey リンクを削除するには、HTTP DELETE 要求でアセット ID と ContentKey ID を参照します。 ContentKey は、他のアセットにリンクされていない場合、削除されます。

Method 要求 URI HTTP バージョン
DELETE <https:// accountname.restv2>。<location.media.azure.net/api/Assets>('Asset Id')/$links/ContentKeys('ContentKey Id') HTTP/1.1

要求のサンプル

最新 x-ms-version:の を取得するには、「 Media Services REST」を参照してください。

DELETE https://<accountname>.restv2.<location>.media.azure.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.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 0

参照

AccessPolicy
ContentKey
AssetFile
ジョブ
JobTemplate
ロケーター
MediaProcessor
タスク
TaskTemplate
Media Services REST API による資産の取り込み
クォータと制限