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