製品アップデート情報
サブアプリケーションシステム
概要
VODでは、VODでリソースを隔離できるように、サブアプリケーション機能を提供しています。サブアプリケーションとはVODの内的概念であり、リソースを分割するための方法です。サブアプリケーションの外的パフォーマンスは、独立したVODアカウントに似ています。サブアプリケーションを作成した後のVODリソースの帰属形式を、次の図に示します。
説明：
ここでいうリソースには、VOD内のメディアファイルとその属性、メディアファイルから派生したその他のファイル、各種設定、CDNドメイン名、VODサービスの使用状況の統計情報などが含まれます。
ユースケース
VODサブアプリケーションの一般的なユースケースは、次のとおりです。
複数部門/複数業務の隔離：ある企業はTencent Cloudをベースとして独自の製品を開発しています。その中で部門Aは、VODを使用してUGSV Appを開発する必要があります。部門Bは、VODを使用して映画とテレビのWebサイトを開発する必要があります。これら2つのVOD業務は互いに隔離する必要がありますが、財務管理上の理由から、この会社は部門AとBに個別のTencent Cloudアカウントを作成することができません。このような場合、VODのサブアプリケーション機能を使用して、部門Aと部門Bに1つずつサブアプリケーションを割り当てることができます。
権限制御：上記の複数部門/複数業務の隔離シナリオにおいて、開発者は、権限制御の要件をさらに設定する場合があります。例えば、各部門に対して自部門の業務に関連付けられたサブアプリケーションにのみアクセスを許可し、他のサブアプリケーションへのアクセス権限を持たせないといったことです。この場合、アカウント管理者は、部門Aと部門Bにサブユーザーを1つずつ割り当てて、対応するVODサブアプリケーションへのアクセス権限を付与することができます。操作の詳細については、CAMをご参照ください。
本番環境とテスト環境の分離：開発者はあるVOD機能をテストしたいと思っていますが、それらがオンライン運用に影響を与えることを懸念しています（例えば、イベントの通知方法の変更やリンク不正アクセス防止を有効にすることなど）。開発者は、本番環境とテスト環境に対して、それぞれ1つのサブアプリケーションをアクティブにすることで、新しい機能を最初にテスト環境で検証し、誤りのないことを確認してから、オンライン環境に変更することができます。
ロールの定義と識別
サブアプリケーションシステムには、管理者、メインアプリケーションおよびサブアプリケーションという3種類のロールがあります。次の図を使用して、それらの定義を説明します。
1. 開発者がVODサービスをアクティブにした場合、デフォルトではメインアプリケーションロールとなります。この場合のすべてのVODリソースは、メインアプリケーションに帰属します。メインアプリケーションの識別子は開発者のTencent Cloud APPIDであり、コンソールのアカウント情報で確認できます。
2. 開発者がVODサブアプリケーション機能をアクティブにすると、別の管理者ロールが生成されます。管理者はVODリソースを所有せず、すべてのリソースは引き続きメインアプリケーションに属します。
3. 開発者が管理者ロールを使用してサブアプリケーションを作成すると、新規作成されたサブアプリケーションは、独立したVODリソースを持ちます。サブアプリケーションはメインアプリケーションと対等の存在であり、メインアプリケーションとは相互に隔離されているので、メインアプリケーションは特殊なサブアプリケーションであると考えることができます。サブアプリケーションを作成すると、VODはサブアプリケーションIDと呼ばれる、プラットフォーム全体で一意の識別子を割り当てます。確認方法については、コンソールの使用説明 - アプリケーション管理をご参照ください。
4. 開発者が管理者ロールを使用してサブアプリケーションを再度作成すると、この新規作成されたサブアプリケーションも独立したVODリソースを持ちます。このサブアプリケーションもメインアプリケーションや他のサブアプリケーションと対等の存在であり、相互に隔離されています。以下同様です。
説明：
特に説明のない限り、以下ではメインアプリケーションとサブアプリケーションを区別せず、すべてサブアプリケーションと表現します。
機能
VODサブアプリケーションシステムは、次のような機能を提供します。
サブアプリケーションの作成および設定：開発者はVODサブアプリケーション機能をアクティブにすると、コンソールで管理者ロールによってサブアプリケーションを作成し、各サブアプリケーションの名前と説明を設定することができます。
サブアプリケーションの無効化：メインアプリケーション以外のサブアプリケーションは無効にすることができます。サブアプリケーションを無効にしても、サブアプリケーション下のVODリソースはクリアされず、そのドメイン名のみが無効になります。他の機能（アップロード、トランスコードなど）は影響を受けません。
リソースの隔離：サブアプリケーションとサブアプリケーション間のVODリソースは、相互に隔離されています。
サブアプリケーションのVODリソースはコンソールまたはサーバーAPIによって操作できます。
ストレージ、帯域幅/トラフィック、トランスコード時間、ビデオインテリジェント認識時間、再生データなど、サブアプリケーションごとに個別のデータ統計情報を生成します。
すべてのサブアプリケーションに対して概要データ統計情報を生成します。
制限
VODサブアプリケーションシステムには、次のような制限があります。
メインアプリケーションの名前と説明は変更できません。
サブアプリケーションは削除できません。
各VODアカウントは、最大50個のサブアプリケーションを作成することができます。
サブアプリケーションには個別の課金ロジックを設定できません（課金方式の設定、個別の課金生成、専用リソースパックの購入など）。1つのVODアカウント下のすべてのサブアプリケーションは、いずれも同じVODアカウントに属しています。すべてのサブアプリケーションのVOD使用量データ（ストレージ、トラフィック、トランスコード時間、ビデオインテリジェント認識時間などのVOD課金項目を含みますが、これらに限定されない）はすべて合算され、一括で課金されます。
コンソールの使用説明
サブアプリケーションのアクティブ化
1. VODコンソールにログインします。
2. 左側ナビゲーションバーのサブアプリケーションのアクティブ化をクリックして、アクティブ化ページに進みます。
3. このページの今すぐ使用するをクリックすると、VODのサブアプリケーション機能がアクティブになります。
説明：
サブアプリケーションの機能がすでにアクティブ化されている場合、左側ナビゲーションバーのサブアプリケーションのアクティブ化は表示されません。
ロールの選択
サブアプリケーション機能をアクティブにすると、VODコンソールのアプリケーション管理の左上隅にロールを選択するドロップダウンリストが表示されるので、開発者はここでロールを選択できます。サブアプリケーション機能をアクティブにした直後は、ドロップダウンリストには「メインアプリケーション」という1つのロールしかありません。サブアプリケーションを作成すると、対応するロールがドロップダウンリストに追加されます。
管理者
管理者ロールの場合、左側ナビゲーションバーには、サービスの概要、アプリケーション管理、使用量統計、リソースパック管理、Licnese管理が表示されます。
サービスの概要：このページには、VOD課金方式、すべてのサブアプリケーションを集約した後の主要な業務データおよび各サブアプリケーションの主要な業務データが表示されます。
アプリケーション管理：このページでは、サブアプリケーションの確認、作成、編集および無効化を行うことができます。各サブアプリケーションの識別子（サブアプリケーションID）もこのページに表示されます。
使用量統計：このページでは、各アカウント下で使用する各製品機能の消費量を確認できます。
リソースパック管理：このページでは、各タイプのリソースパックの使用状況を確認できます。
License管理：このページでは、View CubeビデオLicenseおよびUGSVミニプログラムプラグインLicenseの使用状況を確認できます。
サブアプリケーション
サブアプリケーションロールの場合、VODコンソールの使用方法はサブアプリケーション機能が無効のときとほぼ同じです。サブアプリケーションに属するVODリソースを表示、操作することができます。2つの主な相違点は、サブアプリケーションには独自の課金設定がないところです。
サーバーAPIの使用説明
VODサブアプリケーション機能をアクティブ化後、開発者がVODサーバーAPIを使用する際は、どのサブアプリケーションのリソースにアクセスするかを指定する必要があります。
サーバーAPIでサブアプリケーションを指定
VODサーバーAPIは、Tencent Cloud API 3.0にアップグレードされました。ユーザーは各APIの
SubAppIdパラメータでアクセスしたいサブアプリケーションを指定できます。メインアプリケーションにアクセスする場合は、メインアプリケーションのIDを入力するか、もしくは空のままでもかまいません。###サーバーAPI2017でサブアプリケーションを指定
サーバーAPI 2017もサブアプリケーションをサポートしています。使用する場合は、リクエストに
SubAppIdパラメータを追加する必要があります（大文字と小文字を区別して入力してください）。このパラメータとサーバーAPI 2017のパブリックリクエストパラメータは同じレベルであり、その値はサブアプリケーションIDです。メインアプリケーションにアクセスする場合は、メインアプリケーションIDを入力するか、もしくは空のままでもかまいません。説明：
サーバーAPI 2017のドキュメントに
SubAppIdパラメータは公開されていませんが、このパラメータの使用には影響しません。SubAppIdパラメータはサーバーAPIの署名計算にも関与しますが、計算ルールは同じです。ファイルアップロードの説明
VODサブアプリケーション機能をアクティブにした後、メディアファイルをVODにアップロードするサブアプリケーションを指定する必要があります。
CSSレコーディング
CSSレコーディング は、指定したサブアプリケーションでレコーディングを生成できます。指定方法とは、CSSプッシュパラメータに、
vod_sub_app_id=xxx（xxxとはサブアプリケーションIDのこと）を追加することです。メインアプリケーションでレコーディングする場合は、このパラメータを空のままにします。サーバーからのアップロード
サーバーからのアップロード は、指定されたサブアプリケーションへのアップロードをサポートします。具体的なパラメータの設定方法については、以下のリンクをご参照ください。メインアプリケーションにアップロードする場合は、メインアプリケーションのIDを入力するか、空のままでもかまいません。
SDKから
サーバーAPIから
API方式でアップロードする場合はApplyUploadとCommitUploadという2つのインターフェースが必要です。具体的な使用方法については、サーバーAPIでサブアプリケーションを指定をご参照ください。
SDKを使用してアップロードすることを強くお勧めします。
クライアントからのアップロード
クライアントからのアップロード では指定したサブアプリケーションへのアップロードをサポートします。指定方法とは、クライアントからのアップロードの署名 にパラメータ
vodSubAppId=xxx（xxxはサブアプリケーションIDのこと）を追加することです。メインアプリケーションにアップロードする場合は、メインアプリケーションのIDを入力するか、空のままでもかまいません。説明：
vodSubAppIdパラメータはクライアントからのアップロードの署名計算にも関与しますが、計算ルールは同じです。URLからのプルアップロード
URLからのプルアップロードでは、指定したサブアプリケーションへのアップロードをサポートします。
コンソールから：具体的な使用法については、 コンソールの使用説明をご参照ください。
サーバーAPIから：PullUpload インターフェースを使用します。具体的な使用方法については、サーバーAPIでサブアプリケーションを指定をご参照ください。
権限管理
FAQ
サブアプリケーション機能をアクティブにすると、オンラインになっている既存の業務ロジックに影響を与えますか。
影響は与えません。サブアプリケーションシステムは互換性を考慮して設計されています。すべてのサーバーAPIインターフェースは、サブアプリケーションIDが指定されていない場合、デフォルトでメインアプリケーションを操作します。
サブアプリケーション機能をアクティブ化するには料金がかかりますか。
サブアプリケーション機能を使用して業務の隔離を実装していますが、各業務ではどのように内部決済/コストを実装するのですか。
前述の制限で説明したように、VODは、アカウント全体を取りまとめた請求書のみを発行します。複数の内部業務でコストを分担する必要がある場合は、VODが提供するサブアプリケーションレベルの統計データに基づいて、内部コストの分担をカスタマイズし、計算することができます。
サービスを一時停止した場合、サブアプリケーションにどのような影響を与えますか。
あるサブアプリケーションのビデオを、別のサブアプリケーションに移行できますか。
サブアプリケーション間のリソースは隔離されており、移行できません。
フィードバック