ApsaraVideo VOD は、認可済みかつ安全なアップロードのためのアップロードアドレスおよびアップロード認証情報を提供します。また、メディア管理用のメディア ID（または動画 ID）を自動的に生成します。本操作を呼び出して、アップロードアドレスおよびアップロード認証情報を取得し、メディアアセットを初期化してください。
操作説明
本操作を使用する前に、ApsaraVideo VOD の課金方法および料金体系を確認してください。ApsaraVideo VOD へのメディアアセットのアップロードにはストレージ料金が発生します。詳細については、「ストレージ課金」をご参照ください。ストレージおよび転送アクセラレーション機能を有効化している場合、アップロードアクセラレーション料金も別途発生します。詳細については、「ストレージおよび転送アクセラレーションの課金」をご参照ください。ファイルのアップロードが正常に完了した時点で、ストレージ料金が発生します。アクセラレーション料金は、機能を有効化した後のアップロード分に対して課金されます。本操作の呼び出し自体は無料です。
すべてのアップロードにおいて、アップロードアドレスおよびアップロード認証情報の取得は必須です。ApsaraVideo VOD では複数のアップロード方法がサポートされており、取得方法は選択したアップロード方法によって異なります。詳細については、「アップロードアドレスおよびアップロード認証情報」をご参照ください。
本操作は、アップロードアドレスおよびアップロード認証情報の取得とメディアアセットの初期化のみを実行します。ファイルの実際のアップロードは行いません。API を使用した完全なアップロード手順の例については、「VOD API を使用したメディアアセットのアップロード」をご参照ください。
本操作は、動画および音声ファイル向けのアップロードアドレスおよびアップロード認証情報を取得します。詳細については、「アップロードアドレスおよびアップロード認証情報」をご参照ください。
アップロード認証情報の有効期限が切れた場合（デフォルトで 3,000 秒）、RefreshUploadVideo 操作を呼び出して新しい認証情報を取得してください。
アップロード完了後は、コールバックを設定してアップロードイベント通知を受信するか、GetMezzanineInfo 操作を呼び出してファイルのステータスを確認し、アップロードの完了を検証できます。
本操作で返される VideoId パラメーターは、メディアアセットのライフサイクル管理やメディア処理に利用できます。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
vod:CreateUploadVideo |
create |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| CoverURL |
string |
任意 |
カスタム動画サムネイルの URL。 |
https://example.aliyundoc.com/image/D22F553TEST****.jpeg |
| Description |
string |
任意 |
音声または動画ファイルの説明文。アップロード完了後に ApsaraVideo VOD コンソールに表示されます。
|
UploadTest |
| FileName |
string |
必須 |
ソース音声または動画ファイルのパス。
|
D:\video_01.mp4 |
| FileSize |
integer |
任意 |
ソースファイルのサイズ（バイト単位）。 |
123 |
| Title |
string |
必須 |
音声または動画ファイルのタイトル。アップロード完了後に ApsaraVideo VOD コンソールに表示されます。
|
UploadTest |
| CateId |
integer |
任意 |
カテゴリ ID。以下のいずれかの方法で取得できます：
|
100036**** |
| Tags |
string |
任意 |
音声または動画ファイルのタグ。
|
tag1,tag2 |
| UserData |
string |
任意 |
JSON 形式のカスタム設定。メッセージコールバックやアップロードアクセラレーションなどの機能をサポートします。詳細については、「UserData」をご参照ください。 |
{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"*****","test":"www"}} |
| TemplateGroupId |
string |
任意 |
トランスコードテンプレートグループの ID。以下のいずれかの方法で取得できます：
説明
|
405477f9e214d19ea2c7c854**** |
| WorkflowId |
string |
任意 |
ワークフロー ID。ワークフロー ID を確認するには、ApsaraVideo VOD コンソールにログインし、設定管理 > メディア処理 > ワークフローマネジメント の順に選択します。 説明
|
613efff3887ec34af685714cc461**** |
| StorageLocation |
string |
任意 |
ストレージロケーション。ストレージロケーションを確認するには、ApsaraVideo VOD コンソールにログインし、設定管理 > メディア管理 > ストレージ管理 の順に選択します。 説明
本パラメーターを省略した場合、メディアファイルはデフォルトのストレージロケーションにアップロードされます。デフォルトのストレージロケーションが設定されていない場合は、ストレージ一覧の最初のロケーションにアップロードされます。それ以外の場合、指定されたストレージロケーションにアップロードされます。 |
out-****.oss-cn-shanghai.aliyuncs.com |
| AppId |
string |
任意 |
アプリケーション ID。デフォルト値：app-1000000。詳細については、「マルチアプリケーションサービス」をご参照ください。 |
app-1000000 |
| ReferenceId |
string |
任意 |
カスタム ID。長さは 6～64 文字で、小文字、大文字、数字、ハイフン (-)、アンダースコア (_) のみを使用できます。ユーザーごとに一意である必要があります。 |
123-123 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスボディ。 |
||
| RequestId |
string |
リクエスト ID。 |
25818875-5F78-4AF6-04D5-D7393642**** |
| UploadAddress |
string |
アップロードアドレス。 説明
アップロードアドレスは Base64 エンコードされた文字列です。SDK または API を使用してメディアアセットをアップロードする前に、必ずデコードする必要があります。Object Storage Service (OSS) のネイティブ SDK を使用する場合、または OSS API を呼び出してメディアアセットをアップロードする場合にのみ、解析が必要です。 |
eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF**** |
| VideoId |
string |
音声または動画ファイルの ID。メディアアセット管理、メディア処理、メディアレビューのリクエストパラメーターとして使用できます。 |
93ab850b4f6f54b6e91d24d81d44**** |
| UploadAuth |
string |
アップロード認証情報。 説明
アップロード認証情報は Base64 エンコードされた文字列です。SDK または API を使用してメディアアセットをアップロードする前に、必ずデコードする必要があります。Object Storage Service (OSS) のネイティブ SDK を使用する場合、または OSS API を呼び出してメディアアセットをアップロードする場合にのみ、解析が必要です。 |
eyJFbmRwb2ludCI6Imm**** |
例
成功レスポンス
JSONJSON
{
"RequestId": "25818875-5F78-4AF6-04D5-D7393642****",
"UploadAddress": "eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****",
"VideoId": "93ab850b4f6f54b6e91d24d81d44****",
"UploadAuth": "eyJFbmRwb2ludCI6Imm****"
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。