メディアアセットがオンラインファイルである場合、または一度に自動的にアップロードまたは移行する必要がある場合は、Intelligent Media Services（IMS）の関連 API オペレーションを呼び出して、メディアアセットのアップロード URL とアップロード資格情報を取得し、Object Storage Service（OSS）の API オペレーションを呼び出してメディアアセットをアップロードできます。このトピックでは、OSS の API オペレーションを呼び出してメディアアセットをアップロードする方法について説明します。
前提条件
サポートされているファイル形式について理解していること。詳細については、概要 トピックの「サポートされているファイル形式」セクションをご参照ください。
OSS がアクティブ化されていること。詳細については、OSS のアクティブ化をご参照ください。
背景情報
OSS の API オペレーションを呼び出してメディアアセットをアップロードする前に、メディアアセットのアップロード URL とアップロード資格情報を取得する必要があります。アップロード URL は、IMS 内の OSS ストレージアドレスです。アップロード資格情報は、アップロードを完了するために使用される認証資格情報です。アップロード URL とアップロード資格情報は IMS によって発行され、メディアアセットのアップロード中の認証とセキュリティの問題を解決するために使用されます。これにより、悪意のあるファイルのアップロードが防止されます。IMS がアップロード URL とアップロード資格情報を発行すると、後続のメディアアセットのライフサイクル管理またはメディア処理のために、メディアアセット ID が自動的に作成されます。
使用上の注意
最大 5 GB のサイズのオーディオファイルまたはビデオファイルをアップロードできます。
ファイル名の拡張子は、アップロード中は大文字と小文字が区別されません。ファイル名の拡張子がサポートされていない場合、またはアップロードされたファイルの形式がアップロード資格情報と一致しない場合、ファイルのアップロードは失敗します。
手順 1：メディアアセットのアップロード URL とアップロード資格情報を取得する
サーバー SDK を統合するか、HTTP または HTTPS リクエストを作成して CreateUploadMedia オペレーションを呼び出し、メディアアセットのアップロード URL とアップロード資格情報を取得できます。サーバー SDK を統合することをお勧めします。詳細については、RPC API のリクエスト構文と署名方式 V2 をご参照ください。
アップロード URL とアップロード資格情報は、1 つのメディアアセットにのみ使用できます。アップロード URL とアップロード資格情報を別のメディアアセットに使用すると、元のメディアアセットが上書きされます。
メディアアセットのアップロード URL とアップロード資格情報を繰り返し取得する場合、毎回取得されるアップロード URL とアップロード資格情報は異なります。
アップロード URL は IMS によって自動的に割り当てられ、カスタマイズすることはできません。
アップロード資格情報の有効期間は 3,000 秒です。ビデオファイルのサイズが大きい場合、アップロード中にビデオファイルのアップロード資格情報の有効期限が切れる可能性があります。この場合、RefreshUploadMedia オペレーションを呼び出して、アップロード資格情報を更新できます。アップロード資格情報を更新した後、新しいアップロード資格情報の有効期間は引き続き 3,000 秒で、アップロード URL は変更されません。
画像と、字幕やフォントファイルなどの補助メディアアセットのサイズは小さくなっています。画像または補助メディアアセットのアップロード資格情報の有効期限が切れた後、アップロード資格情報を再取得する必要があります。
手順 2：OSS の API オペレーションを呼び出してメディアアセットをアップロードする
メディアアセットのアップロード URL とアップロード資格情報を Base64 デコードした後、OSS の関連 API オペレーションを呼び出してメディアアセットをアップロードします。詳細については、共通の HTTP ヘッダー および OSS バケットへのオブジェクトのアップロード をご参照ください。