ApsaraVideo VOD にイメージをアップロードするためのアップロード URL およびアップロード認証情報を取得し、イメージ情報を作成します。ApsaraVideo VOD は、権限付与とセキュリティを確保し、悪意のあるアップロードを防ぐためにアップロード URL と認証情報を発行し、管理用のイメージ ID (ImageId) の自動作成をサポートしています。この操作を呼び出すことで、アップロード URL と認証情報を取得し、イメージ情報を作成できます。
操作説明
この操作を使用する前に、ApsaraVideo VOD の課金メソッドと料金を理解していることを確認してください。ApsaraVideo VOD へのメディアファイルのアップロードにはストレージ料金が発生します。詳細については、「メディアアセットストレージの課金」をご参照ください。ストレージおよび転送アクセラレーションを有効にしている場合、ApsaraVideo VOD へのメディアファイルのアップロードにはアップロードアクセラレーション料金も発生します。詳細については、「ストレージおよび転送アクセラレーションの課金」をご参照ください。
この操作は、アップロード URL と認証情報の取得、および基本的なメディアアセット情報の作成のみを行います。ファイルのアップロードは行いません。API 操作を呼び出してファイルをアップロードする完全な例については、「ApsaraVideo VOD API を使用したメディアファイルのアップロード」をご参照ください。
イメージのアップロードでは、アップロード URL および認証情報の更新はサポートされていません。イメージのアップロード認証情報が期限切れになった場合 (デフォルトの有効期間は 3000 秒)、この操作を再度呼び出して新しいアップロード URL と認証情報を取得してください。
コールバックを設定して、イメージのアップロード完了のイベント通知を受信し、アップロードが成功したかどうかを確認できます。
アップロード URL と認証情報の取得は ApsaraVideo VOD のコア操作であり、すべてのアップロードで必須です。ApsaraVideo VOD は複数のアップロードメソッドを提供しており、それぞれアップロード URL と認証情報の取得に関する要件が異なります。詳細については、「アップロード URL と認証情報」をご参照ください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
vod:CreateUploadImage |
create |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| Title |
string |
任意 |
イメージのタイトル。ルール:
|
マイタイトル |
| ImageType |
string |
必須 |
イメージのタイプ。有効な値:
説明
ApsaraVideo VOD コンソールでは、default タイプのイメージのみをビューおよび管理できます。 |
デフォルト |
| ImageExt |
string |
任意 |
アップロードするイメージソースファイルの拡張子。有効な値:
|
png。 |
| OriginalFileName |
string |
任意 |
アップロードするイメージソースファイルのアドレス。 説明
ファイル名の拡張子は任意です。ここにファイル名の拡張子が含まれており、 |
D:\picture_01 |
| Tags |
string |
任意 |
イメージのタグ。ルール:
|
Test。 |
| StorageLocation |
string |
任意 |
ストレージの場所。以下のメソッドでストレージの場所を取得できます: ApsaraVideo VOD コンソール にログインし、構成管理 > メディア管理 > ストレージ を選択してストレージの場所をビューします。 説明
このパラメーターを指定しない場合、イメージはデフォルトのストレージの場所にアップロードされます。このパラメーターを指定した場合、イメージは指定されたストレージの場所にアップロードされます。 |
outin-****..oss-cn-shanghai.aliyuncs.com。 |
| CateId |
integer |
任意 |
カテゴリ ID。以下のメソッドでカテゴリ ID を取得できます:
|
100036**** |
| UserData |
string |
任意 |
JSON 文字列形式のカスタム設定。この設定はメッセージコールバック、アップロードアクセラレーション、その他の構成をサポートしています。詳細については、「 UserData 」をご参照ください。 |
{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"xxx","test":"www"}} |
| Description |
string |
任意 |
イメージの説明。
|
イメージアップロードテスト。 |
| AppId |
string |
任意 |
アプリケーション ID。デフォルト値: app-1000000。マルチアプリケーションサービスを有効にしている場合は、アプリケーション ID を指定して、指定されたアプリケーションにイメージをアップロードします。詳細については、「マルチアプリケーション」をご参照ください。 |
app-1000000 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスパラメーター。 |
||
| FileURL |
string |
イメージファイルの OSS URL (認証なし)。 イメージウォーターマークテンプレートを追加する際、この URL を AddWatermark 操作の |
http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png。 |
| RequestId |
string |
リクエスト ID。 |
25818875-5F78-AEF6-D7393642**** |
| UploadAddress |
string |
アップロード URL。 説明
この操作によって返されるアップロード URL は Base64 エンコードされた値です。SDK または API を使用してメディアアセットをアップロードする際は、使用前に Base64 でデコードしてください。OSS ネイティブ SDK または OSS API を使用してアップロードする場合のみ、UploadAddress を解析する必要があります。 |
eyJTZWN1cmuIjoiQ0FJU3p3TjF**** |
| ImageURL |
string |
イメージのアクセス URL。 説明
返された ImageURL がブラウザでアクセスできない場合 (403 エラー)、VOD ドメイン名で URL 認証が有効になっています。URL 認証 を無効にするか、署名付き URL を生成 してください。 |
http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png。 |
| ImageId |
string |
イメージ ID。この ID は、 GetImageInfo 、 GetImageInfos 、 UpdateImageInfos 、 DeleteImage などの操作のリクエストパラメーターとして使用できます。 |
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****"
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。