このページは役に立ちましたか。
このページのコンテンツについての ご意見をお待ちしております
その他にご意見はありますか。
残り 1500 文字
エクスポート (0) 印刷
すべて展開

資産

更新日: 2015年6月

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

アセットをエンコードすると、エンコード ジョブの完了時に出力アセットが作成されます。先に説明したファイルでは、出力アセットには入力アセットと出力アセットを示す XML メタデータ ファイルが含まれます。詳細については、「入力メタデータ」および「出力メタデータ」を参照してください。

Media Services のアセットには次の特徴があります。
アセットは、1 つのオーディオビジュアル表現を表す論理単位です。

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

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

アセットの例には、完全なムービー、TV ショー、特定の編集、ムービーからのクリップ、アニメーション、カメラの ISO ファイル、イベント (映画の予告編やプロモーション ビデオ、広告、オーディオ ファイル、ラジオ ショー、ポッドキャスト、サウンド ファイルなど) があります。

Media Services のアセットには次の特徴は当てはまりません。
単純なストレージ コンテナー

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

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

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

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

Important重要
Media Services REST API を使用する場合、次の点に注意してください。

  • Media Services でエンティティにアクセスする場合、HTTP 要求に固有のヘッダー フィールドと値を設定する必要があります。詳細については、「Setup for Media Services REST API Development」を参照してください。

  • https://media.windows.net への接続に成功すると、別の Media Services URI を指定する 301 リダイレクトを受け取ります。続いて、新しい URI への呼び出しを行う必要があります。

    詳細については、「Connecting to Media Services with the Media Services REST API」を参照してください。

 

プロパティ 説明

Id

読み取り専用です。作成時の Media Services によって設定されます。

文字列

一意の ID。

State

読み取り専用です。Media Services によって設定されます。

Edm.Int32

アセットの状態を示す列挙値。値:

  • 初期化 = 0

  • パブリッシュ = 1

    Warning警告
    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

アセットのフレンドリ名。最大長は 4000 です。

Options

必須。エンティティが作成された後に更新することはできません。

Edm.Int32

アセットを作成できる暗号化オプションを示す列挙値。有効な値は、この一覧からの値の組み合わせではなく、後の一覧からの 1 つの値です。

  • None = 0:アセットの作成オプションを指定しません。

  • StorageEncrypted = 1:アセットの作成時に、アップロードおよび格納のためにアセットのファイルを暗号化する必要があることを指定します。

  • CommonEncryptionProtected = 2:一般的な暗号化方法 (PlayReady など) を使用してアセットのファイルを保護することを指定します。

  • EnvelopeEncryptionProtected = 4

Uri

読み取り専用です。Media Services によって設定されます。

Edm.String

指定されたアセットの 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 エンティティ セット

返されるエンティティ セットには、資産に関連付けられている配信ポリシーが含まれます。

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

 

メソッド 要求 URI HTTP バージョン

POST

https://media.windows.net/API/Assets

HTTP/1.1

Important重要
https://media.windows.net への接続に成功すると、別の Media Services URI を指定する 301 リダイレクトを受け取ります。続いて、新しい URI への呼び出しを行う必要があります。

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

Important重要
https://media.windows.net への接続に成功すると、別の Media Services URI を指定する 301 リダイレクトを受け取ります。続いて、新しい URI への呼び出しを行う必要があります。

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

Important重要
https://media.windows.net への接続に成功すると、別の Media Services URI を指定する 301 リダイレクトを受け取ります。続いて、新しい URI への呼び出しを行う必要があります。

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.9
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" }

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

 

メソッド 要求 URI HTTP バージョン

削除

https://media.windows.net/API/Assets('assetid')

HTTP/1.1

Important重要
https://media.windows.net への接続に成功すると、別の Media Services URI を指定する 301 リダイレクトを受け取ります。続いて、新しい URI への呼び出しを行う必要があります。

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


noteメモ
Publish アクションは廃止されました。Media Services リリース以降は、Publish は使用しないでください。

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

  1. Publish アクションによって、アセットに関連付けられたロケーターは削除されません。Publish を呼び出した後は、コードで明示的にロケーターを削除する必要があります。

  2. Publish アクションによって、アセットの状態は Published に設定されません。アセットが Published 状態かどうかを確認するコードを削除します。現在、アセットの可能な状態は Initialized または Deleted のみです。

アセット ID を HTTP POST 要求で参照することにより、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

Important重要
https://media.windows.net への接続に成功すると、別の Media Services URI を指定する 301 リダイレクトを受け取ります。続いて、新しい URI への呼び出しを行う必要があります。

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.9
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 は、他のアセットにリンクされていない場合、削除されます。

 

メソッド 要求 URI HTTP バージョン

削除

https://media.windows.net/API/Assets('Asset Id')/$links/ContentKeys('ContentKey Id')

HTTP/1.1

Important重要
https://media.windows.net への接続に成功すると、別の Media Services URI を指定する 301 リダイレクトを受け取ります。続いて、新しい URI への呼び出しを行う必要があります。

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

関連項目

表示:
© 2015 Microsoft