すべてのプロダクト
Search

このプロダクト

    ApsaraVideo VOD:CreateUploadAttachedMedia

    ドキュメントセンター

    ApsaraVideo VOD:CreateUploadAttachedMedia

    最終更新日:Jul 21, 2026

    ApsaraVideo VOD が提供するアップロード URL と認証情報は、権限付与とセキュリティ上の懸念に対処し、悪意のあるアップロードを防止するとともに、管理および処理用のメディアアセット ID (MediaId) の自動作成を有効にします。ウォーターマークや字幕などの補助メディアアセットについては、この操作を呼び出してアップロード認証情報を取得し、対応するメディアアセット情報を作成してください。

    操作説明

    • この操作を使用する前に、ApsaraVideo VOD の課金メソッドと料金を必ずご確認ください。ApsaraVideo VOD にメディアファイルをアップロードすると、ストレージ料金が発生します。詳細については、「メディアアセットストレージの課金」をご参照ください。ストレージ転送アクセラレーションを有効にしている場合、ApsaraVideo VOD へのメディアファイルのアップロードにはアップロードアクセラレーション料金も発生します。詳細については、「ストレージ転送アクセラレーションの課金」をご参照ください。

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

    • アップロード認証情報が期限切れになった場合 (有効期間 3000 秒)、この操作を再度呼び出して新しいアップロード URL と認証情報を取得してください。

    • コールバックを設定して、補助メディアアセットのアップロード完了 のイベント通知を受信し、アップロードが成功したかどうかを確認できます。

    • アップロード URL と認証情報の取得は、ApsaraVideo VOD のコアとなる基本機能であり、すべてのアップロード操作に必須のステップです。ApsaraVideo VOD はさまざまなアップロードメソッドを提供しており、それぞれアップロード URL と認証情報の取得に関する要件が異なります。詳細については、「アップロード URL と認証情報」の説明をご参照ください。

    今すぐお試しください

    この 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:CreateUploadAttachedMedia

    create

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Title

    string

    任意

    補助メディアアセットのタイトル。ルール:

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

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

    テスト。
    BusinessType

    string

    必須

    補助メディアアセットのタイプ。有効な値:

    • watermark: ウォーターマーク。

    • subtitle: 字幕。

    • material: マテリアル。

    watermark
    MediaExt

    string

    任意

    アップロードする補助メディアアセットのソースファイルの拡張子。有効な値:

    • ウォーターマーク: png, gif, apng, mov。

    • 字幕: srt, ass, stl, ttml, vtt。

    • マテリアル: jpg, gif, png, mp4, mat, zip, apk。

    列挙値:

    • ass :

      ass。

    • jpg :

      jpg。

    • zip :

      zip。

    • mat :

      mat。

    • gif :

      gif。

    • apng :

      apng。

    • png :

      png。

    • ttml :

      ttml。

    • stl :

      stl。

    • mp4 :

      mp4

    • srt :

      srt。

    • mov :

      mov。

    • vtt :

      vtt。

    • apk :

      apk。

    png。
    FileName

    string

    任意

    アップロードする補助メディアアセットのソースファイルの場所。

    説明

    ファイル拡張子は任意です。ここでファイル拡張子が指定されており、MediaExt で指定された拡張子と異なる場合、MediaExt の値が優先されます。

    D:\test.png。
    FileSize

    string

    任意

    ファイルサイズ。単位: バイト。

    123
    Tags

    string

    任意

    タグ。ルール:

    • 最大値は 16 個のタグです。

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

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

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

    tag1,tag2
    StorageLocation

    string

    任意

    ストレージの場所。ストレージの場所は、以下のメソッドで取得できます。

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

    説明

    このパラメーターを指定しない場合、補助メディアアセットはデフォルトのストレージの場所にアップロードされます。このパラメーターを指定した場合、補助メディアアセットは指定されたストレージの場所にアップロードされます。

    out-****.oss-cn-shanghai.aliyuncs.com。
    Description

    string

    任意

    メディアアセットの説明。ルール:

    • 説明の長さは最大 1024 バイトです。

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

    uploadTest。
    UserData

    string

    任意

    カスタム設定 (JSON 文字列)。この設定では、メッセージコールバック、アップロードアクセラレーション、その他の構成がサポートされています。詳細については、「 UserData 」をご参照ください。

    説明

    • このパラメーターでメッセージコールバックを使用するには、コンソールで HTTP コールバック URL を設定し、対応するコールバックイベントタイプを選択する必要があります。そうしないと、コールバック設定は効果を得られません。コンソールで HTTP コールバックを設定する方法については、「コールバック設定」をご参照ください。

    • アップロードアクセラレーション特徴を使用するには、チケットを提出して有効化してください。詳細については、「アップロード手順」をご参照ください。チケットの提出方法については、「お問い合わせ」をご参照ください。

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

    string

    任意

    カテゴリ ID。複数の ID はコンマ (,) で区切ります。最大値は 5 個の ID です。カテゴリ ID は、以下のメソッドで取得できます。

    • ApsaraVideo VOD コンソール にログインし、構成管理 > メディア管理構成 > カテゴリ管理 を選択して、カテゴリ ID をビューに表示します。

    • AddCategory 操作を呼び出してカテゴリを作成すると、カテゴリ ID が返されます。

    • GetCategories 操作を呼び出してカテゴリをクエリすると、カテゴリ ID が返されます。

    1298****,0813****
    AppId

    string

    任意

    アプリケーション ID。デフォルト値: app-1000000。マルチアプリケーションサービスを有効にしている場合は、アプリケーション ID を指定して、補助メディアアセットを指定されたアプリケーションにアップロードしてください。詳細については、「マルチアプリケーション」をご参照ください。

    app-****

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答パラメーター。

    FileURL

    string

    補助メディアアセットファイルの OSS URL (認証なし)。

    イメージウォーターマークテンプレートを追加する際、この URL を AddWatermark 操作のリクエストパラメーター FileUrl として使用できます。

    https://****.oss-cn-shanghai.aliyuncs.com/watermark/****.mov
    RequestId

    string

    リクエスト ID。

    73254DE5-F260-4720-D06856B63C01****
    UploadAddress

    string

    アップロード URL。

    説明

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

    LWNuLXNoYW5naGFpLmFsaXl1b****
    MediaId

    string

    メディアアセット ID。

    97dc17a5abc3668489b84ce9****
    MediaURL

    string

    メディアアセットのアクセス URL。

    CDN ドメイン名が設定されている場合は CDN URL が返されます。それ以外の場合は OSS URL が返されます。

    説明

    返された MediaURL がブラウザでアクセスできない (403) 場合、VOD ドメイン名の URL 認証が有効になっています。URL 認証 を無効にするか、自分で認証署名を生成してください。

    http://example.aliyundoc.com/watermark/****.mov?auth_key=****
    UploadAuth

    string

    アップロード認証情報。

    説明

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

    UzFnUjFxNkZ0NUIZTaklyNWJoQ00zdHF****

    例

    成功レスポンス

    JSONJSON

    {
  "FileURL": "https://****.oss-cn-shanghai.aliyuncs.com/watermark/****.mov",
  "RequestId": "73254DE5-F260-4720-D06856B63C01****",
  "UploadAddress": "LWNuLXNoYW5naGFpLmFsaXl1b****",
  "MediaId": "97dc17a5abc3668489b84ce9****",
  "MediaURL": "http://example.aliyundoc.com/watermark/****.mov?auth_key=****",
  "UploadAuth": "UzFnUjFxNkZ0NUIZTaklyNWJoQ00zdHF****"
}

    エラーコード

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

    変更履歴

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