ApsaraVideo VODは、そのコア機能として、アップロードURLと認証情報を使用して、メディアアセットのアップロードのセキュリティを確保します。 このトピックでは、アップロードURLと資格情報の背景情報、使用上の注意事項、および制限について説明します。 このトピックでは、アップロードURLと資格情報を取得して解析する方法についても説明します。
背景情報
アップロードURLは、メディアファイルのストレージパスを指定します。 アップロード資格情報は、メディアファイルをApsaraVideo VODにアップロードする権限を与えます。 ApsaraVideo VODは、URLと資格情報をアップロードして認証を実行し、セキュリティを確保します。 これにより、権限のないユーザーがメディアファイルをアップロードできなくなります。 ApsaraVideo VODは、アップロードURLと資格情報を発行するとメディアIDを生成します。 メディアIDは、ライフサイクル管理およびメディア処理に使用できます。
メディアID
メディアIDは、ビデオIDおよび画像IDを含む。 メディアIDは、次の目的で使用できます。
アップロード後のメディアファイルのライフサイクル管理を実行します。 アップロードURLとアップロード資格情報を使用してメディアファイルをアップロードした後、メディアファイルの初期ステータスはUploadingです。 メディアファイルの特定の処理ジョブが完了すると、メディアファイルのステータスはUploaded、Transcoding、またはNormalに変わります。
メディアIDに基づいて、トランスコード、スナップショットキャプチャ、ビデオAI、およびビデオ編集機能を使用してメディアファイルを処理します。
制限事項
アップロードURLとアップロード資格情報は、単一のオーディオファイル、単一のビデオ、または単一の画像など、単一のメディアファイルに対してのみ使用できます。
同じ動画のアップロードURLとアップロード資格情報を取得するリクエストを繰り返し送信すると、異なるアップロードURLと資格情報が発行されます。
アップロードURLはApsaraVideo VODによって割り当てられます。 アップロードURLは指定できません。
すべてのアップロード資格情報の有効期間は3,000秒です。これは50分に相当します。
大きなビデオファイルをアップロードする場合は、アップロードを完了するまでに時間がかかります。 この場合、有効期限が切れた後にアップロード資格情報を更新する必要があります。 更新されたアップロード資格情報の有効期間は3,000秒で、アップロードURLは変更されません。
画像や透かしや字幕ファイルなどの補助メディアアセットの場合は、元のものの有効期限が切れたときに新しいアップロード資格情報を取得する必要があります。
使用上の注意
ビデオ、画像、および補助メディアアセットをアップロードするには、さまざまなAPI操作を呼び出してアップロードURLと資格情報を取得する必要があります。 次の表に示すように、特定のアップロード方法を使用する場合にのみ、アップロードURLと資格情報を手動で取得する必要があります。
特定のシナリオでは、URLと資格情報をアップロードするだけでなく、Security Token Service (STS) トークンを使用してApsaraVideo VODにアクセスすることもできます。 2つのアクセス方法の違いの詳細については、「資格情報とSTSの比較」をご参照ください。 2つのアクセス方法には次の違いがあります。
アップロード資格情報を使用してメディアファイルをアップロードする場合、Alibaba CloudアカウントまたはRAMユーザーのAccessKeyペアを渡してアップロード要求を作成できます。
STSトークンを使用してメディアファイルをアップロードする場合は、STSトークンを渡してアップロード要求を作成する必要があります。
アップロード方法 | アップロードURLと資格情報を手動で取得する必要があるかどうか | アップロードURLと資格情報を手動で解析する必要があるかどうか |
|---|---|---|
| 任意 注意 ApsaraVideo VODが提供するサーバーアップロードSDKは、次のプログラミング言語のみをサポートしています。
| 任意 |
必須 説明 取得したアップロードURLと資格情報をクライアントに配信するだけです。 アップロードURLまたは資格情報を解析する必要はありません。 | 任意 | |
任意 | 任意 | |
必須 説明 この方法では、ApsaraVideo VODサーバー操作SDKを使用して、アップロードURLとアップロード資格情報を取得する必要があります。 その後、取得したアップロードURLと資格情報を使用してObject Storage Service (OSS) SDKを初期化し、メディアファイルをアップロードできます。 | 必須 | |
必須 | 必須 |
アップロードURLと資格情報の取得
ApsaraVideo VODでは、次の2つの方法のいずれかを使用して、アップロードURLと資格情報を取得できます。
サンプルコードの詳細については、このトピックの [使用状況] セクションの表でサンプルコードを表示するアップロードメソッドをクリックします。
推奨されます。 ApsaraVideo VODサーバー操作SDKを使用してAPI操作を呼び出し、アップロードURLと認証情報を取得します。
プログラミング言語 | SDK サンプルコード |
|---|---|
Java | |
Python | |
PHP | |
.NET | ApsaraVideo VOD SDKを使用したメディアのアップロード。NET |
Node.js | |
Go | |
CまたはC ++ |
HTTPまたはHTTPSリクエストを作成して、アップロードURLと資格情報を取得します。 リクエストに署名する必要があるため、この方法は複雑です。 詳細については、以下のドキュメントをご参照ください： リクエスト構文と メディアのアップロード
一般的に使用される操作
アップロードURLと資格情報の解析
OSS SDKまたはOSS APIを使用してメディアファイルをアップロードする場合は、アップロードURLと資格情報を手動で解析する必要があります。 他のアップロード方法を使用する場合は、アップロードURLや資格情報を解析したり、それらの解析方法を気にする必要はありません。
uploadAddressパラメーターとuploadAuthパラメーターのBase64-encoded値をデコードして、アップロードURLと資格情報を取得できます。 詳細については、「OSS SDKを使用したメディアファイルのアップロード」をご参照ください。