すべてのプロダクト
Search

このプロダクト

    :CreateUploadVideo

    ドキュメントセンター

    :CreateUploadVideo

    最終更新日:Dec 09, 2025

    ApsaraVideo VOD は、アップロードを承認し、セキュリティを確保するためのアップロード URL と認証情報を提供します。この操作を呼び出してアップロード URL と認証情報を取得すると、メディア ID (MediaId) (ビデオ ID (VideoId) とも呼ばれる) が自動的に作成され、音声または動画アセットを管理します。

    操作説明

    • この操作を呼び出す前に、ApsaraVideo VOD の課金方法と料金を必ずご確認ください。メディアアセットを ApsaraVideo VOD にアップロードすると、ストレージ料金が発生します。詳細については、「メディアアセットストレージの課金」をご参照ください。転送アクセラレーションを有効にすると、アップロードアクセラレーション料金も請求されます。詳細については、「ストレージ転送アクセラレーションの課金」をご参照ください。ストレージ料金は、ファイルが正常にアップロードされた後に請求されます。アクセラレーション料金は、この機能が有効になった後にファイルをアップロードする際に請求されます。この操作を呼び出しても料金は発生しません。

    • アップロード URL と認証情報の取得は、ApsaraVideo VOD のコア機能であり、すべてのアップロードで必須の手順です。ApsaraVideo VOD は複数のアップロード方法を提供しており、URL と認証情報を取得するための要件は各方法で異なります。詳細については、「アップロード URL と認証情報」をご参照ください。

    • この操作は、アップロード URL と認証情報を取得し、メディアアセットレコードを作成するためにのみ使用されます。ファイルのアップロードには使用されません。API 操作を呼び出してメディアアセットをアップロードする完全な例については、「ApsaraVideo VOD API 操作を使用したメディアアセットのアップロード」をご参照ください。

    • この操作を使用して、動画ファイルと音声ファイルの両方のアップロード URL と認証情報を取得できます。詳細については、「アップロード URL と認証情報」をご参照ください。

    • アップロード認証情報の有効期限が切れた場合は、RefreshUploadVideo 操作を呼び出して新しい認証情報を取得できます。デフォルトの有効期間は 3000 秒です。

    • アップロードが完了した後、コールバックを設定して アップロードイベント通知 を受信するか、GetMezzanineInfo 操作を呼び出してファイルステータスを確認し、アップロードが成功したかどうかを判断できます。

    • この操作によって返される VideoId パラメーターは、メディアアセットのライフサイクル管理や ApsaraVideo Media Processing で使用します。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    vod:CreateUploadVideo

    create

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    CoverURL

    string

    任意

    カスタム動画サムネイルの URL。

    https://example.aliyundoc.com/image/D22F553TEST****.jpeg
    Description

    string

    任意

    アップロード完了後に ApsaraVideo VOD に表示される音声または動画ファイルの説明。

    • 説明の長さは最大 1,024 文字です。

    • 値は UTF-8 でエンコードする必要があります。

    UploadTest
    FileName

    string

    必須

    アップロードするソースの音声または動画ファイルのパス。

    • ファイル名にはファイル拡張子を含める必要があります。ファイル拡張子では大文字と小文字は区別されません。

    • サポートされているファイル拡張子の詳細については、「アップロードの概要」をご参照ください。

    D:\video_01.mp4
    FileSize

    integer

    任意

    ソースの音声または動画ファイルのサイズ。単位：バイト。

    123
    Title

    string

    必須

    アップロード完了後に ApsaraVideo VOD に表示される音声または動画ファイルのタイトル。

    • タイトルの長さは最大 128 文字です。

    • 値は UTF-8 でエンコードする必要があります。

    UploadTest
    CateId

    integer

    任意

    カテゴリ ID。カテゴリ ID は、次のいずれかの方法で取得できます：

    • ApsaraVideo VOD コンソールにログインします。ナビゲーションウィンドウで、[設定管理] > [メディア管理設定] > [カテゴリ管理] を選択して、カテゴリ ID を表示します。

    • AddCategory 操作を呼び出してカテゴリを作成した後に返される CateId パラメーターの値。

    • GetCategories 操作を呼び出してカテゴリをクエリした後に返される CateId パラメーターの値。

    100036****
    Tags

    string

    任意

    音声または動画ファイルのタグ。

    • 最大 16 個のタグを追加できます。

    • 複数のタグはコンマ (,) で区切ります。

    • 各タグの長さは最大 32 文字です。

    • 値は UTF-8 でエンコードする必要があります。

    tag1,tag2
    UserData

    string

    任意

    カスタム設定。これは、メッセージコールバックや転送アクセラレーションなどの設定をサポートする JSON 文字列です。詳細については、「UserData」をご参照ください。

    説明

    • メッセージコールバック機能を使用するには、ApsaraVideo VOD コンソールで Webhook アドレスを設定し、対応するイベントタイプを選択する必要があります。そうしないと、コールバック設定は有効になりません。コンソールで Webhook を設定する方法の詳細については、「コールバック設定」をご参照ください。

    • アップロードアクセラレーション機能を使用するには、Yida でフォームに入力してアクティベーションをリクエストする必要があります。詳細については、「アップロード手順」をご参照ください。

    {"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"*****","test":"www"}}
    TemplateGroupId

    string

    任意

    トランスコーディングテンプレートグループの ID。ID は、次のいずれかの方法で取得できます：

    • ApsaraVideo VOD コンソールにログインします。ナビゲーションウィンドウで、[設定管理] > [メディア処理設定] > [トランスコーディングテンプレートグループ] を選択して、トランスコーディングテンプレートグループの ID を表示します。

    • AddTranscodeTemplateGroup 操作を呼び出した後に返される TranscodeTemplateGroupId パラメーターの値。

    • ListTranscodeTemplateGroup 操作を呼び出した後に返される TranscodeTemplateGroupId パラメーターの値。

    説明

    • `WorkflowId` と `TemplateGroupId` の両方を指定した場合、`WorkflowId` が優先されます。

    • このパラメーターを指定しない場合、デフォルトのトランスコーディングテンプレートグループが使用されます。このパラメーターを指定した場合、指定されたトランスコーディングテンプレートグループが使用されます。

    • このパラメーターをシステム組み込みのトランスコーディングなしテンプレートグループの ID に設定した場合、音声または動画ファイルのアップロード後に VideoUploadComplete イベント通知のみを受信します。TranscodeComplete イベント通知は受信しません。

    • 通常の再生を確保するため、このパラメーターをシステム組み込みのトランスコーディングなしテンプレートグループの ID に設定した場合、アップロード後にトランスコーディングなしで再生できるのは、MP4、FLV、MP3、M3U8、WEBM 形式のファイルのみです。他の形式のファイルは保存のみ可能です。`FileName` のファイル拡張子にご注意ください。ApsaraVideo Player を使用する場合、プレーヤーのバージョンは 3.1.0 以降である必要があります。

    405477f9e214d19ea2c7c854****
    WorkflowId

    string

    任意

    ワークフロー ID。ApsaraVideo VOD コンソールにログインし、[設定管理] > [メディア処理設定] > [ワークフロー管理] を選択して、ワークフロー ID を表示します。

    説明

    `WorkflowId` と `TemplateGroupId` の両方を指定した場合、`WorkflowId` が優先されます。詳細については、「ワークフロー」をご参照ください。

    613efff3887ec34af685714cc461****
    StorageLocation

    string

    任意

    ストレージの場所。ApsaraVideo VOD コンソールにログインし、[設定管理] > [メディア管理設定] > [ストレージ] を選択して、ストレージの場所を表示します。

    説明

    このパラメーターを指定しない場合、音声または動画ファイルはデフォルトのストレージの場所にアップロードされます。デフォルトのストレージの場所が設定されていない場合、ファイルはストレージリストの最初のストレージの場所にアップロードされます。このパラメーターを指定した場合、ファイルは指定されたストレージの場所にアップロードされます。

    out-****.oss-cn-shanghai.aliyuncs.com
    AppId

    string

    任意

    アプリケーションの ID。デフォルト値：app-1000000。詳細については、「マルチアプリケーションサービス」をご参照ください。

    app-1000000
    ReferenceId

    string

    任意

    カスタム ID。小文字、大文字、数字、ハイフン (-)、アンダースコア (_) を含めることができます。ID は 6〜64 文字の長さで、ユーザーごとに一意である必要があります。

    123-123

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスパラメーター。

    RequestId

    string

    リクエスト ID。

    25818875-5F78-4AF6-04D5-D7393642****
    UploadAddress

    string

    アップロード URL。

    説明

    この操作によって返されるアップロード URL は Base64 エンコードされています。SDK または API 操作を使用してメディアアセットをアップロードする前に、URL を Base64 デコードする必要があります。`UploadAddress` を解析する必要があるのは、Object Storage Service (OSS) ネイティブ SDK を使用するか、OSS API 操作を呼び出してメディアアセットをアップロードする場合のみです。

    eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****
    VideoId

    string

    音声または動画ファイルの ID。この ID は、メディアアセット管理、メディア処理、メディア審査などの他の操作を呼び出す際にリクエストパラメーターとして使用できます。

    93ab850b4f6f54b6e91d24d81d44****
    UploadAuth

    string

    アップロード認証情報。

    説明

    この操作によって返されるアップロード認証情報は Base64 エンコードされています。SDK または API 操作を使用してメディアアセットをアップロードする前に、認証情報を Base64 デコードする必要があります。`UploadAuth` を解析する必要があるのは、OSS ネイティブ SDK を使用するか、OSS API 操作を呼び出してメディアアセットをアップロードする場合のみです。

    eyJFbmRwb2ludCI6Imm****

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "25818875-5F78-4AF6-04D5-D7393642****",
  "UploadAddress": "eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****",
  "VideoId": "93ab850b4f6f54b6e91d24d81d44****",
  "UploadAuth": "eyJFbmRwb2ludCI6Imm****"
}

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。