ネットワークファイルのアップロード、アップロードの自動化、または一括移行を実行するには、Intelligent Media Services (IMS) API を呼び出してアップロード URL と認証情報を取得し、ネイティブの Object Storage Service (OSS) API を使用してアップロードを完了します。
前提条件
-
サポートされているファイル形式を理解していること。詳細については、「サポートされているファイル形式」をご参照ください。
-
Object Storage Service (OSS) を有効化していること。詳細については、「OSS の有効化」をご参照ください。
背景情報
OSS API を使用してメディアアセットをアップロードする前に、IMS からアップロード URL と認証情報を取得する必要があります。アップロード URL は OSS のストレージアドレスを指定し、認証情報はアップロードを承認します。IMS は、セキュリティを確保し、悪意のあるアップロードを防ぐために、URL と認証情報の両方を発行します。IMS がアップロード URL と認証情報を発行すると、メディアアセットのライフサイクル管理や ApsaraVideo Media Processing に使用できるメディアアセット ID も自動的に作成されます。
注意事項
-
単一のオーディオまたはビデオファイルの最大サイズは 5 GB です。
-
アップロード時、拡張子の大文字と小文字は区別されません。拡張子がサポートされていない場合、ファイル形式がアップロード認証情報と一致しないため、アップロードは失敗します。
ステップ1：アップロード URL と認証情報の取得
CreateUploadMedia API を呼び出して、メディアアセットのアップロード URL と認証情報を取得します。サーバーサイド SDK を統合する (推奨) か、独自の HTTP(S) リクエストを構築できます。詳細については、RPC メカニズムをご参照ください。
-
各アップロード URL と認証情報は、1 つのメディアアセットにのみ使用できます。ファイルの上書きを避けるため、複数のアセットに使用しないでください。
-
同じメディアアセットのアップロード URL と認証情報を複数回リクエストした場合、リクエストごとに異なる URL と認証情報が返されます。
-
アップロード URL は Intelligent Media Services によって自動的に割り当てられます。カスタム URL はサポートされていません。
-
アップロード認証情報の有効期間は 3000 秒です。サイズの大きいビデオファイルの場合、アップロード中に認証情報が失効する可能性があります。失効した場合は、RefreshUploadMedia API を呼び出して更新してください。新しい認証情報の有効期間も 3000 秒で、アップロード URL は変更されません。
-
画像、キャプション、フォントファイルなどの補助メディアアセットのような小さいファイルの場合、認証情報が失効したときは CreateUploadMedia API を再度呼び出して新しい認証情報を取得する必要があります。この場合、RefreshUploadMedia API を使用した認証情報の更新はできません。
ステップ2：OSS API を呼び出してメディアアセットのアップロード
CreateUploadMedia API の応答から取得した、Base64 でエンコードされているアップロードアドレスと認証情報をデコードします。次に、OSS アップロード API を呼び出してメディアアセットをアップロードします。詳細については、「共通の HTTP ヘッダー」および「OSS へのファイルのアップロード」をご参照ください。