ApsaraVideo VOD:概要

仕組み

マルチアプリケーションアーキテクチャは、ApsaraVideo VOD のメタデータにアプリケーション ID (AppId) を追加することで、論理的分離を実現します。動画のアップロードや再生 URL の取得などの API リクエストを行う際に、システムは指定された AppId パラメーターを使用して、操作を指定されたアプリケーションに制限します。

主要概念

• アプリケーション (App)：メディアリソース、設定、権限を分離するための独立した論理スペースです。各アプリケーションには一意の AppId があります。

• デフォルトアプリケーション (システムアプリケーション)：マルチアプリケーションシステムを有効にすると、システムは自動的に ID が app-1000000 のデフォルトアプリケーションを作成します。アカウント配下にあるすべての履歴データは、自動的にこのアプリケーションに割り当てられます。API を呼び出すときに AppId を指定しない場合、操作はデフォルトでこのアプリケーションを対象とします。

• カスタムアプリケーション：新しいサービスや環境を分離するために作成する、app-xxxxxxx のようなアプリケーションです。

シナリオ

• 複数環境の分離：

  テスト環境と本番環境では、動画や画像などのリソース、設定、データを分離する必要があります。たとえば、異なるコールバック URL 設定を分離する必要があります。マルチアプリケーションサービスを使用して、環境ごとにアプリケーションを作成します。これらのアプリケーションに異なる RAM ユーザーを関連付け、RAM ユーザーに権限を付与します。これにより、テスト中または開発中のアプリケーションが本番アプリケーションに影響を与えるのを防ぐことができます。

• 複数事業ラインの分離：

  ビジネスに複数の事業ラインや、ApsaraVideo VOD を使用する必要がある複数の部門がある場合、マルチアプリケーションサービスを使用して、各事業ラインまたは部門ごとにアプリケーションを作成し、分離します。

• 複数チャネルの分離：

  ApsaraVideo VOD の機能に基づいて、複数のチャネルやユーザー向けのプラットフォームサービスを構築したい場合は、マルチアプリケーションサービスを使用します。

有効化と設定

この機能を使用する前に、チケットを送信して有効化する必要があります。有効化後、システムは自動的にデフォルトアプリケーションを作成し、履歴データをそれに割り当てます。

1. チケットを送信して機能を有効化します。

   1. チケットを送信し、申請情報に「マルチアプリケーションサービスを有効化することによる影響を理解し、同意の上、有効化を申請します」と記載します。また、Alibaba Cloud アカウント UID も提供してください。

   2. ApsaraVideo VODコンソールに移動します。左側メニューで、概要 ページに移動します。

   3. 概要 ページの右上隅にある [マルチアプリケーションの有効化] モジュールで、[開始] ボタンをクリックして、マルチアプリケーション機能を有効化します。有効化後、このモジュールは [概要] ページに表示されなくなります。

2. アプリケーションを作成します。

   1. ApsaraVideo VODコンソールに移動します。左側メニューで、[アプリケーション管理] をクリックします。

   2. [アプリケーション管理] ページで、[アプリケーションの作成] をクリックします。アプリケーション名と説明を入力し、OK をクリックします。作成後、アプリケーションの編集、削除、またはアプリケーションへのアクセスができます。

   3. アプリケーション名、または [操作] 列の 操作 ボタンをクリックしてアプリケーションにアクセスします。メディアアセット管理、メディア処理、動画配信をサポートしています。

      説明

      アプリケーション ID のリストは、ListAppInfo API を呼び出して取得できます。

3. アイデンティティエンティティに権限を付与します。

   AttachAppPolicyToIdentity - アプリケーションレベルのアクセスポリシーをアイデンティティにアタッチ API を呼び出して、RAM ユーザーまたは RAM ロールに特定のアプリケーションへのアクセス権限を付与します。ApsaraVideo VOD は、3 つのアプリケーションレベルのアクセスポリシーを提供します。

   ポリシー名	権限付与範囲	操作権限
   VODAppAdministratorAccess	すべてのアプリケーション	Alibaba Cloud アカウント配下にあるすべてのアプリケーションと、アプリケーション内のすべてのリソースを管理する権限
   VODAppFullAccess	単一のアプリケーション	指定されたアプリケーション内のすべてのリソースを管理する権限
   VODAppReadOnlyAccess	単一のアプリケーション	指定されたアプリケーション内のすべてのリソースへの読み取り専用アクセス (Get、Describe、Search、または List で始まる操作を呼び出してリソースを管理するなど)

4. アプリケーションを管理します。

   マルチアプリケーションシステムの API を使用して、アプリケーションの作成、クエリ、更新、削除ができます。コンソールは、将来的には追加のマルチアプリケーション管理機能をサポートする予定です。

マルチアプリケーションサービスの使用

マルチアプリケーション機能をサポートするサービスは、AppId パラメーターをサポートします。リソースの作成や新しい設定を行う際にこのパラメーターを指定できます。データをクエリする際には、権限のあるアプリケーション内のリソースのみが返されます。変更または削除する際には、関連する権限がチェックされます。

現在、メッセージコールバックとメディアアセットサービス (アップロード、再生、メディアアセット管理) のみがマルチアプリケーション機能をサポートしています。

• メッセージコールバック

  各アプリケーションに一意のメッセージコールバックメソッドとアドレスを設定でき、API (イベント通知の設定) と組み合わせて使用します。

  • AppId を指定して、そのアプリケーションのメッセージコールバックを設定します。

  • 指定しない場合、システムはデフォルトアプリケーションを使用します。

  設定が完了すると、異なるアプリケーションで動画や画像をアップロードした際に生成されるイベント通知に対し、各アプリケーションの設定に基づいてコールバックが実行されます。また、イベント通知設定のクエリ API を使用して関連設定をクエリすることもできます。

• メディアアセットサービス

  • メディアアップロード：アップロード関連の操作 (動画アップロード URL と資格情報の取得、画像アップロード URL と資格情報の取得など) は、AppId の指定をサポートします。操作元のエンティティはアプリケーションに対する権限を持っている必要があります。さもなければ、アップロードは失敗します。アプリケーション ID を指定しない場合、コンテンツはシステムのデフォルトアプリケーションにアップロードされます。

  • 音声・動画再生：権限のあるアプリケーションからのみ再生情報 (再生資格情報や再生 URL など) を取得できます。

  • 変更と削除：メディアアセットの変更および削除操作は、権限を持つアプリケーション内のリソースに対してのみ実行できます。

  • メディアアセットのクエリ：メディアアセット詳細のクエリ操作では、権限を持つアプリケーションのメディアアセット情報のみを取得できます。バッチクエリの場合、権限のあるメディアアセットデータのみが返されます。権限のない MediaId 値は NonExistMediaIds に格納されます (フィールド名は若干異なる場合があります)。

  • メディアアセットの検索：検索時には、権限を持つアプリケーションのメディアアセットデータのみが返されます。検索条件に 1 つ以上の AppId 値を指定できます。

制限事項

• マルチアプリケーションサービスは、中国 (上海)、中国 (北京)、中国 (深圳)、シンガポール、ドイツ (フランクフルト)、米国 (シリコンバレー)、Japan (Tokyo)、インドネシア (ジャカルタ)、および SAU (リヤド - パートナーリージョン) のリージョンをサポートしています。

• 1 つのアカウントにつき最大 10 個のアプリケーションを作成できます。さらに必要な場合は、チケットを送信してください。

• メディアアップロード、音声・動画再生、メディアアセット管理、およびメッセージコールバックのみがマルチアプリケーション分離をサポートしています。

課金

現在、すべてのアプリケーションのリソース消費 (ストレージ、トラフィック、トランスコーディングなど) はアカウントレベルで課金されます。アプリケーションレベルでの独立した課金と請求書の生成はまだサポートされていません。

よくある質問

有効化は既存のビジネスに影響しますか？

いいえ。すべての履歴データは自動的にデフォルトアプリケーションに割り当てられます。既存の API 呼び出しとビジネスロジックは、変更することなく正常に機能し続けます。

履歴ビデオを新しく作成したアプリケーションに移行するにはどうすればよいですか？

Migrate Resources to a New Application API を使用して移行を実行できます。この API は単一またはバッチでの移行をサポートしており、移行中に動画の VideoId と再生 URL は変更されず、オンラインサービスに影響を与えません。

コンソールのナビゲーション権限