マルチアプリケーションサービスを使用する前に、ApsaraVideo VODを有効化する必要があります。 このトピックでは、マルチアプリケーションサービスを使用するための手順、注意事項、およびFAQについて説明します。

すでにApsaraVideo VODを有効化している場合は、次の手順を実行してマルチアプリケーションサービスを使用できます。

  1. Apply for activation
  2. アプリケーションの作成
  3. IDエンティティに権限を付与する
  4. メディアのアップロード
  5. 各アプリケーションのメディアを個別に管理する

Or

  1. アクティベーションの申請
  2. アプリケーションの作成
  3. IDエンティティに権限を付与する
  4. Configure callbacks
  5. 各アプリケーションのコールバックを個別に設定する

アクティベーションの申請

  • 前提条件

    The multi-application service is currently in public preview and not available in the ApsaraVideo VOD console. マルチアプリケーションサービスの有効化を申請する前に、次の要件が満たされていることを確認してください。

    過去7日間の加速トラフィックのピーク帯域幅は500 Mbit/s以上です。 ピーク帯域幅を表示するには、ApsaraVideo VODコンソールのリソース消費量ページを参照してください。

  • 影響
    • デフォルトのアプリケーションを無効にすることはできません。 そうしないと、通常のオンラインサービスが影響を受ける可能性があります。
    • ApsaraVideo VODコンソールでは、デフォルトのアプリケーション以外のアプリケーションのリソースを管理または照会することはできません。 そのようなリソースは、メディア資産、レビュー、およびメディア処理構成を含む。
    • 新しいアプリケーションでは、API操作を呼び出して、トランスコーディングとコールバックを再設定する必要があります。
    注
    • コールバック機能をテストする場合は、メディアファイルをアップロードするときに、異なる環境でコールバックURLを指定できます。
    • メディアファイルを分離する場合は、メディアカテゴリモジュールを使用できます。
  • 有効化する方法

    マルチアプリケーションサービスを有効化するための要件を満たし、前述の影響を受け入れる場合は、リクエストページに移動し、チケットを起票してサービスを有効化します。

    重要 このチケットでは、Alibaba CloudアカウントのUIDを指定し、マルチアプリケーションサービスのアクティブ化を申請する際の影響を認めて受け入れることを宣言する必要があります。

アプリケーションの作成

CreateAppInfo操作を呼び出して、アプリケーションを作成できます。 1つのアカウントで最大10個のアプリケーションを作成できます。 アプリケーション名は一意である必要があります。

注 初めてアプリケーションを作成するときは、Alibaba CloudアカウントのAccessKeyペアを使用してアプリケーションを作成する必要があります。 後で、RAMユーザーにアプリケーションを管理する管理者権限を付与できます。

IDエンティティに権限を付与する

IDエンティティがアプリケーションのリソースを管理する前に、AttachAppPolicyToIdentity操作を呼び出して、IDエンティティ (RAMユーザーまたはロール) に権限を付与できます。 ポリシーの詳細については、「概要」の「ポリシー」セクションをご参照ください。

Use the multi-application service

AppIdパラメーターは、マルチアプリケーションサービスをサポートするサービスに追加されます。 このパラメーターは、リソースの作成時や設定時に指定できます。 データをクエリすると、アクセスを許可されているアプリケーション内のリソースのみが返されます。 When you modify or delete data, permissions must be verified before you can proceed.

マルチアプリケーションサービスをサポートするのは、コールバックとメディアサービス (メディアアップロード、再生、メディア管理を含む) のみです。 他のサービスからのサポートはまもなく利用可能になります。

  • コールバック

    アプリケーションごとに個別のコールバック方法とURLを設定できます。 AppIdパラメーターは、次の操作で使用できます。

    SetMessageCallback: AppIdパラメーターが指定されている場合、アプリケーションのコールバックを設定できます。 AppIdパラメーターが指定されていない場合、システムのデフォルトアプリケーションが使用されます。

    設定が完了すると、設定に基づいて異なるアプリケーションでビデオと画像のアップロードのイベント通知のコールバックが実行されます。 GetMessageCallback操作を呼び出して、関連する設定を照会することもできます。

    注 マルチアプリケーションサービスを有効化した後、ApsaraVideo VODコンソールでデフォルトアプリケーションのコールバック設定のみを管理できます。 ApsaraVideo VODコンソールは、他のアプリケーションの管理をサポートするようにアップグレードされます。
  • メディアサービス
    • Media upload: CreateUploadVideoやCreateUploadImageなどのアップロード操作でAppIdパラメーターを指定して、メディアファイルを指定したアプリケーションにアップロードできます。 指定したアプリケーションに対する権限がない場合、アップロードは失敗します。 AppIdパラメーターを指定しない場合、メディアファイルはシステムのデフォルトアプリケーションにアップロードされます。
    • オーディオおよびビデオの再生: 再生資格情報やURLなどの再生情報は、アクセスが許可されているアプリケーションからのみ取得できます。
    • メディアの変更と削除: アクセスが許可されているアプリケーションでのみ、メディアリソースを変更および削除できます。
    • メディアクエリ: API操作を呼び出してメディアリソースの詳細をクエリする場合、アクセスが許可されているアプリケーションでのみメディアリソースに関する情報を取得できます。 バッチクエリは、アクセスを許可されているアプリケーションでのみメディアリソースのデータを返します。 アクセスを許可されていないアプリケーションのメディアリソースのID (MediaId) は、NonExistMediaIdsフィールドに含まれます (フィールド名は異なる場合があります) 。
    • メディア検索: メディア検索操作は、アクセスが許可されているアプリケーションでのみメディアリソースのデータを返します。 検索条件で1つ以上のアプリケーションID (AppId) を指定できます。
    注 マルチアプリケーションサービスを有効化すると、ApsaraVideo VODコンソールでアクセスが許可されているアプリケーションでのみメディアリソースを管理できます。 ApsaraVideo VODコンソールは、他のアプリケーションの管理をサポートするようにアップグレードされます。