CreateUploadAttachedMedia - - Alibaba Cloud ドキュメントセンター

アップロード認証情報を取得し、ウォーターマークや字幕などの補助メディアアセットを作成します。アップロード URL と認証情報は ApsaraVideo VOD によって提供され、権限付与とセキュリティの問題を解決し、悪意のあるアップロードを防ぎ、管理と処理のためにメディア ID (Mediaid) を自動的に作成します。

操作説明

この操作を呼び出す前に、ApsaraVideo VOD の課金方法と料金を理解していることを確認してください。メディアファイルを ApsaraVideo VOD にアップロードすると、ストレージ料金が課金されます。詳細については、「メディアアセットストレージの課金」をご参照ください。高速化サービスを有効にしている場合、メディアファイルを ApsaraVideo VOD にアップロードすると、高速化料金が課金されます。詳細については、「高速化トラフィックの課金」をご参照ください。
この操作は、メディアファイルのアップロード URL と認証情報を取得し、ApsaraVideo VOD でメディアアセットを作成するためにのみ呼び出すことができます。この操作を呼び出してメディアファイルをアップロードすることはできません。API 操作を呼び出してメディアファイルをアップロードする方法の詳細については、「API 操作を呼び出してメディアファイルをアップロードする」をご参照ください。
アップロード認証情報が 3,000 秒後に有効期限切れになった場合、CreateUploadAttachedMedia 操作を再度呼び出して、新しいアップロード URL とアップロード認証情報を取得できます。
コールバックを設定して AttachedMediaUploadComplete イベント通知を受信し、アップロードが成功したかどうかを判断できます。
メディアファイルを ApsaraVideo VOD にアップロードする前に、URL と認証情報を取得する必要があります。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 でエンコードする必要があります。	testTitle
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	任意	補助メディアアセットのソースファイル URL。説明ファイル名拡張子はオプションです。このパラメーターに指定したファイル名拡張子が MediaExt の値と異なる場合、MediaExt の値が有効になります。	D:\test.png
FileSize	string	任意	補助メディアアセットのサイズ。単位：バイト。	123
Tags	string	任意	補助メディアアセットの 1 つ以上のタグ。次の点にご注意ください：最大 16 個のタグを指定できます。複数のタグを指定する必要がある場合は、タグをコンマ (,) で区切ります。各タグの長さは最大 32 文字です。値は UTF-8 でエンコードする必要があります。	tag1,tag2
StorageLocation	string	任意	ストレージの場所。次の操作を実行してストレージの場所を取得します： ApsaraVideo VOD コンソールにログインします。左側のナビゲーションウィンドウで、[構成管理] > [メディア管理] > [ストレージ] を選択します。[ストレージ] ページで、ストレージの場所を表示します。説明このパラメーターを空のままにすると、補助メディアアセットはデフォルトのストレージの場所にアップロードされます。このパラメーターを指定すると、補助メディアアセットは指定されたストレージの場所にアップロードされます。	out-****.oss-cn-shanghai.aliyuncs.com
Description	string	任意	補助メディアアセットの説明。次の点にご注意ください：説明の長さは最大 1,024 バイトです。値は UTF-8 でエンコードする必要があります。	uploadTest
UserData	string	任意	カスタム構成。たとえば、コールバック構成やアップロード高速化構成を指定できます。値は JSON 文字列である必要があります。詳細については、「リクエストパラメーター」をご参照ください。説明コールバック構成は、ApsaraVideo VOD コンソールで HTTP コールバック URL を指定し、特定のコールバックイベントを選択した後にのみ有効になります。ApsaraVideo VOD コンソールで 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	補助メディアアセットファイルの URL。この URL は Object Storage Service (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 操作を使用してアップロード URL に基づいてメディアアセットをアップロードする前に、Base64 アルゴリズムを使用してアップロード URL をデコードする必要があります。アップロード URL を解析する必要があるのは、ネイティブ OSS SDK または OSS API を使用してアップロードする場合のみです。	LWNuLXNoYW5naGFpLmFsaXl1b****
MediaId	string	補助メディアアセットの ID。	97dc17a5abc3668489b84ce9****
MediaURL	string	補助メディアアセットの URL。 Alibaba Cloud CDN のドメイン名が指定されている場合は、CDN URL が返されます。それ以外の場合は、OSS URL が返されます。説明 ApsaraVideo VOD の URL 署名機能を有効にすると、ブラウザを使用して返された補助メディアアセットの URL にアクセスできず、HTTP ステータスコード 403 が返される場合があります。この問題を解決するには、URL 署名機能を無効にするか、署名付き URL を生成します。	http://example.aliyundoc.com/watermark/**.mov?auth_key=**
UploadAuth	string	アップロード認証情報。説明この操作によって返されるアップロード認証情報は Base64 でエンコードされています。SDK または API 操作を使用してアップロード認証情報に基づいてメディアアセットをアップロードする前に、Base64 アルゴリズムを使用してアップロード認証情報をデコードする必要があります。アップロード認証情報を解析する必要があるのは、ネイティブ OSS SDK または OSS API を使用してアップロードする場合のみです。	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****"
}

エラーコード

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

変更履歴

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