すべてのプロダクト
Search

このプロダクト

    :CreateUploadImage

    ドキュメントセンター

    :CreateUploadImage

    最終更新日:Dec 15, 2025

    この操作を呼び出すと、イメージのアップロードに使用するアップロード URL とアップロード認証情報を取得し、イメージ ID を生成できます。ApsaraVideo VOD は、権限付与とセキュリティを確保し、悪意のあるアップロードを防止するために、アップロード URL と認証情報を返します。

    操作説明

    • この操作を呼び出す前に、ApsaraVideo VOD の課金方法と料金を必ずご確認ください。メディアファイルを ApsaraVideo VOD にアップロードすると、ストレージ料金が発生します。詳細については、「メディアアセットストレージの課金」をご参照ください。高速化サービスを有効にしている場合、メディアファイルを ApsaraVideo VOD にアップロードする際に高速化トラフィック料金が発生します。詳細については、「高速化トラフィックの課金」をご参照ください。

    • ApsaraVideo VOD にイメージをアップロードする前に、URL と認証情報を取得する必要があります。ApsaraVideo VOD は複数のアップロード方法を提供しています。サーバーアップロード SDK、クライアントアップロード SDK、URL、Object Storage Service (OSS) API、または OSS SDK を使用してファイルをアップロードできます。各アップロード方法で、アップロード URL と認証情報を取得するための要件が異なります。詳細については、「アップロード URL と認証情報」の「注意事項」セクションをご参照ください。

    • イメージのアップロード中にアップロード URL または認証情報をリフレッシュすることはできません。イメージのアップロード認証情報の有効期限が切れた場合は、この操作を再度呼び出して新しいアップロード URL と認証情報を取得できます。デフォルトでは、イメージのアップロード認証情報の有効期間は 3,000 秒です。

    • CreateUploadAttachedMedia 操作を呼び出して、イメージウォーターマークをアップロードできます。

    • ImageUploadComplete のコールバックを設定して、イメージのアップロードステータスに関する通知を受け取ることができます。

    今すぐお試しください

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

    create

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Title

    string

    任意

    イメージのタイトル。次のルールが適用されます：

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

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

    mytitle
    ImageType

    string

    必須

    イメージのタイプ。有効な値：

    • default：デフォルトのイメージタイプ。

    • cover：サムネイル。

    説明

    ApsaraVideo VOD コンソールでは、default タイプのイメージのみを管理できます。

    default
    ImageExt

    string

    任意

    イメージのファイル名拡張子。有効な値：

    • png (デフォルト)

    • jpg

    • jpeg

    • gif

    png
    OriginalFileName

    string

    任意

    ソースファイルの名前。

    説明

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

    D:\picture_01.png
    Tags

    string

    任意

    イメージのタグ。次のルールが適用されます：

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

    • イメージには最大 16 個のタグを指定できます。

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

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

    test
    StorageLocation

    string

    任意

    ストレージの場所。ストレージの場所を取得するには、次の操作を実行します：ApsaraVideo VOD コンソールにログインします。左側のナビゲーションウィンドウで、[設定管理] > [メディア管理] > [ストレージ] を選択します。ストレージページで、ストレージの場所を確認できます。

    説明

    ストレージの場所を指定すると、メディアファイルは指定された場所にアップロードされます。

    outin-****..oss-cn-shanghai.aliyuncs.com
    CateId

    integer

    任意

    イメージのカテゴリ ID。次のいずれかの方法でカテゴリ ID を取得できます：

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

    • AddCategory 操作の応答から CateId の値を取得します。

    • GetCategories 操作の応答から CateId の値を取得します。

    100036****
    UserData

    string

    任意

    コールバック設定やアップロード高速化設定などのカスタム設定。値は JSON 文字列である必要があります。詳細については、「リクエストパラメーター」の「UserData: specifies the custom configurations for media upload」セクションをご参照ください。

    説明

    • コールバック設定は、ApsaraVideo VOD コンソールで HTTP コールバック URL を指定し、特定のコールバックイベントを選択した後にのみ有効になります。ApsaraVideo VOD コンソールで HTTP コールバック設定を構成する方法の詳細については、「コールバック設定の構成」をご参照ください。

    • アップロード高速化機能を有効にする場合は、チケットを送信してください。詳細については、「概要」をご参照ください。チケットの送信方法の詳細については、「お問い合わせ」をご参照ください。

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

    string

    任意

    イメージの説明。

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

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

    The description of the image
    AppId

    string

    任意

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

    app-1000000

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    返される結果。

    FileURL

    string

    ファイルの OSS URL。URL には、URL 署名に使用される情報は含まれていません。AddWatermark 操作を呼び出すときに FileUrl を指定できます。

    http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png
    RequestId

    string

    リクエストの ID。

    25818875-5F78-AEF6-D7393642****
    UploadAddress

    string

    アップロード URL。

    説明

    返されるアップロード URL は Base64 エンコードされた URL です。SDK を使用するか、API 操作を呼び出して補助メディアアセットをアップロードする前に、Base64 エンコードされた URL をデコードする必要があります。OSS SDK を使用するか、OSS API 操作を呼び出して補助メディアアセットをアップロードする場合にのみ、UploadAddress を解析する必要があります。

    eyJTZWN1cmuIjoiQ0FJU3p3TjF****
    ImageURL

    string

    イメージの URL。

    説明

    返された URL がブラウザからアクセスできず、HTTP 403 ステータスコードが返された場合、ApsaraVideo VOD の URL 署名機能が有効になっています。この問題を解決するには、URL 署名機能を無効にするか、署名付き URL を生成します。

    http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png
    ImageId

    string

    イメージファイルの ID。

    93ab850b4f6f46e91d24d81d4****
    UploadAuth

    string

    アップロード認証情報。

    説明

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

    eyJFbmmRCI6Im****

    例

    成功レスポンス

    JSONJSON

    {
  "FileURL": "http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png",
  "RequestId": "25818875-5F78-AEF6-D7393642****",
  "UploadAddress": "eyJTZWN1cmuIjoiQ0FJU3p3TjF****",
  "ImageURL": "http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png",
  "ImageId": "93ab850b4f6f46e91d24d81d4****",
  "UploadAuth": "eyJFbmmRCI6Im****"
}

    エラーコード

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

    変更履歴

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